REST Resource: projects.trips

Kaynak: Seyahat

Seyahat

JSON gösterimi 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Gezinin kaynak adı. Biçim: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Sabit. Geziyle ilgili yapılandırma.
androidAppId

string

Yalnızca giriş. Değiştirilemez. Gezinin kullanılacağı mobil uygulamanın Android uygulama kimliği. En az bir androidAppId veya iosAppId ayarlanmalıdır.
iosAppId

string

Yalnızca giriş. Değiştirilemez. Seyahati kullanacak mobil uygulamanın iOS paket kimliği. En az bir androidAppId veya iosAppId ayarlanmalıdır.
authToken

object (AuthToken)

Yalnızca çıkış. Google Haritalar veya Waze'de NavConnect gezisi başlatmak için erişimi yetkilendiren ve bu uygulamalara geziyi güncelleme erişimi veren opak bir jeton. Yalnızca trips.create tarafından döndürülür.
state

enum (State)

Yalnızca çıkış. Gezinin durumu.
execution

object (TripExecution)

Yalnızca çıkış. Gezinin yürütülmesiyle ilgili en son veriler. Bu, gezi hata durumundaysa ayarlanmayabilir.
createTime

string (Timestamp format)

Yalnızca çıkış. Gezinin oluşturulduğu sırada sunucunun saatine göre belirlenen zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Yalnızca çıkış. Sunucunun en son gezi güncellemesini aldığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

TripConfig

Gezinin yapılandırması.

JSON gösterimi 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
Alanlar
enableHighFrequencyUpdates

boolean

İsteğe bağlı. Sık seyahat güncellemelerini etkinleştirme seçeneği.

NOT: Bu özelliğin etkinleştirilmesi, seyahati Enterprise katmanı kullanımı altında kaydeder ve Enterprise katmanı ücretlerine tabidir.
enablePubsub

boolean

İsteğe bağlı. Seyahat için pubsub bildirimlerinin etkinleştirilip etkinleştirilmeyeceği.
pubsubFieldMask

string (FieldMask format)

İsteğe bağlı. Ayarlanırsa pubsub bildirimlerine yalnızca Seyahat alanlarının belirtilen alt kümesi dahil edilir.

Ayarlanmazsa tüm Seyahat alanları pubsub bildirimlerine dahil edilir (varsayılan davranış).

Aşağıdaki alanlar desteklenmez:

  • androidAppId
  • iosAppId
  • authToken
  • config

NOT: enablePubsub yanlışsa bu alan yoksayılır.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "user.displayName,photo".
enableRemainingRouteReporting

boolean

İsteğe bağlı. Gezide kalan rota raporlamasının etkinleştirilip etkinleştirilmeyeceği.

NOT: Bu özelliğin etkinleştirilmesi, seyahati Enterprise katmanı kullanımı altında kaydeder ve Enterprise katmanı ücretlerine tabidir.

AuthToken

Kimlik doğrulama jetonu.

JSON gösterimi 
{
  "token": string,
  "expireTime": string
}
Alanlar
token

string

Yalnızca çıkış. Mobil uygulamaya aktarılması gereken kimlik doğrulama jetonu.
expireTime

string (Timestamp format)

Yalnızca çıkış. Kimlik doğrulama jetonunun geçerlilik süresinin dolacağı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

Eyalet

Olası tüm gezi durumları.

Sıralamalar
STATE_UNSPECIFIED Seyahat durumu belirtilmemiş.
NEW Gezi oluşturuldu ancak henüz başlamadı.
ENROUTE Taşıyıcı, hedefe doğru yolda.
ARRIVED Nakliyeci, varış noktasına ulaştığında
SUSPENDED Gezi askıya alındı.
FAILED Seyahat başarıyla tamamlanamadı.
CLIENT_ERROR Seyahat, istemci hatası nedeniyle başarısız oldu.
CANCELED Seyahat, geliştirici tarafından açıkça iptal edildi.

TripExecution

Seyahatin gerçekleştirilmesiyle ilgili veriler.

JSON gösterimi 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Alanlar
origin

object (Location)

Yalnızca çıkış. Genellikle NavConnect yolculuğunun başlangıcında taşıyıcının bulunduğu konum olan yolculuğun başlangıç noktası.
destination

object (Stop)

Yalnızca çıkış. Mobil uygulama tarafından bildirilen gezi varış noktası.
location

object (Location)

Yalnızca çıkış. Taşıyıcının bilinen son konumunu gösteren konum sinyali. Bu, varsa yol üzerinde sabitlenmiş konum olur.
remainingRoute

object (Route)

