REST Resource: providers.trips

Kaynak: Seyahat

Yolculuk 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 seyahati yapan aracın kimliği.
tripStatus

enum (TripStatus)

Yolculuğun mevcut durumu.
tripType

enum (TripType)

Gezinin türü.
pickupPoint

object (TerminalLocation)

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

object (StopLocation)

Yalnızca giriş. Müşterinin alındığı gerçek konum ve zaman. Bu alan, sağlayıcının gerçek teslim alma bilgileri hakkında geri bildirim sağlaması içindir.
actualPickupArrivalPoint

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ındaki gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.
pickupTime

string (Timestamp format)

Yalnızca çıkış. Yolcuların alınacağı tahmini gelecekteki saat veya alındıkları gerçek saat.

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

object (TerminalLocation)

Gezinin istekte bulunması için (teslim alma ve bırakmaya ek olarak) ara duraklar. Bu özellik başlangıçta paylaşılan geziler için desteklenmeyecektir.
intermediateDestinationsVersion

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.

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".
intermediateDestinationIndex

integer

TripStatus ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda, aracın bir sonraki geçiş yapacağı ara hedefi belirten [0..N-1] aralığında bir sayı. TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda, aracın hangi ara hedefte olduğunu belirten [0..N-1] aralığında bir sayı. Bu değeri sağlayıcı ayarlar. intermediateDestinations yoksa bu alan yok sayılır.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

Yalnızca giriş. Sürücünün bir ara hedefe vardığı gerçek zaman ve konum. Bu alan, sağlayıcının ara hedeflerdeki gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.
actualIntermediateDestinations[]

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.
dropoffPoint

object (TerminalLocation)

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

object (StopLocation)

Yalnızca giriş. Müşterinin bırakıldığı gerçek zaman ve konum. Bu alan, sağlayıcının gerçek bırakma bilgileriyle ilgili geri bildirim sağlaması içindir.
dropoffTime

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".
remainingWaypoints[]

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

object (TripWaypoint)

Bu alan, seyahat için yol noktalarının manuel olarak sıralanmasını destekler. Atanan araç için kalan tüm yol noktalarının yanı sıra bu seyahatin teslim alma ve bırakma yol 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.
route[]

object (LatLng)

Yalnızca çıkış. Bu gezi için kalanWaypoints alanındaki ilk girişe giden tahmini rota. İlk yol noktasının farklı bir geziye ait olabileceğini unutmayın.
currentRouteSegment

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.
currentRouteSegmentVersion

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".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Yalnızca çıkış. Mevcut olduğunda currentRouteSegment üzerindeki trafik koşullarını belirtir.

Not: Bu alan yalnızca Sürücü 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 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".
currentRouteSegmentEndPoint

object (TripWaypoint)

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

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.
etaToFirstWaypoint

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.

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".
remainingTimeToFirstWaypoint

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.

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

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.

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".
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. İ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.

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".
numberOfPassengers

integer

Değişmez. Bu yolculuktaki yolcu sayısını gösterir ve sürücüyü içermez. Bir aracın, vehicles.search yanıtında döndürülecek kullanılabilir kapasitesi olmalıdır.
lastLocation

object (VehicleLocation)

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

boolean

Yalnızca çıkış. Aracın lastLocation değerinin currentRouteSegment değerine bağlanıp bağlanamayacağı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.
view

enum (TripView)

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

TripStatus

Bir gezideki ilerleme durumunu gösteren durum.

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 Yolcu bırakıldı ve yolculuk tamamlandı.
CANCELED Sürücünün, yolcunun veya araç paylaşımı sağlayıcının yolcuyu almasından önce yolculuk iptal edildi.

StopLocation

Durmanın (teslim alma/bırakma) gerçekleştiği gerçek konum.

JSON gösterimi 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Alanlar
point

object (LatLng)

Zorunlu. Gerçek konumu belirtir.
timestamp

string (Timestamp format)

Durdurmanı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".
stopTime
(deprecated)

string (Timestamp format)

Yalnızca giriş. Kullanımdan kaldırıldı. Zaman damgası alanını kullanın.

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".

TripView

trips.get yanıtındaki farklı gezi alanı grupları için seçici. Bağlam için AIP-157'ye bakın. Daha fazla görünüm eklenme ihtimali vardır.

Sıralamalar
TRIP_VIEW_UNSPECIFIED Varsayılan değer. Geriye dönük uyumluluk için API varsayılan olarak bir SDK görünümüne sahip olur. İstikrarlı bir deneyim ve destek almak isteyen müşterilerin SDK dışında bir TripView seçmesi önerilir.
SDK Herkese açık kütüphaneler kullanılarak yorumlanamayan veya desteklenemeyen alanları içerir.
JOURNEY_SHARING_V1S Yolculuk alanları, Yolculuğu Paylaşma kullanım alanı için doldurulur. Bu görünüm, sunucudan sunucuya iletişim 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 gezi hakkında bilgi edinme
Belirli bir araç için tüm seyahatleri alma.

update

 Gezi verilerini günceller.