REST Resource: providers.trips

Kaynak: Gezi

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)

Gezi 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 gelişinin gerçek zamanı ve konumu. 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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
intermediateDestinations[]

object (TerminalLocation)

Yolculuğun isteklerine göre ara duraklar (alış ve bırakma noktalarına ek olarak). Bu özellik başlangıçta paylaşılan geziler için desteklenmeyecek.
intermediateDestinationsVersion

string (Timestamp format)

intermediateDestinations öğesinin en son ne zaman değiştirildiğini belirtir. 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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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ı belirler. intermediateDestinations yoksa bu alan yoksayı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 bir varış noktasından 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 bırakı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 bilgileri hakkında geri bildirim sağlaması içindir.
dropoffTime

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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
remainingWaypoints[]

object (TripWaypoint)

Yalnızca çıkış. Mevcut konumdan teslim noktasına giden tam yol (bu noktalar dahil). Bu yol, diğer gezilerdeki yol noktalarını 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. Gezi bir araca atanmamışsa Fleet Engine bu alanı yoksayar. 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.
route[]

object (LatLng)

Yalnızca çıkış. remainingWaypoints girişindeki ilk girişe kadar bu gezi için beklenen 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 belirtir.

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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 belirtir.

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
currentRouteSegmentEndPoint

object (TripWaypoint)

Yalnızca çıkış. currentRouteSegment değerinin sona erdiği yol noktası.
remainingDistanceMeters

integer

Yalnızca çıkış. currentRouteSegment alanında kalan sürüş mesafesi. Gezi bir araca atanmamışsa veya 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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
remainingTimeToFirstWaypoint

string (Duration format)

Yalnızca çıkış. Gezi verilerinin döndürüldüğü andan Trip.eta_to_first_waypoint'teki 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 kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
remainingWaypointsRouteVersion

string (Timestamp format)

Yalnızca çıkış. remainingWaypoints.path_to_waypoint ve remainingWaypoints.traffic_to_waypoint öğelerinin en son ne zaman değiştirildiğini 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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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 müsait kapasitesi olmalıdır.
lastLocation

object (VehicleLocation)

Yalnızca çıkış. Aracın rota üzerindeki son bildirilen konumunu gösterir.
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 seyahat durumu için kullanılır.
NEW Yeni oluşturulan gezi.
ENROUTE_TO_PICKUP Sürücü, teslim alma noktasına doğru yola çıkmıştır.
ARRIVED_AT_PICKUP Sürücü, teslim alma noktasına ulaştı.
ARRIVED_AT_INTERMEDIATE_DESTINATION Sürücü, ara hedefe ulaştı ve yolcuyu bekliyor.
ENROUTE_TO_INTERMEDIATE_DESTINATION Sürücü, teslim noktası değil, ara bir hedefe gidiyordur.
ENROUTE_TO_DROPOFF Sürücü, yolcuyu alıp bir sonraki hedefe doğru yola çıkmıştır.
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

Bir durak (araç alma/bırakma) işleminin 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.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
stopTime
(deprecated)

string (Timestamp format)

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

TripView

trips.get yanıtındaki farklı gezi alanı grupları için seçici. Bağlam için AIP-157'ye bakın. Ek görünümler eklenebilir.

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 desteklenmeyen 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'da bir gezi oluşturur ve yeni geziyi döndürür.

get

 Tek bir gezi hakkında bilgi edinme.
Belirli bir araca ait tüm seyahatleri alın.

update

 Gezi verilerini günceller.