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 seyahati 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ış. Yolcuların alınacağı tahmini gelecekteki saat veya alındıkları gerçek saat.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (TerminalLocation)

Yolculuk isteklerinde (alış ve bırakma noktalarına 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. Sunucunuz, intermediateDestinations değerinin değiştirilmediğinden emin olmak için bu değeri önbelleğe almalı ve intermediateDestinationIndex güncellendiğinde UpdateTripRequest değerine iletmelidir.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Ö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ı belirler. intermediateDestinations yoksa bu alan yok sayı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 hedeflerdeki 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 bırakılacağını belirttiği konum.

object (StopLocation)

Yalnızca giriş. Müşterinin ayrıldığı gerçek saat 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ış. Yolcuların nihai varış noktasına bırakılacağı tahmini gelecekteki zaman veya bırakıldıkları gerçek zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 gezilerdeki yol noktalarını içerebilir.

object (TripWaypoint)

Bu alan, seyahat için yol noktalarını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 yalnızca trips.get çağrılarında DEĞİL, 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 yol noktasına 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.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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ış. Sonraki yol noktasına tahmini varış zamanı (remainingWaypoints alanındaki ilk giriş). Gezi bir araca atanmamışsa veya etkin değilse (tamamlanmış veya iptal edilmişse) değer belirtilmez.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Ö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. Gezi bir araca atanmamışsa veya etkin değilse (tamamlanmış veya iptal edilmişse) değer belirtilmez.

"s" ile biten, en fazla dokuz kesir basamağı içeren, saniye cinsinden süre. Örnek: "3.5s".

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints değerinin en son ne zaman değiştirildiğini (bir yol noktası eklenmiş, kaldırılmış veya değiştirilmiş) belirtir.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 değiştirildiği zamanı belirtir. Müşteri uygulamanız, remainingWaypoints için yolların ve trafiğin yalnızca güncellendiğinde döndürülmesini sağlamak amacıyla bu değeri önbelleğe alıp GetTripRequest içinde iletmelidir.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

Değişmez. 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ış. Aracın rota üzerindeki son bildirilen konumunu gösterir.

boolean

Yalnızca çıkış. Aracın lastLocation özelliğinin currentRouteSegment'e tutturulup tutturulamayacağını belirtir. lastLocation veya currentRouteSegment mevcut değilse yanlış değerini döndürür. Fleet Engine tarafından hesaplanı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" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Ö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" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".