Yalnızca çıkış. Rotanın kalan kısmı için çoklu çizgi sağlar.
traveledDuration

string (Duration format)

Yalnızca çıkış. Şu ana kadar seyahat edilen süre.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
remainingDuration

string (Duration format)

Yalnızca çıkış. Google'ın tahminiyle bu yolculukta kalan süre.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
traveledDistanceMeters

integer

Yalnızca çıkış. Başlangıç noktasından kat edilen mesafe (metre).
remainingDistanceMeters

integer

Yalnızca çıkış. Varış noktasına kalan mesafe (metre cinsinden).
stopAddedInRoute

boolean

Yalnızca çıkış. Rota boyunca durak eklenip eklenmediğini gösterir.

Konum

Mobil uygulama tarafından bildirilen konum.

JSON gösterimi 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Alanlar
point

object (LatLng)

Yalnızca çıkış. Konumun enlem/boylamı.
sourceTime

string (Timestamp format)

Yalnızca çıkış. Konumun, istemci tarafından belirtildiği şekilde kaynaklandığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

Yalnızca çıkış. Sunucunun bu konum güncellemesini aldığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çiftler halinde ifade edilir. Aksi belirtilmediği sürece bu nesne, WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem değeri derece cinsinden olmalıdır. [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

Durdur

Gezide bir görevin gerçekleştirileceği durak.

JSON gösterimi 
{
  "point": {
    object (LatLng)
  }
}
Alanlar
point

object (LatLng)

Zorunlu. Durağın enlem/boylam olarak konumu.

Rota

Rota çoklu çizgisi.

JSON gösterimi 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
Alanlar
trafficInformation[]

object (SpeedReadingInterval)

Yalnızca çıkış. Hız okuma aralıkları olarak açıklanan çoklu çizgi üzerindeki trafik bilgileri.

NOTLAR:

  • Aralıklar çakışmaz.
  • Aralıklar bitişik olmalıdır.
  • Aralıklar, çoklu çizginin tamamını kapsar.
  • Aralıklar, artan dizine göre sıralanır.
  • Hız, her aralık için belirtilir.

format birleşik alanı. Rota biçimi.

Doldurulan biçim, route_polyline_format parametresi tarafından kontrol edilir. Ayarlanmazsa varsayılan olarak basit bir çoklu çizgi kullanılır. format aşağıdakilerden yalnızca biri olabilir:
simplePolyline

object (SimplePolyline)

Yalnızca çıkış. Rotayı enlem/boylam değerlerinin basit bir listesi olarak gösterir.
encodedPolyline

string

Yalnızca çıkış. Rota, kodlanmış çoklu çizgi olarak. https://developers.google.com/maps/documentation/utilities/polylinealgorithm adresini ziyaret edin.
s2Polyline

string (bytes format)

Yalnızca çıkış. Kodlanmış bir S2Polyline olarak rota. https://s2geometry.io/devguide/basic_types.html adresine göz atın.

Base64 kodlu bir dize.
geoJson

object (Struct format)

Yalnızca çıkış. Rotayı GeoJSON LineString olarak. https://tools.ietf.org/html/rfc7946#section-3.1.4 adresine göz atın.

SimplePolyline

Noktalardan oluşan basit bir liste kullanarak çoklu çizgiyi temsil eder.

JSON gösterimi 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
Alanlar
points[]

object (LatLng)

Yalnızca çıkış. Çoklu çizgiyi temsil eden noktaların sıralı listesi.

SpeedReadingInterval

Bir yolun bitişik segmentindeki trafik yoğunluğu göstergesi. P_0, P_1, ... , P_N noktalarını içeren bir yol (sıfır tabanlı dizin) verildiğinde SpeedReadingInterval bir aralığı tanımlar ve Speed kategorilerini kullanarak trafiğini açıklar.

JSON gösterimi 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
Alanlar
speed

enum (Speed)

Yalnızca çıkış. Bu aralıktaki trafik hızı.
startPolylinePointIndex

integer

Yalnızca çıkış. Bu aralığın yoldaki başlangıç dizini.
endPolylinePointIndex

integer

Yalnızca çıkış. Yoldaki bu aralığın bitiş dizini.

Hız

Çoklu çizgi hızının trafik verilerine göre sınıflandırılması.

Sıralamalar
SPEED_UNSPECIFIED Hız belirtilmemiş.
NORMAL Normal hız, trafikte gecikme yok.
SLOW Yavaşlama algılandı, hafif ila orta düzeyde trafik.
TRAFFIC_JAM Trafik durması da dahil olmak üzere trafikteki gecikmeler.

Yöntemler

create

 Seyahat oluşturur.

get

 Seyahate çıkın.