SearchVehiclesResponse

vehicles.search odpowiedź.

Zapis JSON
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
Pola
matches[]

object (VehicleMatch)

Lista pojazdów, które spełniają kryteria SearchVehiclesRequest, uporządkowana według pola SearchVehiclesRequest.order_by.

VehicleMatch

Zawiera dane dotyczące pojazdu i powiązane z nim dane szacunkowe pasujące do punktów aktywnych przejazdów pojazdem SearchVehiclesRequest.

Zapis JSON
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
Pola
vehicle

object (Vehicle)

To pole jest wymagane. Pojazd pasujący do żądania.

vehiclePickupEta

string (Timestamp format)

Szacowany czas dotarcia pojazdu do miejsca odbioru wskazanego w żądaniu. Pusta wartość oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli SearchVehiclesRequest.include_back_to_back to true, a ten pojazd ma aktywną podróż, vehiclePickupEta uwzględnia czas potrzebny do ukończenia bieżącej aktywnej podróży.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

vehiclePickupDistanceMeters

integer

Odległość od bieżącej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, z uwzględnieniem wszystkich pośrednich punktów odbioru lub miejsca zwrotu w przypadku dotychczasowych podróży. Ta odległość obejmuje obliczoną odległość (trasę) oraz odległość w linii prostej między punktem końcowym nawigacji a żądanym punktem odbioru. (Odległość między punktem końcowym nawigacji a żądanym punktem odbioru jest zwykle mała). Pusta wartość oznacza błąd przy obliczaniu odległości.

vehiclePickupStraightLineDistanceMeters

integer

To pole jest wymagane. W linii prostej między pojazdem a punktem odbioru określonym w żądaniu.

vehicleDropoffEta

string (Timestamp format)

Pełny szacowany czas dotarcia na miejsce w ramach przejazdu pojazdu do miejsca zwrotu określonego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje postój na każdym punkcie na trasie przed obiektem dropoffPoint określonym w żądaniu. Ta wartość jest wypełniana tylko wtedy, gdy w żądaniu określisz punkt zwrotu. Pusta wartość oznacza błąd podczas obliczania szacowanego czasu dotarcia.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

vehiclePickupToDropoffDistanceMeters

integer

Odległość pojazdu (w metrach) od punktu odbioru do miejsca docelowego podanego w żądaniu. Odległość jest wyrażona wyłącznie między tymi dwoma punktami i nie obejmuje lokalizacji pojazdu ani żadnych innych punktów, które trzeba odwiedzić, zanim pojazd odwiedzi punkt odbioru lub punkt zwrotu. Ta wartość zostanie wypełniona tylko wtedy, gdy w żądaniu określisz dropoffPoint. Pusta wartość oznacza błąd w obliczaniu odległości od miejsca odbioru do punktu odbioru określonego w żądaniu.

tripType

enum (TripType)

To pole jest wymagane. Typ podróży dla żądania, które zostało użyte do obliczenia szacowanego czasu dotarcia do punktu odbioru.

vehicleTripsWaypoints[]

object (Waypoint)

Uporządkowana lista punktów na trasie używanych do obliczania szacowanego czasu dotarcia na miejsce. Lista obejmuje lokalizację pojazdu, punkty odbioru aktywnych podróży oraz punkty odbioru podane w prośbie. Pusta lista oznacza, że nie udało się obliczyć szacowanego czasu dotarcia na miejsce.

vehicleMatchType

enum (VehicleMatchType)

Typ dopasowania pojazdu.

requestedOrderedBy

enum (VehicleMatchOrder)

Żądana kolejność sortowania pojazdów.

orderedBy

enum (VehicleMatchOrder)

Rzeczywiste zamówienie użyte w przypadku tego pojazdu. Zwykle jest ona zgodna z polem „orderBy” w żądaniu, ale w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, można użyć innej metody (np. PICKUP_POINT_STRAIGHT_DISTANCE).

Punkt pośredni

Opisuje punkty pośrednie na trasie w obrębie rzeki VehicleMatch w regionie SearchVehiclesResponse. Ten element jest przedstawiany jako TripWaypoint we wszystkich pozostałych punktach końcowych.

Zapis JSON
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
Pola
latLng

object (LatLng)

Lokalizacja tego punktu na trasie.

eta

string (Timestamp format)

Szacowany czas dotarcia pojazdu do tego punktu pośredniego.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

VehicleMatchType

Typ dopasowania pojazdu.

Wartości w polu enum
UNKNOWN Nieznany typ dopasowania pojazdu
EXCLUSIVE Pojazd nie ma obecnie przypisanej podróży i może udać się do punktu odbioru.
BACK_TO_BACK Pojazd jest obecnie przypisany do podróży, ale może przejść do punktu odbioru po zakończeniu trwającej podróży. Przy obliczaniu czasu dotarcia i dystansu uwzględnia się istniejącą trasę.
CARPOOL Pojazd ma wystarczającą pojemność na wspólne przejazdy.
CARPOOL_BACK_TO_BACK Pojazd zakończy swoją bieżącą, aktywną podróż, zanim dotrzesz do punktu odbioru. Przy obliczaniu czasu dotarcia i dystansu uwzględnia się istniejącą trasę.