Kaynak: Seyahat
Gezi meta verileri.
JSON gösterimi |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. "providers/{provider}/trips/{trip}" biçiminde |
vehicleId |
Bu seyahate çıkan aracın kimliği. |
tripStatus |
Yolculuğun mevcut durumu. |
tripType |
Gezinin türü. |
pickupPoint |
Müşterinin teslim alacağını belirttiği konum. |
actualPickupPoint |
Yalnızca giriş. Müşterinin teslim alındığı gerçek konum ve konum. Bu alan, sağlayıcının gerçek teslim alma bilgileri hakkında geri bildirim sağlaması içindir. |
actualPickupArrivalPoint |
Yalnızca giriş. Sürücünün teslim alma noktasına vardığı gerçek saat ve konum. Bu alan, sağlayıcının teslim alma noktasına gerçek varış bilgileri hakkında geri bildirim sağlaması içindir. |
pickupTime |
Yalnızca çıkış. Sürücülerin teslim alınacağı tahmini saat veya yolcuları teslim alma zamanı. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
intermediateDestinations[] |
Gezinin istekte bulunması için (teslim alma ve bırakmaya ek olarak) ara duraklar. Başlangıçta bu, paylaşılan geziler için desteklenmeyecektir. |
intermediateDestinationsVersion |
RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
intermediateDestinationIndex |
|
actualIntermediateDestinationArrivalPoints[] |
Yalnızca giriş. Sürücünün ara hedefe varış saati ve konumu. Bu alan, sağlayıcının ara hedeflere yönelik gerçek varış bilgileri hakkında geri bildirim sağlaması içindir. |
actualIntermediateDestinations[] |
Yalnızca giriş. Müşterinin ara hedeften teslim alındığı gerçek zaman ve konum. Bu alan, sağlayıcının ara hedeflerdeki gerçek teslim alma bilgileri hakkında geri bildirim sağlaması içindir. |
dropoffPoint |
Müşterinin arabadan ayrılacağını belirttiği konum. |
actualDropoffPoint |
Yalnızca giriş. Müşterinin ayrıldığı gerçek zaman ve konum. Bu alan, sağlayıcının gerçek ayrılma bilgileriyle ilgili geri bildirim sağlaması içindir. |
dropoffTime |
Yalnızca çıkış. Sürücülerin nihai varış noktasında bırakılacağı gelecekteki tahmini saat veya yolcuların araçtan indirildiği fiili saat. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
remainingWaypoints[] |
Yalnızca çıkış. Geçerli konumdan ayrılma noktasına kadar (dahil olmak üzere) tam yol. Bu yol, diğer seyahatlerden ara noktaları içerebilir. |
vehicleWaypoints[] |
Bu alan, gezi için ara noktaların manuel olarak sıralanmasını destekler. Atanan araç için kalan tüm ara noktaların yanı sıra bu yolculuk için alma ve bırakma ara noktalarını içerir. Yolculuk bir araca atanmamışsa Fleet Engine bu alanı yok sayar. Gizlilik nedeniyle, bu alan |
route[] |
Yalnızca çıkış. Bu gezi için kalanWaypoints alanındaki ilk girişe giden tahmini rota. İlk ara noktanın farklı bir seyahate ait olabileceğini unutmayın. |
currentRouteSegment |
Yalnızca çıkış. Sonraki ara noktaya giden kodlanmış bir yol. Not: Bu alan yalnızca Sürücü SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Kod çözme henüz desteklenmiyor. |
currentRouteSegmentVersion |
Yalnızca çıkış. Rotanın en son ne zaman değiştirildiğini gösterir. Not: Bu alan yalnızca Sürücü SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
currentRouteSegmentTraffic |
Yalnızca çıkış. Not: Bu alan yalnızca Sürücü SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. |
currentRouteSegmentTrafficVersion |
Yalnızca çıkış. Not: Bu alan yalnızca Sürücü SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
currentRouteSegmentEndPoint |
Yalnızca çıkış. |
remainingDistanceMeters |
Yalnızca çıkış. |
etaToFirstWaypoint |
Yalnızca çıkış. Bir sonraki ara noktanın TVS'si ( RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
remainingTimeToFirstWaypoint |
Yalnızca çıkış. Yolculuk verilerinin döndürüldüğü andan itibaren En fazla dokuz kesir basamağı olan ve " |
remainingWaypointsVersion |
Yalnızca çıkış. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
remainingWaypointsRouteVersion |
Yalnızca çıkış. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
numberOfPassengers |
Sabit. Bu seyahatteki yolcu sayısını belirtir ve sürücüyü içermez. Bir aracın, |
lastLocation |
Yalnızca çıkış. Rota boyunca aracın bildirilen son konumunu belirtir. |
lastLocationSnappable |
Yalnızca çıkış. Aracın |
view |
Doldurulan Gezi alanlarının alt kümesi ve bunların nasıl yorumlanması gerektiği. |
TripStatus
İlerlemeyi gösteren gezi durumu.
Sıralamalar | |
---|---|
UNKNOWN_TRIP_STATUS |
Varsayılan, belirtilmemiş veya tanınmayan gezi durumu için kullanılır. |
NEW |
Yeni oluşturulan gezi. |
ENROUTE_TO_PICKUP |
Sürücü, teslim noktasına doğru yolda. |
ARRIVED_AT_PICKUP |
Sürücü, alma noktasına geldi. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Sürücü, ara varış noktasına varmış ve sürücüyü bekliyor. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Sürücü, indirme noktasına değil, ara hedefe doğru ilerliyor. |
ENROUTE_TO_DROPOFF |
Sürücü, yolcuyu aldı ve bir sonraki varış noktasına doğru gidiyor. |
COMPLETE |
Sürücü bırakıldı ve seyahat tamamlandı. |
CANCELED |
Yolculuk; sürücü, yolcu veya araç paylaşımı sağlayıcısı tarafından teslim alınmadan önce iptal edildi. |
StopLocation
Durmanın (teslim alma/bırakma) gerçekleştiği gerçek konum.
JSON gösterimi |
---|
{
"point": {
object ( |
Alanlar | |
---|---|
point |
Zorunlu. Asıl konumu gösterir. |
timestamp |
Durmanın ne zaman gerçekleştiğini gösterir. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
stopTime |
Yalnızca giriş. Kullanımdan kaldırıldı. Zaman damgası alanını kullanın. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
TripView
trips.get
yanıtındaki farklı Seyahat alanı grupları için seçici. İlgili bağlam için bkz. AIP-157. Daha fazla görünüm eklenme ihtimali vardır.
Sıralamalar | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Varsayılan değerdir. Geriye dönük uyumluluk için bu API varsayılan olarak SDK görünümünü kullanır. Kararlılık ve destek sağlamak için müşterilerin SDK dışında bir TripView seçmeleri önerilir. |
SDK |
Herkese açık kitaplıklar kullanılarak yorumlanamayan veya desteklanamayan alanları içerir. |
JOURNEY_SHARING_V1S |
Gezi alanları, yolculuk paylaşımı kullanım alanı için doldurulur. Bu görünüm, sunucudan sunucuya iletişim için tasarlanmıştır. |
Yöntemler |
|
---|---|
|
Fleet Engine'de bir gezi oluşturur ve yeni geziyi döndürür. |
|
Tek bir seyahat hakkında bilgi edinebilirsiniz. |
|
Belirli bir araç için tüm seyahatleri alma. |
|
Yolculuk verilerini günceller. |