Kaynak: Gezi
Seyahat meta verileri.
JSON gösterimi |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. "providers/{provider}/trips/{trip}" biçiminde |
vehicleId |
Bu yolculuğa çıkan aracın kimliği |
tripStatus |
Gezinin şu anki durumu. |
tripType |
Gezinin türü. |
pickupPoint |
Müşterinin alınacağını belirttiği konum. |
actualPickupPoint |
Yalnızca giriş. Müşterinin alındığı gerçek konum ve yeri. Bu alan, sağlayıcının gerçek teslim alma bilgileriyle ilgili geri bildirim vermesi için kullanılır. |
actualPickupArrivalPoint |
Yalnızca giriş. Sürücünün teslim alma noktasına gelişinin gerçek zamanı ve konumu. Bu alan, sağlayıcının, teslim alma noktasına gerçek varış bilgileri hakkında geri bildirim vermesi için kullanılır. |
pickupTime |
Yalnızca çıkış. Sürücülerin alınacak tahmini gelecekteki zaman veya fiilen alındıkları saat. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
intermediateDestinations[] |
Gezinin talep etmesi için ara duraklamalar (teslim alma ve bırakmaya ek olarak). Başlangıçta bu özellik, paylaşılan seyahatler için desteklenmeyecektir. |
intermediateDestinationsVersion |
Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
intermediateDestinationIndex |
|
actualIntermediateDestinationArrivalPoints[] |
Yalnızca giriş. Sürücünün ara hedefe varış noktasının gerçek zamanı ve konumu. Bu alan, sağlayıcının ara hedeflere gerçek varış bilgileri hakkında geri bildirim vermesi için kullanılır. |
actualIntermediateDestinations[] |
Yalnızca giriş. Müşterinin ara bir hedeften alındığı gerçek zaman ve yer. Bu alan, sağlayıcının ara hedeflerdeki gerçek teslim alma bilgileri hakkında geri bildirim vermesi için kullanılır. |
dropoffPoint |
Müşterinin bırakılacağını belirttiği konum. |
actualDropoffPoint |
Yalnızca giriş. Müşterinin bıraktığı gerçek zaman ve yer. Bu alan, sağlayıcının gerçek ayrılma bilgileriyle ilgili geri bildirim sağlaması için kullanılır. |
dropoffTime |
Yalnızca çıkış. Sürücülerin nihai varış noktasında Android'den ayrılacağı gelecekteki tahmini zaman veya indirildikleri fiili zaman. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
remainingWaypoints[] |
Yalnızca çıkış. Mevcut konumdan teslim noktasına kadar olan tam yol (dahil). Bu rota, diğer yolculukların ara noktalarını içerebilir. |
vehicleWaypoints[] |
Bu alan, gezi için ara noktaların manuel olarak sıralanmasını destekler. Rapor, atanan araç için kalan tüm ara noktaların yanı sıra bu yolculuk için yolcu alma ve bırakma ara noktalarını da içerir. Yolculuk bir araca atanmamışsa Fleet Engine bu alanı yoksayar. Gizlilik nedeniyle bu alan |
route[] |
Yalnızca çıkış. Bu gezi için kalanWaypoints'teki ilk giriş için beklenen rota. İlk ara noktanın farklı bir geziye ait olabileceğini unutmayın. |
currentRouteSegment |
Yalnızca çıkış. Bir sonraki referans noktasına giden kodlanmış yol. Not: Bu alan yalnızca Driver 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 Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
currentRouteSegmentTraffic |
Yalnızca çıkış. Mevcut olduğunda Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. |
currentRouteSegmentTrafficVersion |
Yalnızca çıkış. Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
currentRouteSegmentEndPoint |
Yalnızca çıkış. |
remainingDistanceMeters |
Yalnızca çıkış. |
etaToFirstWaypoint |
Yalnızca çıkış. Bir sonraki referans noktasına varış süresi ( Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
remainingTimeToFirstWaypoint |
Yalnızca çıkış. Seyahat verilerinin döndürülmesinden En fazla dokuz kesir basamağı içeren ve " |
remainingWaypointsVersion |
Yalnızca çıkış. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
remainingWaypointsRouteVersion |
Yalnızca çıkış. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
numberOfPassengers |
Sabit. Bu yolculuktaki yolcu sayısını belirtir, sürücü dahil değildir. Bir araç, |
lastLocation |
Yalnızca çıkış. Aracın rota boyunca bildirilen son konumunu belirtir. |
lastLocationSnappable |
Yalnızca çıkış. Aracın |
view |
Doldurulan Seyahat alanlarının alt kümesi ve nasıl yorumlanması gerektiği. |
TripStatus
İlerleme durumunu 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 alma noktasına gidiyor. |
ARRIVED_AT_PICKUP |
Sürücü teslim noktasına vardı. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Sürücü, ara bir hedefe varmış ve sürücüyü bekliyor. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Sürücü, ara bir hedefe (teslimat noktasına değil) doğru yola çıktı. |
ENROUTE_TO_DROPOFF |
Sürücü, sürücüyü alıp bir sonraki hedefe doğru gidiyor. |
COMPLETE |
Sürücü düştüğünde yolculuk tamamlandı. |
CANCELED |
Yolculuk; sürücü, yolcu veya araç paylaşma sağlayıcısı tarafından teslim alınmadan önce iptal edilmiştir. |
StopLocation
Durmanın (teslim alma/bırakma) gerçekleştiği asıl konum.
JSON gösterimi |
---|
{
"point": {
object ( |
Alanlar | |
---|---|
point |
Zorunlu. Gerçek konumu belirtir. |
timestamp |
Durmanın ne zaman gerçekleştiğini gösterir. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
stopTime |
Yalnızca giriş. Kullanımdan kaldırıldı. Zaman damgası alanını kullanın. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
TripView
trips.get
yanıtında farklı Gezi alanı grupları için seçici. Bağlam için AIP-157'ye bakın. Büyük olasılıkla daha fazla görünüm eklenebilir.
Sıralamalar | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Varsayılan değer. Geriye dönük uyumluluk için API'de varsayılan olarak SDK görünümü kullanılır. Kararlılık ve destek sağlamak için müşterilere SDK dışında bir TripView seçmeleri önerilir. |
SDK |
Herkese açık kitaplıklar kullanıldığında yorumlanamayan veya desteklenemeyecek alanları içerir. |
JOURNEY_SHARING_V1S |
Yolculuk alanları, Yolculuk Paylaşımı kullanım alanı için doldurulur. Bu görünüm, sunucular arası iletişimler için tasarlanmıştır. |
Yöntemler |
|
---|---|
|
Fleet Engine'de bir gezi oluşturur ve yeni geziyi döndürür. |
|
Tek bir geziyle ilgili bilgi alma. |
|
Belirli bir araç için tüm yolculukları görün. |
|
Seyahat verilerini günceller. |