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)

Değişmez. Gezinin yapılandırması.
androidAppId

string

Yalnızca giriş. Değişmez. Seyahatin kullanılacağı mobil uygulamanın Android uygulama kimliği. androidAppId veya iosAppId öğelerinden en az biri ayarlanmalıdır.
iosAppId

string

Yalnızca giriş. Değişmez. Seyahati kullanacak mobil uygulamanın iOS paket kimliği. androidAppId veya iosAppId öğelerinden en az biri 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 jeton. Yalnızca trips.create tarafından döndürülür.
state

enum (State)

Yalnızca çıkış. Seyahatin 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
}
Alanlar
enableHighFrequencyUpdates

boolean

İsteğe bağlı. Sık seyahat güncellemelerinin etkinleştirilip etkinleştirilmeyeceği.

NOT: Bu özelliğin etkinleştirilmesi, gezinin Enterprise katmanı kullanımı altında kaydedilmesine ve Enterprise katmanı ücretlerine tabi olmasına neden olur.
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 Gezi alanları pubsub bildirimlerine dahil edilir (varsayılan davranış).

Aşağıdaki alanlar desteklenmez:

  • androidAppId
  • iosAppId
  • authToken
  • config

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

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

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 Seyahat oluşturuldu ancak henüz başlamadı.
ENROUTE Taşıyıcı, hedefe doğru yolda.
ARRIVED Nakliyeci hedefe 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.

TripExecution

Seyahatin gerçekleştirilmesiyle ilgili veriler.

JSON gösterimi 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "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 yola sabitlenmiş konum olur.
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 gezide 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

Bir enlem/boylam çiftini temsil eden nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çift sayı olarak 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 (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-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.

Yöntemler

create

 Gezi oluşturur.

get

 Seyahate çıkın.