REST Resource: providers.trips

{
  "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)
}

string

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

string

Bu geziyi yapan aracın kimliği.

enum (TripStatus)

Yolculuğun mevcut durumu.

enum (TripType)

Gezinin türü.

object (TerminalLocation)

Müşterinin teslim alacağını belirttiği konum.

object (StopLocation)

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.

object (StopLocation)

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.

string (Timestamp format)

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

object (TerminalLocation)

Gezinin istekte bulunması için (teslim alma ve bırakmaya ek olarak) ara duraklar. Başlangıçta bu, paylaşılan geziler için desteklenmeyecektir.

string (Timestamp format)

intermediateDestinations öğesinin en son ne zaman değiştirildiğini gösterir. Sunucunuzun, intermediateDestinations öğesinin değişmediğinden emin olmak için intermediateDestinationIndex güncellemesi sırasında bu değeri önbelleğe alması ve UpdateTripRequest içinde iletmesi gerekir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

TripStatus değeri ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda [0..N-1] arasında bir sayı olup aracın geçeceği ara hedefi belirtir. TripStatus değeri ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda [0..N-1] arasında bir sayı olup aracın hangi ara hedefte olduğunu belirtir. Bu değeri sağlayıcı ayarlar. intermediateDestinations yoksa bu alan yoksayılır.

object (StopLocation)

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.

object (StopLocation)

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.

object (TerminalLocation)

Müşterinin arabadan ayrılacağını belirttiği konum.

object (StopLocation)

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.

string (Timestamp format)

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

object (TripWaypoint)

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.

object (TripWaypoint)

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 trips.get çağrılarında DEĞİL, yalnızca trips.update ve trips.create çağrılarında sunucu tarafından doldurulur.

object (LatLng)

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.

string

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.

string (Timestamp format)

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

object (ConsumableTrafficPolyline)

Yalnızca çıkış. currentRouteSegment boyunca mevcut olan trafik koşullarını 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.

string (Timestamp format)

Yalnızca çıkış. currentRouteSegmentTraffic öğesinin 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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Yalnızca çıkış. currentRouteSegment öğesinin sona erdiği ara nokta.

integer

Yalnızca çıkış. currentRouteSegment alanında kalan sürüş mesafesi. Yolculuk bir araca atanmamışsa veya gezi tamamlanmış ya da iptal edilmişse değer belirtilmez.

string (Timestamp format)

Yalnızca çıkış. Bir sonraki ara noktanın TVS'si (remainingWaypoints alanındaki ilk giriş). Yolculuk bir araca atanmamışsa veya gezi etkin değilse (tamamlanmış ya da iptal edilmiş) değer belirtilmez.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Yalnızca çıkış. Yolculuk verilerinin döndürüldüğü andan itibaren Trip.eta_to_first_waypoint içindeki zamana kadar geçen süre. Yolculuk bir araca atanmamışsa veya gezi etkin değilse (tamamlanmış ya da iptal edilmiş) değer belirtilmez.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints en son ne zaman değiştirildiğini (ara nokta eklendiği, kaldırıldığı veya değiştirildiği zaman) gösterir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints.path_to_waypoint ve remainingWaypoints.traffic_to_waypoint öğelerinin en son ne zaman değiştirildiğini gösterir. İstemci uygulamanız, remainingWaypoints yollarının ve trafiğinin yalnızca güncellendiğinden emin olmak için bu değeri önbelleğe alıp GetTripRequest içinde iletmesi gerekir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

Sabit. Bu seyahatteki yolcu sayısını belirtir ve sürücüyü içermez. Bir aracın, vehicles.search yanıtında iade edilebilmek için uygun kapasitesi olmalıdır.

object (VehicleLocation)

Yalnızca çıkış. Rota boyunca aracın bildirilen son konumunu belirtir.

boolean

Yalnızca çıkış. Aracın lastLocation özelliğinin currentRouteSegment'e tutturulup bağlanamayacağını belirtir. lastLocation veya currentRouteSegment yoksa yanlış değerini döndürür. Fleet Engine tarafından hesaplanmıştır. İstemcilerden gelen güncellemeler yoksayılır.

enum (TripView)

Doldurulan Gezi alanlarının alt kümesi ve bunların nasıl yorumlanması gerektiği.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Zorunlu. Asıl konumu gösterir.

string (Timestamp format)

Durmanın ne zaman gerçekleştiğini gösterir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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