Package maps.fleetengine.v1

BatteryStatus

stan baterii, np. czy jest naładowana lub czy się ładuje;

PowerSource

Stan źródła zasilania bateryjnego.

float

Aktualny poziom baterii [0–100].

SpeedReadingInterval

Prędkość ruchu na odcinku od poprzedniego do bieżącego punktu trasy.

string

Ścieżka, którą kierowca pokonuje od poprzedniego punktu do obecnego. Ta ścieżka zawiera punkty orientacyjne, dzięki czemu klienci mogą wyświetlać na niej znaczniki ruchu (patrz speed_reading_interval). Dekodowanie nie jest jeszcze obsługiwane.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

string

Wymagany. Unikalny identyfikator przejazdu. Z zastrzeżeniem tych ograniczeń:

• Musi to być prawidłowy ciąg znaków Unicode.
• Maksymalna długość to 64 znaki.
• Znormalizowane zgodnie z formą normalizacji Unicode C.
• Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.

Trip

Wymagany. Encja podróży do utworzenia.

Podczas tworzenia wycieczki wymagane są te pola:

• trip_type
• pickup_point

Jeśli podasz te pola, zostaną one użyte:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Wszystkie pozostałe pola Trip są ignorowane. Na przykład wszystkie podróże zaczynają się od trip_status o wartości NEW, nawet jeśli w żądaniu utworzenia podasz trip_status o wartości CANCELED.

Tylko przejazdy EXCLUSIVE obsługują intermediate_destinations.

Jeśli w przypadku wspólnego przejazdu ustawisz wartość vehicle_id, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów na trasie pojazdu. W przeciwnym razie kolejność punktów na trasie będzie nieokreślona.

Jeśli określisz Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty trasy przejazdów pojazdu bez dodatkowych punktów. Musisz uporządkować te punkty w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscami docelowymi, a wszystkie miejsca docelowe znajdowały się przed punktem docelowym. Punkty pośrednie podróży EXCLUSIVE nie mogą się przeplatać z punktami pośrednimi innych podróży.

Używane są pola trip_id, waypoint_type i location, a wszystkie pozostałe pola TripWaypoint w vehicle_waypoints są ignorowane.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

string

Wymagany. Unikalny identyfikator pojazdu. Z zastrzeżeniem tych ograniczeń:

• Musi to być prawidłowy ciąg znaków Unicode.
• Maksymalna długość to 64 znaki.
• Znormalizowane zgodnie z formą normalizacji Unicode C.
• Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.

Vehicle

Wymagany. Jednostka pojazdu do utworzenia. Podczas tworzenia obiektu Vehicle wymagane są te pola:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Podczas tworzenia pojazdu te pola są ignorowane:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Wszystkie pozostałe pola są opcjonalne i używane, jeśli są wypełnione.

RequestHeader

Opcjonalnie. Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

RequestHeader

Opcjonalnie. Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. {provider} musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

LocationPowerSaveMode

Jak funkcje lokalizacji mają działać na urządzeniu, gdy włączone jest oszczędzanie baterii.

bool

Informacja, czy urządzenie jest obecnie w trybie oszczędzania energii.

bool

Czy urządzenie jest w stanie interaktywnym.

BatteryInfo

Informacje o stanie baterii.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

TripView

Podzbiór pól podróży, które mają zostać zwrócone, i ich interpretacja.

Timestamp

Wskazuje minimalną sygnaturę czasową (wyłączną), dla której pobierane są dane Trip.route lub Trip.current_route_segment. Jeśli dane trasy nie uległy zmianie od tej sygnatury czasowej, pole trasy nie jest ustawione w odpowiedzi. Jeśli nie podano wartości minimalnej, dane trasy są zawsze pobierane.

Timestamp

Wycofane: zawsze pobierane są wartości Trip.remaining_waypoints. Użyj ikony remaining_waypoints_route_version, aby określić, kiedy mają być pobierane dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint.

PolylineFormatType

Zwracany format bieżącej trasy: LAT_LNG_LIST_TYPE (w Trip.route) lub ENCODED_POLYLINE_TYPE (w Trip.current_route_segment). Domyślnie jest to LAT_LNG_LIST_TYPE.

Timestamp

Wskazuje minimalną sygnaturę czasową (wyłączną), dla której pobierana jest wartość Trip.current_route_segment_traffic. Jeśli dane o ruchu nie uległy zmianie od tej sygnatury czasowej, w odpowiedzi nie jest ustawione pole current_route_segment_traffic. Jeśli nie podano wartości minimalnej, dane o ruchu są zawsze pobierane. Pamiętaj, że dane o ruchu są dostępne tylko dla klientów korzystających z usługi Przejazdy i dostawy na żądanie.

Timestamp

Wskazuje minimalny sygnaturę czasową (wyłączną), dla której pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli od tego momentu dane nie uległy zmianie, w odpowiedzi nie są ustawiane powyższe pola. Jeśli parametr remaining_waypoints_route_version nie jest określony, ruch i ścieżka są zawsze pobierane.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

Timestamp

Wskazuje minimalną sygnaturę czasową (wyłączną), dla której pobierana jest wartość Vehicle.current_route_segment. Jeśli trasa nie uległa zmianie od tego momentu, w odpowiedzi nie jest ustawione pole current_route_segment. Jeśli nie podano wartości minimalnej, zawsze pobierana jest wartość current_route_segment.

