REST Resource: providers.trips

Kaynak: Gezi

Seyahat meta verileri.

JSON gösterimi 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
Alanlar
name

string

Yalnızca çıkış. "providers/{provider}/trips/{trip}" biçiminde
vehicleId

string

Bu yolculuğa çıkan aracın kimliği
tripStatus

enum (TripStatus)

Gezinin şu anki durumu.
tripType

enum (TripType)

Gezinin türü.
pickupPoint

object (TerminalLocation)

Müşterinin alınacağını belirttiği konum.
actualPickupPoint

object (StopLocation)

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

object (StopLocation)

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

object (TerminalLocation)

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

string (Timestamp format)

intermediateDestinations öğesinin en son değiştirildiği zamanı belirtir. Sunucunuz, intermediateDestinations öğesinin değiştirilmemesi için intermediateDestinationIndex güncellemesinde bu değeri önbelleğe almalı ve UpdateTripRequest içinde aktarmalıdır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
intermediateDestinationIndex

integer

TripStatus, ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda, [0..N-1] arasında, aracın ileride hangi ara hedefi geçeceğini belirten bir sayı. TripStatus, ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda aracın hangi ara hedefte olduğunu gösteren [0..N-1] arasında bir sayı. Bu değeri sağlayıcı ayarlar. intermediateDestinations yoksa bu alan yoksayılır.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

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[]

object (StopLocation)

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

object (TerminalLocation)

Müşterinin bırakılacağını belirttiği konum.
actualDropoffPoint

object (StopLocation)

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
remainingWaypoints[]

object (TripWaypoint)

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[]

object (TripWaypoint)

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 trips.get aramaları DEĞİL, yalnızca trips.update ve trips.create aramalarında sunucu tarafından doldurulur.
route[]

object (LatLng)

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

string

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Yalnızca çıkış. Mevcut olduğunda currentRouteSegment boyunca trafik koşullarını gösterir.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Yalnızca çıkış. currentRouteSegmentTraffic öğesinin en son değiştirildiği zamanı belirtir.

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

Yalnızca çıkış. currentRouteSegment noktasının bittiği ara nokta.
remainingDistanceMeters

integer

Yalnızca çıkış. currentRouteSegment alanında kalan sürüş mesafesi. Yolculuk bir araca atanmadıysa veya gezi tamamlanırsa ya da iptal edilirse değer belirtilemez.
etaToFirstWaypoint

string (Timestamp format)

Yalnızca çıkış. Bir sonraki referans noktasına varış süresi (remainingWaypoints alanındaki ilk giriş). Yolculuk bir araca atanmadıysa veya yolculuk aktif değilse (tamamlandı ya da iptal edildiyse) değer belirtilmez.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
remainingTimeToFirstWaypoint

string (Duration format)

Yalnızca çıkış. Seyahat verilerinin döndürülmesinden Trip.eta_to_first_waypoint ayına kadar geçen süre. Yolculuk bir araca atanmadıysa veya yolculuk aktif değilse (tamamlandı ya da iptal edildiyse) değer belirtilmez.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints öğesinin en son ne zaman değiştirildiğini (bir referans noktasının eklendiği, kaldırıldığı veya değiştirildiği) belirtir.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints.path_to_waypoint ve remainingWaypoints.traffic_to_waypoint öğelerinin en son değiştirildiği zamanı belirtir. remainingWaypoints için yolların ve trafiğin yalnızca güncellenirse döndürüldüğünden emin olmak için istemci uygulamanız bu değeri önbelleğe alıp GetTripRequest içinde iletmelidir.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
numberOfPassengers

integer

Sabit. Bu yolculuktaki yolcu sayısını belirtir, sürücü dahil değildir. Bir araç, vehicles.search yanıtında iade edilebilen kullanılabilir kapasiteye sahip olmalıdır.
lastLocation

object (VehicleLocation)

Yalnızca çıkış. Aracın rota boyunca bildirilen son konumunu belirtir.
lastLocationSnappable

boolean

Yalnızca çıkış. Aracın lastLocation öğesinin currentRouteSegment'e tutturulup tutturulamayacağını belirtir. lastLocation veya currentRouteSegment yoksa yanlış değerini alır. Fleet Engine tarafından hesaplanır. İstemcilerden gelen güncellemeler yoksayılır.
view

enum (TripView)

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 (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Alanlar
point

object (LatLng)

Zorunlu. Gerçek konumu belirtir.
timestamp

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
stopTime
(deprecated)

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

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

create

 Fleet Engine'de bir gezi oluşturur ve yeni geziyi döndürür.

get

 Tek bir geziyle ilgili bilgi alma.
Belirli bir araç için tüm yolculukları görün.

update

 Seyahat verilerini günceller.