Timestamp

Wskazuje minimalny sygnaturę czasową (wyłączną), dla której pobierane są dane Vehicle.waypoints. Jeśli punkty pośrednie nie uległy zmianie od tej sygnatury czasowej, w odpowiedzi nie są ustawiane dane vehicle.waypoints. Jeśli to pole nie zostanie określone, zawsze pobierana jest wartość vehicle.waypoints.

string

Wymagany. Kod kraju/regionu CLDR. Na przykład US w przypadku Stanów Zjednoczonych lub IN w przypadku Indii.

string

Ostatnia cyfra numeru rejestracyjnego lub „-1”, jeśli w numerze rejestracyjnym nie ma wartości liczbowej.

• „ABC 1234” -> „4”
• „AB 123 CD” -> „3”
• „ABCDEF” -> „-1”

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

int32

Maksymalna liczba pojazdów do zwrócenia. Wartość domyślna: 100.

string

Wartość parametru next_page_token podana przez poprzednie wywołanie funkcji ListVehicles, aby można było przechodzić między grupami pojazdów. Wartość jest niezdefiniowana, jeśli kryteria filtra żądania nie są takie same jak kryteria filtra poprzedniego wywołania funkcji ListVehicles.

Int32Value

Określa wymaganą minimalną pojemność pojazdu. Wszystkie zwrócone pojazdy będą miały wartość maximum_capacity równą lub większą od tej wartości. Jeśli jest ustawiona, musi być większa od lub równa 0.

TripType

Ogranicza odpowiedź do pojazdów, które obsługują co najmniej 1 z określonych typów przejazdu.

Duration

Ogranicza odpowiedź do pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Pojazdy stacjonarne, które nadal przesyłają swoje lokalizacje, nie są uważane za nieaktualne. Jeśli jest podany, musi być prawidłowym dodatnim czasem trwania.

Category

Wymagany. Ogranicza odpowiedź do pojazdów z jedną z określonych kategorii typu. UNKNOWN – to jest niedozwolone.

string

Wywołujący mogą tworzyć złożone operacje logiczne, używając dowolnej kombinacji pól required_attributes, required_one_of_attributes i required_one_of_attribute_sets.

required_attributes to lista, a required_one_of_attributes używa wiadomości, która umożliwia listę list. Połączenie tych 2 pól umożliwia utworzenie tego wyrażenia:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Ogranicza odpowiedź do pojazdów o określonych atrybutach. To pole jest operacją koniunkcji (AND). Dozwolonych jest maksymalnie 50 atrybutów wymaganych. Jest to maksymalna liczba atrybutów dozwolonych w przypadku pojazdu. Każdy powtarzany ciąg znaków powinien mieć format „klucz:wartość”.

string

Ogranicza odpowiedź do pojazdów z co najmniej jednym z określonych atrybutów w każdym VehicleAttributeList. Na każdej liście pojazd musi pasować do co najmniej jednego atrybutu. To pole jest operacją łączną/OR w każdym VehicleAttributeList i operacją łączną/AND w kolekcji VehicleAttributeList. Każdy powtarzany ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

string

required_one_of_attribute_sets zapewnia dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, required_one_of_attribute_sets używa wiadomości, która umożliwia wyświetlanie listy list, co pozwala na stosowanie wyrażeń takich jak to:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Ogranicza odpowiedź do pojazdów, które pasują do wszystkich atrybutów w VehicleAttributeList. W każdej liście pojazd musi pasować do wszystkich atrybutów. To pole jest operacją koniunkcji/I w każdym VehicleAttributeList i operacją dysjunkcji włączającej/LUB w kolekcji VehicleAttributeList. Każdy powtarzany ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

VehicleState

Ogranicza odpowiedź do pojazdów, które mają ten stan.

bool

Zwracaj tylko pojazdy, które są obecnie w trasie.

string

Opcjonalnie. Zapytanie filtra do zastosowania podczas wyświetlania listy pojazdów. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160.

To pole ma zastąpić pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podasz tu wartość niepustą, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula AND z innymi ograniczeniami, np. vehicle_state lub on_trip_only.

Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Maksymalna liczba ograniczeń dozwolonych w zapytaniu filtra to 50.

Wszystkie atrybuty są też przechowywane jako ciągi znaków, więc jedyne obsługiwane porównania atrybutów to porównania ciągów znaków. Aby porównać wartości liczbowe lub logiczne, musisz umieścić je w cudzysłowie, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

Viewport

Opcjonalnie. Filtr, który ogranicza zwracane pojazdy do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym przez widoczny obszar.

Vehicle

Pojazdy spełniające kryteria podane w żądaniu. Maksymalna liczba zwracanych pojazdów jest określana przez pole page_size w żądaniu.

string

Token umożliwiający pobranie następnej strony z pojazdami lub pusty, jeśli nie ma więcej pojazdów spełniających kryteria żądania.

int64

Wymagany. Łączna liczba pojazdów spełniających kryteria żądania na wszystkich stronach.

string

Wymagany. Musi mieć format providers/{provider}/billableTrips/{billable_trip}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

string

Wymagany. Dwuliterowy kod kraju, w którym odbywa się podróż. Cena jest określana na podstawie kodu kraju.

BillingPlatformIdentifier

Platforma, na której zostało wysłane żądanie.

string

Identyfikatory bezpośrednio związane z zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) operacji przed rezerwacją wykonanych przed udostępnieniem identyfikatora podróży. Liczba related_ids jest ograniczona do 50.

SolutionType

Typ rozwiązania GMP (np. ON_DEMAND_RIDESHARING_AND_DELIVERIES) użytego w przypadku zgłoszonej podróży.

string

Kod języka w formacie BCP-47, np. en-US lub sr-Latn. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli nie określono żadnego języka, odpowiedź może być w dowolnym języku, ale jeśli istnieje nazwa w języku angielskim, będzie ona preferowana. Przykład wartości pola: en-US.

string

Wymagany. Kod regionu CLDR, z którego pochodzi żądanie. Przykład wartości pola: US.

string

Wersja pakietu SDK do połączeń (w stosownych przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 1.1.2.

string

Wersja systemu operacyjnego, na którym działa wywołujący pakiet SDK. Przykłady wartości pola: 4.4.1, 12.1.

string

Model urządzenia, na którym działa wywołujący pakiet SDK. Przykłady wartości pola: iPhone12,1, SM-G920F.

SdkType

Typ pakietu SDK, który wysłał żądanie.

string

Wersja pakietu MapSDK, od której zależy wywołujący pakiet SDK (w odpowiednich przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 5.2.1.

string

Wersja pakietu NavSDK, od której zależy wywołujący pakiet SDK (w odpowiednich przypadkach). Format wersji to „główna.pomniejsza.poprawka”, np. 2.1.0.

Platform

Platforma wywołującego pakietu SDK.

string

Producent urządzenia z Androidem, z którego wywoływany jest pakiet SDK. Dotyczy to tylko pakietów SDK na Androida. Przykład wartości pola: Samsung.

int32

Poziom interfejsu Android API wywołującego pakietu SDK. Dotyczy tylko pakietów SDK na Androida. Przykład wartości pola: 23.

string

Opcjonalny identyfikator, który można podać na potrzeby rejestrowania, aby zidentyfikować żądanie.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

string

Pojazd powiązany z przejazdami w żądaniu. Jeśli nie podano tego argumentu, zwrócone trasy nie zawierają:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Jeśli ma wartość „true”, odpowiedź zawiera przejazdy, które wpływają na trasę kierowcy.

int32

Jeśli nie zostanie ustawiona, serwer zdecyduje, ile wyników ma zwrócić.

string

Ustaw tę wartość na wartość zwróconą wcześniej w parametrze SearchTripsResponse, aby kontynuować od poprzednich wyników.

Duration

Jeśli podano ten parametr, zwraca przejazdy, które nie zostały zaktualizowane po godzinie (current - minimum_staleness).

Trip

Lista przejazdów dla wybranego pojazdu.

string

Przekaż ten token w żądaniu SearchTripsRequest, aby podzielić wyniki listy na strony. Interfejs API zwraca listę przejazdów przy każdym wywołaniu, a gdy nie ma już więcej wyników, lista przejazdów jest pusta.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

TerminalLocation

Wymagany. Punkt odbioru, w pobliżu którego chcesz wyszukać.

TerminalLocation

Miejsce docelowe klienta. To pole jest wymagane, jeśli trip_types zawiera TripType.SHARED.

int32

Wymagany. Określa promień wyszukiwania pojazdu wokół miejsca odbioru. Wyświetlane będą tylko pojazdy znajdujące się w promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie).

int32

Wymagany. Określa maksymalną liczbę pojazdów do zwrócenia. Wartość musi mieścić się w przedziale od 1 do 50 (włącznie).

int32

Wymagany. Określa liczbę pasażerów, którzy mają wziąć udział w podróży. Wartość musi być równa lub większa niż 1. Kierowca nie jest uwzględniany w wartości pojemności.

TripType

Wymagany. Reprezentuje typ proponowanej podróży. Musi zawierać dokładnie 1 typ. UNKNOWN_TRIP_TYPE – to jest niedozwolone. Ogranicza wyszukiwanie tylko do pojazdów, które mogą obsługiwać ten typ przejazdu.

Duration

Ogranicza wyszukiwanie tylko do tych pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Pojazdy stacjonarne, które nadal przesyłają swoje lokalizacje, nie są uważane za nieaktualne. Jeśli to pole nie jest skonfigurowane, serwer używa domyślnej wartości 5 minut.

VehicleType

Wymagany. Ogranicza wyszukiwanie do pojazdów określonego typu. Musisz określić co najmniej 1 typ pojazdu. Typy pojazdów z kategorią UNKNOWN są niedozwolone.

VehicleAttribute

Wywołujący mogą tworzyć złożone operacje logiczne, używając dowolnej kombinacji pól required_attributes, required_one_of_attributes i required_one_of_attribute_sets.

required_attributes to lista, a required_one_of_attributes używa wiadomości, która umożliwia listę list. Połączenie tych 2 pól umożliwia utworzenie tego wyrażenia:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Ogranicza wyszukiwanie tylko do pojazdów o określonych atrybutach. To pole jest operacją koniunkcji (AND). Dozwolonych jest maksymalnie 50 atrybutów wymaganych. Jest to maksymalna liczba atrybutów dozwolonych w przypadku pojazdu.

VehicleAttributeList

Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym VehicleAttributeList. Na każdej liście pojazd musi pasować do co najmniej jednego atrybutu. To pole jest operacją łączną/OR w każdym VehicleAttributeList i operacją łączną/AND w kolekcji VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets zapewnia dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, required_one_of_attribute_sets używa wiadomości, która umożliwia wyświetlanie listy list, co pozwala na stosowanie wyrażeń takich jak to:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Ogranicza wyszukiwanie tylko do pojazdów ze wszystkimi atrybutami w VehicleAttributeList. W każdej liście pojazd musi pasować do wszystkich atrybutów. To pole jest operacją koniunkcji/I w każdym VehicleAttributeList i operacją dysjunkcji włączającej/LUB w kolekcji VehicleAttributeList.

VehicleMatchOrder

Wymagany. Określa żądane kryterium porządkowania wyników.

bool

Wskazuje, czy pojazdy z 1 aktywną podróżą kwalifikują się do tego wyszukiwania. To pole jest używane tylko wtedy, gdy nie określono ustawienia current_trips_present. Jeśli parametr current_trips_present nie jest określony, a to pole ma wartość false, pojazdy z przypisanymi przejazdami są wykluczane z wyników wyszukiwania. Gdy parametr current_trips_present nie jest określony, a to pole ma wartość true, wyniki wyszukiwania mogą obejmować pojazdy z 1 aktywną podróżą o stanie ENROUTE_TO_DROPOFF. Jeśli podano wartość current_trips_present, tego pola nie można ustawić na wartość „prawda”.

Wartością domyślną jest false.

string

Wskazuje podróż powiązaną z tym SearchVehicleRequest.

CurrentTripsPresent

Wskazuje, czy pojazdy z aktywnymi przejazdami kwalifikują się do tego wyszukiwania. Jeśli trip_type zawiera SHARED, musi mieć wartość inną niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.

string

Opcjonalnie. Zapytanie filtra do zastosowania podczas wyszukiwania pojazdów. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160.

To pole ma zastąpić pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podasz tu wartość niepustą, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula AND z innymi ograniczeniami, np. minimum_capacity lub vehicle_types.

Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Maksymalna liczba ograniczeń dozwolonych w zapytaniu filtra to 50.

Wszystkie atrybuty są też przechowywane jako ciągi znaków, więc jedyne obsługiwane porównania atrybutów to porównania ciągów znaków. Aby porównać wartości liczbowe lub logiczne, musisz umieścić je w cudzysłowie, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

VehicleMatch

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

int32

Indeks początkowy tego przedziału w ścieżce. W pliku JSON, gdy indeks wynosi 0, pole będzie wyglądać na nieuzupełnione.

int32

Indeks końcowy tego przedziału w ścieżce. W pliku JSON, gdy indeks wynosi 0, pole będzie wyglądać na nieuzupełnione.

Speed

Prędkość ruchu w tym przedziale.

LatLng

Wymagany. Oznacza rzeczywistą lokalizację.

Timestamp

Wskazuje, kiedy nastąpiło zatrzymanie.

Timestamp

Tylko dane wejściowe. Rola wycofana. Użyj pola sygnatury czasowej.

LatLng

Oznacza dokładną LatLng punktu trasy. Jako dane wejściowe należy podać wartość point lub place. Jeśli określono oba te parametry, do routingu będzie używany parametr point, a do metadanych – parametr place. Jeśli jako dane wejściowe podano tylko place, wartość point zostanie obliczona na podstawie place i uwzględniona w danych wyjściowych.

string

Nazwa zasobu miejsca, które reprezentuje tę lokalizację. Format to places/{place_id}. Jako dane wejściowe należy podać wartość point lub place. Jeśli określono oba te parametry, do routingu będzie używany parametr point, a do metadanych – parametr place. place jest uwzględniany w danych wyjściowych tylko wtedy, gdy był uwzględniony w danych wejściowych, co oznacza, że nie jest wykonywane wyszukiwanie place na podstawie LatLng.

To funkcja eksperymentalna.

PointSource

Tylko dane wyjściowe. Źródło pola point.

TerminalPointId

Wycofane: zamiast tego określ pole place.

string

Wycofane: zamiast tego określ pole place.

string

Rola wycofana.

WaypointType

Wycofane: Vehicle.waypoint będzie zawierać te dane.

string

Rola wycofana.

string

Rola wycofana.

string

Rola wycofana.

VisualTrafficReportPolylineRendering

Linia łamana pokazująca, jak szybko poruszają się pojazdy we wszystkich regionach na jednym odcinku trasy klienta.

string

Tylko dane wyjściowe. W formacie „providers/{provider}/trips/{trip}”

string

Identyfikator pojazdu odbywającego tę podróż.

TripStatus

Bieżący stan podróży.

TripType

Rodzaj podróży.

TerminalLocation

Lokalizacja, w której klient chce zostać odebrany.

StopLocation

Tylko dane wejściowe. Rzeczywista lokalizacja, w której klient został odebrany. W tym polu dostawca może przekazać opinię na temat rzeczywistych informacji o odbiorze.

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do punktu odbioru. To pole służy dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.

Timestamp

Tylko dane wyjściowe. Szacowana przyszła godzina odbioru pasażera lub pasażerów albo faktyczna godzina odbioru.

TerminalLocation

Przystanki pośrednie w kolejności, w jakiej są wymagane w przypadku przejazdu (oprócz miejsca odbioru i docelowego). Początkowo nie będzie to obsługiwane w przypadku wspólnych podróży.

Timestamp

Wskazuje czas ostatniej modyfikacji intermediate_destinations. Serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w parametrze UpdateTripRequest podczas aktualizacji intermediate_destination_index, aby mieć pewność, że parametr intermediate_destinations nie zostanie zmieniony.

int32

Gdy TripStatus ma wartość ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca, do którego pośredniego miejsca docelowego pojazd dotrze w następnej kolejności. Gdy TripStatus ma wartość ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca, w którym pośrednim miejscu docelowym znajduje się pojazd. Wartość tę ustala dostawca. Jeśli nie ma znaku intermediate_destinations, to pole jest ignorowane.

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do miejsca docelowego. W tym polu dostawca może przekazać informacje zwrotne o rzeczywistym czasie przyjazdu do miejsc docelowych na trasie.

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce odbioru klienta z miejsca docelowego. To pole służy dostawcy do przekazywania opinii na temat rzeczywistych informacji o odbiorze w miejscach docelowych.

TerminalLocation

Miejsce, w którym klient chce wysiąść.

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce, w którym klient został wysadzony. To pole służy dostawcy do przekazywania opinii na temat rzeczywistych informacji o miejscu wysadzenia.

Timestamp

Tylko dane wyjściowe. Szacowana przyszła godzina, o której pasażer(owie) zostaną wysadzeni w miejscu docelowym, lub faktyczna godzina, o której zostali wysadzeni.

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka od bieżącej lokalizacji do miejsca wysiadki, włącznie z nim. Może ona zawierać punkty pośrednie z innych podróży.

TripWaypoint

To pole obsługuje ręczne określanie kolejności punktów na trasie. Zawiera wszystkie pozostałe punkty trasy przypisanego pojazdu, a także punkty odbioru i wysadzenia pasażera w przypadku tej podróży. Jeśli przejazd nie został przypisany do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane przez serwer tylko w przypadku wywołań UpdateTrip i CreateTrip, a NIE w przypadku wywołań GetTrip.

LatLng

Tylko dane wyjściowe. Przewidywana trasa tej podróży do pierwszego punktu w polu remaining_waypoints. Pamiętaj, że pierwszy punkt może należeć do innej podróży.

string

Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu pośredniego.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

Timestamp

Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji trasy.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiety Driver SDK i Consumer SDK.

ConsumableTrafficPolyline

Tylko dane wyjściowe. Wskazuje warunki na drodze na trasie current_route_segment, gdy są dostępne.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiety Driver SDK i Consumer SDK.

Timestamp

Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji current_route_segment_traffic.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiety Driver SDK i Consumer SDK.

TripWaypoint

Tylko dane wyjściowe. Punkt pośredni, w którym kończy się current_route_segment.

Int32Value

Tylko dane wyjściowe. Pozostały dystans do pokonania w polu current_route_segment. Wartość jest nieokreślona, jeśli przejazd nie jest przypisany do pojazdu lub został zakończony albo anulowany.

Timestamp

Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu trasy (pierwszy wpis w polu remaining_waypoints). Wartość jest nieokreślona, jeśli przejazd nie jest przypisany do pojazdu lub jest nieaktywny (zakończony lub anulowany).

Duration

Tylko dane wyjściowe. Czas od momentu zwrócenia danych o podróży do momentu w Trip.eta_to_first_waypoint. Wartość jest nieokreślona, jeśli przejazd nie jest przypisany do pojazdu lub jest nieaktywny (zakończony lub anulowany).

Timestamp

Tylko dane wyjściowe. Wskazuje ostatnią zmianę remaining_waypoints (dodanie, usunięcie lub zmiana punktu pośredniego).

Timestamp

Tylko dane wyjściowe. Wskazuje ostatnią modyfikację remaining_waypoints.path_to_waypoint i remaining_waypoints.traffic_to_waypoint. Aplikacja kliencka powinna buforować tę wartość i przekazywać ją w parametrze GetTripRequest, aby ścieżki i ruch dla remaining_waypoints były zwracane tylko wtedy, gdy zostaną zaktualizowane.

int32

Niezmienne. Wskazuje liczbę pasażerów w tej podróży (nie obejmuje kierowcy). Aby pojazd mógł zostać zwrócony w odpowiedzi SearchVehicles, musi mieć dostępną pojemność.

VehicleLocation

Tylko dane wyjściowe. Wskazuje ostatnią zgłoszoną lokalizację pojazdu na trasie.

bool

Tylko dane wyjściowe. Wskazuje, czy last_location pojazdu można przyciągnąć do current_route_segment. Wartość Fałsz, jeśli last_location lub current_route_segment nie istnieje. Jest obliczany przez Fleet Engine. Wszelkie aktualizacje od klientów będą ignorowane.

TripView

Podzbiór pól podróży, które są wypełnione, i sposób ich interpretacji.

TripAttribute

Lista niestandardowych atrybutów podróży. Każdy atrybut musi mieć unikalny klucz.

string

Klucz atrybutu. Klucze nie mogą zawierać dwukropka (:).

string

Wartość atrybutu typu ciąg znaków.

bool

Wartość atrybutu typu logicznego.

double

Wartość atrybutu typu double.

TerminalLocation

Lokalizacja tego punktu.

string

Podróż powiązana z tym punktem.

WaypointType

Rola tego punktu na trasie, np. miejsce odbioru lub miejsce docelowe.

LatLng

Ścieżka od poprzedniego punktu trasy do bieżącego. Jeśli jest to pierwszy punkt pośredni, trasa prowadzi od bieżącej lokalizacji pojazdu do punktu pośredniego. To pole jest wypełniane tylko na żądanie.

string

Zakodowana ścieżka od poprzedniego punktu trasy do bieżącego punktu trasy.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

ConsumableTrafficPolyline

Warunki na drodze na odcinku do tego punktu. Pamiętaj, że dane o ruchu są dostępne tylko dla klientów korzystających z rozwiązania Rides and Deliveries na platformie Map Google.

Int32Value

Odległość ścieżki od poprzedniego do bieżącego punktu trasy. Jeśli jest to pierwszy punkt pośredni, odległość trasy jest liczona od bieżącej lokalizacji pojazdu do punktu pośredniego.

Timestamp

Szacowany czas dotarcia do tego punktu.

Duration

Czas podróży z poprzedniego punktu trasy do tego punktu. Jeśli jest to pierwszy punkt pośredni, czas podróży jest liczony od bieżącej lokalizacji pojazdu do punktu pośredniego.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawcą musi być identyfikator projektu (np. sample-consumer-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

Trip

Wymagany. Podróż powiązana z aktualizacją.

Te pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Gdy aktualizujesz Trip.vehicle_id w przypadku wspólnego przejazdu, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów pośrednich. W przeciwnym razie kolejność będzie nieokreślona.

Jeśli określisz Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty trasy przejazdów pojazdu bez dodatkowych punktów. Musisz uporządkować te punkty w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscami docelowymi, a wszystkie miejsca docelowe znajdowały się przed punktem docelowym. Punkty pośrednie podróży EXCLUSIVE nie mogą się przeplatać z punktami pośrednimi innych podróży. Używane są pola trip_id, waypoint_type i location, a wszystkie pozostałe pola TripWaypoint w vehicle_waypoints są ignorowane.

Aby uniknąć sytuacji wyścigu w przypadku podróży z wieloma miejscami docelowymi, podczas aktualizowania stanu podróży na ENROUTE_TO_INTERMEDIATE_DESTINATION należy podać Trip.intermediate_destinations_version. Wartość Trip.intermediate_destinations_version musi być zgodna z wersją Fleet Engine. Jeśli nie, żądanie się nie powiedzie.

FieldMask

Wymagany. Maska pola wskazująca pola w obiekcie Trip, które mają zostać zaktualizowane. Element update_mask musi zawierać co najmniej 1 pole.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. Dostawcą musi być identyfikator projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

VehicleAttribute

Wymagany. Atrybuty pojazdu do zaktualizowania. Atrybuty, które nie zostały wymienione, nie zostaną zmienione ani usunięte.

VehicleAttribute

Wymagany. Zaktualizowana pełna lista atrybutów pojazdu, w tym nowe, zmienione i niezmienione atrybuty.

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. {provider} musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi dokonujące tego wywołania.

Vehicle

Wymagany. Wartości elementu Vehicle do zastosowania. Podczas aktualizowania Vehicle nie można aktualizować tych pól, ponieważ są one zarządzane przez serwer.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Jeśli pole attributes zostanie zaktualizowane, wszystkie atrybuty pojazdu zostaną zastąpione atrybutami podanymi w żądaniu. Jeśli chcesz zaktualizować tylko niektóre atrybuty, zapoznaj się z metodą UpdateVehicleAttributes.

Podobnie pole waypoints można zaktualizować, ale musi ono zawierać wszystkie punkty pośrednie, które są obecnie w pojeździe, i żadne inne.

FieldMask

Wymagany. Maska pola wskazująca, które pola Vehicle mają zostać zaktualizowane. Musisz podać co najmniej 1 nazwę pola.

string

Tylko dane wyjściowe. Unikalna nazwa tego pojazdu. Format to providers/{provider}/vehicles/{vehicle}.

VehicleState

Stan pojazdu.

TripType

Typy przejazdów obsługiwane przez ten pojazd.

string

Tylko dane wyjściowe. Lista trip_id w przypadku przejazdów przypisanych obecnie do tego pojazdu.

VehicleLocation

Ostatnia zgłoszona lokalizacja pojazdu.

VehicleLocation

Tylko dane wejściowe. Lokalizacje, w których pojazd był w przeszłości, ale nie zostały jeszcze zgłoszone do Fleet Engine. Jest on używany w UpdateVehicleRequest do rejestrowania lokalizacji, których wcześniej nie można było wysłać na serwer. Zwykle dzieje się tak, gdy pojazd nie ma połączenia z internetem.

int32

Łączna liczba pasażerów, których może przewozić ten pojazd. Kierowca nie jest uwzględniany w tej wartości. Ta wartość musi być równa lub większa niż 1.

VehicleAttribute

Lista atrybutów pojazdu. Pojazd może mieć maksymalnie 100 atrybutów, a każdy atrybut musi mieć unikalny klucz.

VehicleType

Wymagany. Typ pojazdu. Może służyć do filtrowania pojazdów w wynikach SearchVehicles. Wpływa też na obliczenia szacowanego czasu przyjazdu i trasy.

LicensePlate

Informacje o tablicy rejestracyjnej pojazdu.

TerminalLocation

Wycofana: zamiast niej używaj zasady Vehicle.waypoints.

string

Linia łamana określająca trasę, którą aplikacja kierowcy zamierza pokonać do następnego punktu pośredniego. Ta lista jest też zwracana w Trip.current_route_segment w przypadku wszystkich aktywnych przejazdów przypisanych do pojazdu.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK. Dekodowanie nie jest jeszcze obsługiwane.

TrafficPolylineData

Tylko dane wejściowe. Fleet Engine używa tych informacji do ulepszania udostępniania przejazdów. Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK.

Timestamp

Tylko dane wyjściowe. Czas ustawienia wartości current_route_segment. Może być przechowywany przez klienta i przekazywany w przyszłych żądaniach GetVehicle, aby zapobiec zwracaniu tras, które się nie zmieniły.

TripWaypoint

Punkt pośredni, w którym kończy się current_route_segment. Kierowcy mogą podawać te informacje podczas rozmów telefonicznych UpdateVehicle jako pełny punkt pośredni przejazdu, punkt pośredni LatLng lub ostatni punkt LatLng w current_route_segment. Fleet Engine spróbuje wtedy interpolować do rzeczywistego punktu pośredniego, jeśli nie jest on w pełni określony. To pole jest ignorowane w wywołaniach UpdateVehicle, chyba że określono też parametr current_route_segment.

Int32Value

Pozostała odległość do przejechania w przypadku current_route_segment. Ta wartość jest też zwracana w Trip.remaining_distance_meters w przypadku wszystkich aktywnych przejazdów przypisanych do pojazdu. Jeśli pole current_route_segment jest puste, wartość jest nieokreślona.

Timestamp

Szacowany czas dotarcia do pierwszego wpisu w polu waypoints. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona.

Podczas aktualizowania pojazdu w tym samym żądaniu parametr remaining_time_seconds ma pierwszeństwo przed parametrem eta_to_first_waypoint.

Int32Value

Tylko dane wejściowe. Pozostały czas jazdy w przypadku current_route_segment. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona. Jeśli wszystkie strony korzystają z tego samego zegara, ta wartość powinna być zgodna z wartością eta_to_first_waypoint – current_time.

Podczas aktualizowania pojazdu w tym samym żądaniu parametr remaining_time_seconds ma pierwszeństwo przed parametrem eta_to_first_waypoint.

TripWaypoint

Pozostałe punkty trasy przypisane do tego pojazdu.

Timestamp

Tylko dane wyjściowe. Ostatnia aktualizacja pola waypoints. Klienci powinni zapisywać tę wartość w pamięci podręcznej i przekazywać ją w parametrze GetVehicleRequest, aby pole waypoints było zwracane tylko wtedy, gdy zostanie zaktualizowane.

bool

Wskazuje, czy kierowca akceptuje przejazdy jeden po drugim. Jeśli true, SearchVehicles może obejmować pojazd, nawet jeśli jest on obecnie przypisany do przejazdu. Wartością domyślną jest false.

NavigationStatus

Stan nawigacji pojazdu.

DeviceSettings

Tylko dane wejściowe. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę.

Category

Kategoria typu pojazdu

string

Klucz atrybutu. Klucze nie mogą zawierać dwukropka (:).

string

Wartość atrybutu.

string

Wartość atrybutu typu ciąg znaków.

Uwaga: to pole jest identyczne z polem value, które zostanie w końcu wycofane. W przypadku metod tworzenia lub aktualizowania można użyć dowolnego pola, ale zdecydowanie zalecamy używanie pola string_value. Jeśli ustawione są oba parametry string_value i value, muszą być identyczne. W przeciwnym razie zostanie zgłoszony błąd. Oba pola są wypełniane w odpowiedziach.

bool

Wartość atrybutu typu logicznego.

double

Wartość atrybutu typu double.

VehicleAttribute

Lista atrybutów w tej kolekcji.

LatLng

Lokalizacja pojazdu. Gdy jest wysyłana do Fleet Engine, lokalizacja pojazdu jest lokalizacją GPS. Gdy otrzymasz ją w odpowiedzi, lokalizacja pojazdu może być lokalizacją GPS, lokalizacją dodatkową lub inną lokalizacją szacunkową. Źródło jest określone w location_sensor.

DoubleValue

Wycofana: zamiast niej używaj zasady latlng_accuracy.

DoubleValue

Dokładność location w metrach jako promień.

Int32Value

Kierunek, w którym porusza się pojazd, w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).

DoubleValue

Wycofana: zamiast niej używaj zasady heading_accuracy.

DoubleValue

Dokładność heading w stopniach.

DoubleValue

Wysokość w metrach nad poziomem WGS84.

DoubleValue

Wycofana: zamiast niej używaj zasady altitude_accuracy.

DoubleValue

Dokładność altitude w metrach.

Int32Value

Prędkość pojazdu w kilometrach na godzinę. Wycofana: zamiast niej używaj zasady speed.

DoubleValue

Prędkość pojazdu w metrach na sekundę

DoubleValue

Dokładność speed w metrach na sekundę.

Timestamp

Czas, w którym czujnik zgłosił wartość location zgodnie z zegarem czujnika.

Timestamp

Tylko dane wyjściowe. Czas, w którym serwer otrzymał informacje o lokalizacji.

LocationSensor

Dostawca danych o lokalizacji (np. GPS).

BoolValue

Określa, czy ikona location jest przyciągana do drogi.

BoolValue

Tylko dane wejściowe. Określa, czy na urządzeniu mobilnym jest włączony czujnik GPS.

Int32Value

Tylko dane wejściowe. Czas (w sekundach) od momentu, gdy ta lokalizacja została po raz pierwszy wysłana na serwer. W przypadku pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (np. po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do zera.

Int32Value

Tylko dane wejściowe. Wycofano: do określania, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały.

LatLng

Surowa lokalizacja pojazdu (nieprzetworzona przez funkcję przyciągania do drogi).

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

LocationSensor

Źródło nieprzetworzonej lokalizacji. Domyślna wartość to GPS.

DoubleValue

Dokładność raw_location jako promień w metrach.

LatLng

Lokalizacja z usługi lokalizacyjnej Androida.

Timestamp

Aktualizacja sygnatury czasowej flp_location

DoubleValue

Dokładność flp_location w metrach jako promień.

Int32Value

Kierunek, w którym porusza się pojazd, w stopniach, określony przez dostawcę połączonej lokalizacji. 0 oznacza północ. Prawidłowy zakres to [0,360).

LatLng

Dodatkowa lokalizacja podana przez aplikację integrującą.

Timestamp

Sygnatura czasowa powiązana z dodatkową lokalizacją.

LocationSensor

Źródło dodatkowej lokalizacji. Domyślna wartość to CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Dokładność supplemental_location jako promień w metrach.

bool

Wycofana: zamiast niej używaj zasady is_road_snapped.

Vehicle

Wymagany. pojazd zgodny z żądaniem;

Timestamp

Szacowany czas dojazdu pojazdu do punktu odbioru określonego w żądaniu. Pusta wartość oznacza, że nie udało się obliczyć szacowanego czasu dotarcia pojazdu. Jeśli SearchVehiclesRequest.include_back_to_back było true, a ten pojazd jest w trakcie aktywnej podróży, vehicle_pickup_eta obejmuje czas potrzebny na jej ukończenie.

Int32Value

Odległość od bieżącej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, w tym wszelkie pośrednie punkty odbioru lub wysiadania w przypadku istniejących przejazdów. Ta odległość obejmuje obliczoną odległość dojazdu (trasy) oraz odległość w linii prostej między punktem końcowym nawigacji a miejscem odbioru. (Odległość między punktem docelowym nawigacji a punktem odbioru jest zwykle niewielka). Pusta wartość oznacza błąd w obliczeniach odległości.

Int32Value

Wymagany. Odległość w linii prostej między pojazdem a miejscem odbioru określonym w żądaniu.

Timestamp

Całkowity szacowany czas dojazdu pojazdu do punktu odbioru określonego w żądaniu. Szacowany czas przyjazdu obejmuje przystanki w dowolnych punktach pośrednich przed punktem dropoff_point określonym w żądaniu. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie określony punkt odbioru. Pusta wartość oznacza błąd podczas obliczania szacowanego czasu przyjazdu.

Int32Value

Odległość (w metrach) od miejsca odbioru do miejsca docelowego określonego w żądaniu. Odległość jest mierzona tylko między tymi 2 punktami i nie obejmuje lokalizacji pojazdu ani żadnych innych punktów, które należy odwiedzić, zanim pojazd dotrze do punktu odbioru lub docelowego. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie określony parametr dropoff_point. Pusta wartość oznacza, że nie udało się obliczyć odległości od miejsca odbioru do miejsca docelowego podanego w żądaniu.

TripType

Wymagany. Typ przejazdu w żądaniu, które zostało użyte do obliczenia szacowanego czasu dotarcia do miejsca odbioru.

Waypoint

Uporządkowana lista punktów pośrednich używana do obliczania szacowanego czasu dotarcia. Lista zawiera lokalizację pojazdu, punkty odbioru aktywnych przejazdów pojazdu oraz punkty odbioru podane w żądaniu. Pusta lista oznacza, że nie udało się obliczyć szacowanego czasu dotarcia pojazdu.

VehicleMatchType

Rodzaj dopasowania pojazdu.

VehicleMatchOrder

Kolejność sortowania pasujących pojazdów. Odpowiednik: ordered_by.

VehicleMatchOrder

Kolejność sortowania pasujących pojazdów. Odpowiednik: requested_ordered_by.

RoadStretch

Opcjonalnie. Odcinki dróg, które mają być renderowane wzdłuż linii łamanej. Odcinki nie mogą się nakładać i nie muszą obejmować całej trasy.

Jeśli nie ma odcinka drogi do stylu, klient powinien zastosować domyślny styl trasy.

Style

Wymagany. Styl do zastosowania.

int32

Wymagany. Styl powinien być stosowany w zakresie [offset_meters, offset_meters + length_meters).

int32

Wymagany. Długość ścieżki, do której ma być zastosowany styl.

LatLng

Lokalizacja tego punktu.

Timestamp

Szacowany czas dotarcia pojazdu do tego punktu.