Package maps.fleetengine.v1

Indeks

Usługa TripService

Usługa zarządzania podróżami.

Utwórz podróż

rpc CreateTrip(CreateTripRequest) returns (Trip)

Tworzy podróż we Fleet Engine i zwraca nową.

Podróż

rpc GetTrip(GetTripRequest) returns (Trip)

Wyświetlanie informacji o pojedynczej podróży.

Zgłoś podróż płatniczą

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Raportowanie wykorzystania płatnych podróży.

Podróże z wyszukiwaniem

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Wyświetl wszystkie informacje dotyczące danego pojazdu.

Podróż po aktualizacji

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualizuje dane podróży.

Serwis samochodowy

Zarządzanie pojazdami.

Tworzenie pojazdu

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tworzy nowy pojazd powiązany z usługą wspólnych przejazdów na żądanie lub dostawcom. Każdy element Vehicle musi mieć unikalny identyfikator pojazdu.

Podczas tworzenia Vehicle wymagane są te pola Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia Vehicle ignorowane są te pola Vehicle:

  • 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 są używane, jeśli zostały podane.

Pobieranie pojazdu

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Zwraca pojazd z Fleet Engine.

Wyświetlanie listy pojazdów

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Zwraca podzieloną na strony listę pojazdów powiązanych z dostawcą, które pasują do opcji żądania.

Zjawiskowe pojazdy

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Wycofane: użyj atrybutu SearchVehicles.

Szukaj pojazdów

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Zwraca listę pojazdów pasujących do opcji żądania.

Aktualizuj pojazd

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Zapisuje zaktualizowane dane o pojazdach we Fleet Engine.

Podczas aktualizowania pola Vehicle nie można zaktualizować następujących pól, ponieważ są one zarządzane przez serwer:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Nie można też zaktualizować pojazdu name.

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że zostać zaktualizowane, ale musi zawierać wszystkie punkty na trasie znajdujące się obecnie na pojeździe, bez żadnych innych punktów na trasie.

Aktualizuj atrybutyPojazdu

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Częściowo aktualizuje atrybuty pojazdu. Zostaną zaktualizowane tylko atrybuty wymienione w żądaniu. Pozostałe atrybuty NIE ulegną zmianie. Uwaga: różni się to w przypadku parametru UpdateVehicle, gdzie całe pole attributes zostanie zastąpione polem UpdateVehicleRequest, a atrybuty, których nie ma w żądaniu, zostaną usunięte.

Aktualizuj lokalizację pojazdu

rpc UpdateVehicleLocation(UpdateVehicleLocationRequest) returns (VehicleLocation)

Wycofane: użyj metody UpdateVehicle. UpdateVehicleLocation aktualizuje lokalizację pojazdu.

Informacje o baterii

Informacje o baterii urządzenia.

Pola
battery_status

BatteryStatus

Stan baterii (pełna, naładowana itp.).

power_source

PowerSource

Stan źródła zasilania baterii.

battery_percentage

float

Obecny procentowy poziom naładowania baterii [0-100].

Stan baterii

Stan baterii (pełna, naładowana itp.).

Wartości w polu enum
UNKNOWN_BATTERY_STATUS Nieznany stan baterii.
BATTERY_STATUS_CHARGING Trwa ładowanie baterii.
BATTERY_STATUS_DISCHARGING Bateria się rozładowuje.
BATTERY_STATUS_FULL Bateria jest pełna.
BATTERY_STATUS_NOT_CHARGING Bateria się nie ładuje.
BATTERY_STATUS_POWER_LOW Słaba bateria.

Identyfikator platformy rozliczeniowej

Zestaw wartości wskazujących, do której platformy zostało wysłane żądanie.

Wartości w polu enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Domyślny: Używany w przypadku nieokreślonych platform.
SERVER Platforma to serwer klienta.
WEB Platforma to przeglądarka.
ANDROID Platformą jest urządzenie mobilne z Androidem.
IOS Platformą jest urządzenie mobilne z systemem iOS.
OTHERS Inne platformy, które nie są wymienione w tym wyliczeniu.

Linia ConsumableTrafficPolyline

Natężenie ruchu na trasie pojazdu.

Pola
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

Ścieżka, którą kierowca pokonuje z poprzedniego punktu na trasie do bieżącego. Ta ścieżka zawiera punkty orientacyjne, aby klienci mogli pokazać znaczniki ruchu wzdłuż niej (patrz speed_reading_interval). Dekodowanie nie jest jeszcze obsługiwane.

CreateTripRequest

Komunikat z prośbą o utworzenie wycieczki.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

trip_id

string

Wymagany. Unikalny identyfikator podróży. Obowiązują następujące ograniczenia:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „','” ani „#”.
trip

Trip

Wymagany. Podróż do utworzenia.

Podczas tworzenia podróży wymagane są te pola:

  • trip_type
  • pickup_point

Te pola będą używane, jeśli je podasz:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Wszystkie pozostałe pola Podróże 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 EXCLUSIVE podróży obsługuje intermediate_destinations.

Gdy ustawisz vehicle_id dla podróży współdzielonej, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów na trasie pojazdu. W przeciwnym razie kolejność punktów pośrednich nie będzie określona.

Jeśli określisz właściwość Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie przejazdu pojazdu bez dodatkowych punktów na trasie. Punkty na trasie należy ustawić w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscem docelowym, a wszystkie miejsca docelowe pośrednie znajdowały się przed punktem zwrotu. Punkty na trasie podróży EXCLUSIVE nie mogą przeplatać się z innymi podróżami.

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

CreateVehicleRequest (Żądanie pojazdu)

CreateVehicle wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Wymagany. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „','” ani „#”.
vehicle

Vehicle

Wymagany. Element Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić 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 są używane, jeśli zostały podane.

Ustawienia urządzenia

Informacje o różnych ustawieniach na urządzeniu mobilnym.

Pola
location_power_save_mode

LocationPowerSaveMode

Sposób działania funkcji lokalizacji na urządzeniu po włączeniu oszczędzania baterii.

is_power_save_mode

bool

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

is_interactive

bool

Określa, czy urządzenie jest w trybie interakcji.

battery_info

BatteryInfo

Informacje o stanie baterii.

GetTripRequest

Komunikat z żądaniem GetTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

view

TripView

Podzbiór pól podróży, które powinny zostać zwrócone, oraz ich interpretacja.

current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane Trip.route lub Trip.current_route_segment. Jeśli dane trasy nie zmieniły się od tej sygnatury czasowej, pole trasy nie zostanie ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane trasy są zawsze pobierane.

remaining_waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której pobierane są elementy Trip.remaining_waypoints. Jeśli od tej sygnatury czasowej się nie zmieniły, w odpowiedzi nie ustawiono parametru remaining_waypoints. Jeśli to pole nie jest określone, pole remaining_waypoints jest zawsze pobierane.

route_format_type

PolylineFormatType

Zwrócony aktualny format trasy, LAT_LNG_LIST_TYPE (w Trip.route) lub ENCODED_POLYLINE_TYPE (w Trip.current_route_segment). Wartość domyślna to LAT_LNG_LIST_TYPE.

current_route_segment_traffic_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której element Trip.current_route_segment_traffic został pobrany. Jeśli dane o ruchu nie zmieniły się od tej sygnatury czasowej, pole current_route_segment_traffic nie zostało ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane o ruchu są zawsze pobierane. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usługi Przejazdy na żądanie i Dostawy.

remaining_waypoints_route_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli dane nie zmieniły się od tej sygnatury czasowej, powyższe pola nie zostały ustawione w odpowiedzi. Jeśli remaining_waypoints_route_version nie jest określony, ruch i ścieżka są zawsze pobierane.

Pobieranie żądaniaPojazdu

GetVehicle wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której element Vehicle.current_route_segment został pobrany. Jeśli trasa nie zmieniła się od tej sygnatury czasowej, pole current_route_segment nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, current_route_segment jest zawsze pobierany.

waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane Vehicle.waypoints. Jeśli punkty na drodze nie zmieniły się od tej sygnatury czasowej, w odpowiedzi dane vehicle.waypoints nie zostaną ustawione. Jeśli to pole nie jest określone, pole vehicle.waypoints jest zawsze pobierane.

LicensePlate

Informacje o tablicy rejestracyjnej pojazdu. Aby uniknąć przechowywania informacji umożliwiających identyfikację osoby, wraz z podmiotem przechowywane są tylko minimum informacje o tablicy rejestracyjnej.

Pola
country_code

string

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

last_character

string

Ostatnia cyfra na tablicy rejestracyjnej lub „-1” oznacza, że na tablicy nie ma żadnej wartości liczbowej.

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

Wyświetlanie żądań pojazdów

ListVehicles wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

page_size

int32

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

page_token

string

Wartość parametru next_page_token podana w wyniku poprzedniego wywołania metody ListVehicles, pozwalająca podzielić grupy pojazdów na strony. Wartość jest nieokreślona, jeśli kryteria filtrowania w żądaniu różnią się od kryteriów filtrowania w poprzednim wywołaniu funkcji ListVehicles.

minimum_capacity

Int32Value

Określa wymaganą minimalną pojemność pojazdu. Wszystkie zwracane pojazdy będą miały maximum_capacity większe lub równe tej wartości. Wartość musi być większa lub równa 0.

trip_types[]

TripType

Ogranicza odpowiedź do pojazdów, które obsługują co najmniej jeden z określonych typów podróży.

maximum_staleness

Duration

Ogranicza odpowiedź do pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Stacjonarne pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli występuje, to musi być prawidłową wartością dodatnią.

vehicle_type_categories[]

Category

Wymagany. Ogranicza odpowiedź do pojazdów z jednej ze wskazanych kategorii. UNKNOWN – to jest niedozwolone.

required_attributes[]

string

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

required_attributes jest listą, a required_one_of_attributes używa wiadomości, która umożliwia użycie listy. W połączeniu te 2 pola umożliwiają tworzenie 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 połączeniem/ORAZ. Maksymalna dozwolona liczba atrybutów_wymaganych to 50. Ta wartość odpowiada maksymalnej liczbie atrybutów dozwolonych w pojeździe. Każdy powtórzony ciąg powinien mieć format „klucz:wartość”.

required_one_of_attributes[]

string

Ogranicza odpowiedź do pojazdów, które w każdym elemencie VehicleAttributeList mają co najmniej 1 z określonych atrybutów. Pojazd musi pasować do co najmniej jednego z atrybutów na każdej liście. To pole jest uwzględnioną operacją łączenia/LUB w każdym z tych elementów: VehicleAttributeList i operacją spójną/ORAZ w zbiorze pola VehicleAttributeList. Każdy powtarzany ciąg powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets oferuje dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, required_one_of_attribute_sets używa komunikatu, który zezwala na listę list i zezwala na wyrażenia takie jak ta:

(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 pasujących do wszystkich atrybutów w VehicleAttributeList. Pojazd z każdej listy musi pasować do wszystkich atrybutów. To pole jest operacją spójną/ORAZ w każdym elemencie VehicleAttributeList i uwzględniającą operację oddzielenia/LUB w zbiorze danych VehicleAttributeList. Każdy powtarzany ciąg powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

vehicle_state

VehicleState

Ogranicza odpowiedź do pojazdów z tym stanem pojazdu.

on_trip_only

bool

Zwracaj tylko pojazdy związane z bieżącą podróżą.

filter

string

Opcjonalnie. Zapytanie o filtr, który ma być stosowany przy wyświetlaniu informacji o pojazdach. Przykłady składni filtra znajdziesz na http://aip.dev/160.

To pole zastępuje pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podana jest wartość, która nie jest pusta, pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets muszą być puste.

Ten filtr działa jako klauzula AND z innymi ograniczeniami, takimi jak 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.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami atrybutów są porównania ciągów znaków. Aby możliwe było porównanie z wartościami liczbowymi lub logicznymi, wartości muszą być wyraźnie ujęte w cudzysłów (np. attributes.<key> = "10" lub attributes.<key> = "true").

viewport

Viewport

Opcjonalnie. Filtr, który ogranicza zwracane pojazdy do tych, których ostatnią znaną lokalizację znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze.

Wyświetlanie odpowiedzi o pojazdach

ListVehicles wiadomość z odpowiedzią.

Pola
vehicles[]

Vehicle

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

next_page_token

string

Token pobierania następnej strony pojazdów lub pusty, jeśli nie ma więcej pojazdów spełniających kryteria żądania.

total_size

int64

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

Tryb oszczędzania energii lokalizacji

Jak są skonfigurowane funkcje lokalizacji na urządzeniu mobilnym, gdy jest na nim włączona funkcja „Oszczędzanie baterii”. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Wartości w polu enum
UNKNOWN_LOCATION_POWER_SAVE_MODE Niezdefiniowany tryb oszczędzania energii lokalizacji
LOCATION_MODE_NO_CHANGE Oszczędzanie baterii nie powinno mieć wpływu na dostawców lokalizacji lub jest wyłączone.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Dostawca lokalizacji oparty na GPS powinien być wyłączony, gdy oszczędzanie baterii jest włączone, a urządzenie nie jest interaktywne.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Gdy oszczędzanie baterii jest włączone, a urządzenie nie jest interaktywne, wszyscy dostawcy lokalizacji powinni być wyłączeni.
LOCATION_MODE_FOREGROUND_ONLY Wszyscy dostawcy usług lokalizacyjnych pozostaną dostępni, ale poprawki lokalizacji należy udostępniać tylko aplikacjom działającym na pierwszym planie.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokalizacja nie zostanie wyłączona, ale Menedżer lokalizacji ograniczy wszystkie żądania wysyłane do dostawców, gdy urządzenie nie jest interaktywne.

Czujnik lokalizacji

Czujnik lub metodologia użyta do określenia lokalizacji.

Wartości w polu enum
UNKNOWN_SENSOR Czujnik jest nieokreślony lub nieznany.
GPS GPS lub wspomagany GPS.
NETWORK Wspomagany GPS, identyfikator stacji bazowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej lub punktu dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobna pozycja na drodze.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zazwyczaj ta wartość jest używana w przypadku lokalizacji pochodzących ze źródeł innych niż urządzenie mobilne, na którym działa pakiet SDK sterownika. Jeśli pierwotne źródło jest opisane przez jedną z pozostałych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle dostarczane za pomocą: last_location.supplemental_location_sensor pojazdu.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych dla niej sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli zostanie odebrana w żądaniu.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji na Androidzie.
CORE_LOCATION Dostawca lokalizacji w systemach operacyjnych Apple.

Stan nawigacji pojazdu.

Wartości w polu enum
UNKNOWN_NAVIGATION_STATUS Nieokreślony stan nawigacji.
NO_GUIDANCE Nawigacja w aplikacji Kierowca jest w trybie FREE_NAV.
ENROUTE_TO_DESTINATION Nawigacja zakręt po zakręcie jest dostępna, a nawigacja w aplikacji kierowcy działa w trybie GUIDED_NAV.
OFF_ROUTE Pojazd zjechał z sugerowanej trasy.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.

Typ formatu łamanego

Typ formatu linii łamanej.

Wartości w polu enum
UNKNOWN_FORMAT_TYPE Format jest nieokreślony lub nieznany.
LAT_LNG_LIST_TYPE Lista google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia łamana zakodowana za pomocą algorytmu kompresji linii łamanej. Dekodowanie nie jest jeszcze obsługiwane.

Źródło zasilania

Typ ładowarki używanej do ładowania baterii.

Wartości w polu enum
UNKNOWN_POWER_SOURCE Nieznane źródło zasilania.
POWER_SOURCE_AC Źródłem zasilania jest ładowarka sieciowa.
POWER_SOURCE_USB Źródło zasilania to port USB.
POWER_SOURCE_WIRELESS Źródło zasilania jest bezprzewodowe.
POWER_SOURCE_UNPLUGGED Bateria jest odłączona.

Żądanie ReportBillableTrip

Komunikat z żądaniem ReportBillableTrip.

Pola
name

string

Wymagany. Musi mieć format providers/{provider}/billableTrips/{billable_trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

country_code

string

Wymagany. Dwuliterowy kod kraju, do którego odbędzie się podróż. Cena jest określona według kodu kraju.

platform

BillingPlatformIdentifier

Platforma, na którą wysłano żądanie.

related_ids[]

string

Identyfikatory bezpośrednio związane z zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) operacji wstępnej rezerwacji, które zostały wykonane, zanim identyfikator podróży jest dostępny. Liczba wartości related_ids jest ograniczona do 50.

solution_type

SolutionType

Typ rozwiązania GMP (np. ON_DEMAND_RIDESHARING_AND_DELIVERIES), które jest używane w przypadku zgłoszonej podróży.

Typ rozwiązania

Selektor różnych typów rozwiązań zgłoszonych podczas podróży.

Wartości w polu enum
SOLUTION_TYPE_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie używał ON_DEMAND_RIDESHARING_AND_DELIVERIES, czyli pierwszego obsługiwanego typu rozwiązania.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Rozwiązaniem jest transport na żądanie z dostawą.

Nagłówek żądania

Element RequestHeader zawiera pola wspólne dla wszystkich żądań RPC Fleet Engine.

Pola
language_code

string

Kod języka 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ślisz żadnej nazwy, odpowiedź może być w dowolnym języku. W przypadku takiej nazwy odpowiedź będzie preferowana w języku angielskim. Przykład wartości pola: en-US.

region_code

string

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

sdk_version

string

Wersja pakietu SDK wywołującego (w stosownych przypadkach). Format wersji to „major.podrzędna.poprawka”, na przykład: 1.1.2.

os_version

string

Wersja systemu operacyjnego, w którym działa wywołujący pakiet SDK. Przykładowe wartości pól: 4.4.1, 12.1.

device_model

string

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

sdk_type

SdkType

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

maps_sdk_version

string

Wersja pakietu MapSDK, od której zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „major.podrzędna.poprawka”, na przykład: 5.2.1.

nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „major.podrzędna.poprawka”, na przykład: 2.1.0.

platform

Platform

Platforma wywołującego SDK.

manufacturer

string

Producent urządzenia z Androidem z pakietu SDK do wywoływania. Dotyczy tylko pakietów SDK na Androida. Przykład wartości pola: Samsung.

android_api_level

int32

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

Platforma

Platforma wywołującego SDK.

Wartości w polu enum
PLATFORM_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli platforma została pominięta.
ANDROID Żądanie pochodzi z Androida.
IOS Żądanie pochodzi z iOS.
WEB Żądanie pochodzi z internetu.

Typ pakietu SDK

Możliwe typy pakietów SDK.

Wartości w polu enum
SDK_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli pominięto sdk_type.
CONSUMER Wywołujący pakiet SDK to konsument.
DRIVER Pakiet SDK do wywoływania to sterownik.
JAVASCRIPT Pakiet SDK wywołujący to JavaScript.

Żądanie SearchTrips

Wiadomość z prośbą SearchTrips.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Pojazd powiązany z podróżami w żądaniu. Jeśli nie określono inaczej, zwrócone podróże nie zawierają:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Jeśli ma wartość Prawda, odpowiedź obejmuje podróże, które wpływają na trasę kierowcy.

page_size

int32

Jeśli zasada nie jest skonfigurowana, serwer określa liczbę wyników do zwrócenia.

page_token

string

Aby kontynuować od poprzednich wyników, wpisz tutaj wartość zwrócona wcześniej w polu SearchTripsResponse.

minimum_staleness

Duration

Jeśli jest określony, zwraca podróże, które nie zostały zaktualizowane po czasie (current - minimum_staleness).

Odpowiedź wyszukiwania

Komunikat z odpowiedzią SearchTrips.

Pola
trips[]

Trip

Lista przejazdów żądanym pojazdem.

next_page_token

string

Przekaż ten token w żądaniu SearchTripsRequest do strony wyników listy. Interfejs API zwraca listę podróży przy każdym wywołaniu, a gdy nie ma więcej wyników, lista podróży jest pusta.

Żądanie wyszukiwania pojazdów

SearchVehicles wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

pickup_point

TerminalLocation

Wymagany. Punkt odbioru, który chcesz wyszukać.

dropoff_point

TerminalLocation

Zamierzone miejsce docelowe zwrotu kosztów przez klienta. To pole jest wymagane, jeśli trip_types zawiera wartość TripType.SHARED.

pickup_radius_meters

int32

Wymagany. Określa promień wyszukiwania pojazdu wokół punktu odbioru. Zwrócone zostaną tylko pojazdy znajdujące się w określonym promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie).

count

int32

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

minimum_capacity

int32

Wymagany. Określa liczbę pasażerów uwzględnianych podczas podróży. Wartość nie może być mniejsza niż 1. Kierowca nie jest brany pod uwagę przy określaniu pojemności.

trip_types[]

TripType

Wymagany. Określa typ proponowanej podróży. Kwalifikujące się pojazdy to takie, które mogą obsłużyć co najmniej 1 z określonych typów podróży.

EXCLUSIVE i SHARED mogą nie zostać uwzględnione razem. Pole SHARED nie jest obsługiwane, gdy current_trips_present ma wartość CURRENT_TRIPS_PRESENT_UNSPECIFIED. Element UNKNOWN_TRIP_TYPE jest niedozwolony.

maximum_staleness

Duration

Ogranicza wyszukiwanie tylko do tych pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Stacjonarne pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli to pole nie zostanie ustawione, serwer użyje wartości domyślnej 5 minut.

vehicle_types[]

VehicleType

Wymagany. Ogranicza wyszukiwanie do pojazdów określonego typu. Musisz określić co najmniej jeden typ pojazdu. Obiekty VehicleType z kategorii UNKNOWN są niedozwolone.

required_attributes[]

VehicleAttribute

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

required_attributes jest listą, a required_one_of_attributes używa wiadomości, która umożliwia użycie listy. W połączeniu te 2 pola umożliwiają tworzenie 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 tych pojazdów o określonych atrybutach. To pole jest połączeniem/ORAZ. Maksymalna dozwolona liczba atrybutów_wymaganych to 50. Ta wartość odpowiada maksymalnej liczbie atrybutów dozwolonych w pojeździe.

required_one_of_attributes[]

VehicleAttributeList

Ogranicza wyszukiwanie tylko do pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym atrybucie VehicleAttributeList. Pojazd musi pasować do co najmniej jednego z atrybutów na każdej liście. To pole jest uwzględnioną operacją łączenia/LUB w każdym z tych elementów: VehicleAttributeList i operacją spójną/ORAZ w zbiorze pola VehicleAttributeList.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets oferuje dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, required_one_of_attribute_sets używa komunikatu, który zezwala na listę list i zezwala na wyrażenia takie jak ta:

(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 grupie VehicleAttributeList. Pojazd z każdej listy musi pasować do wszystkich atrybutów. To pole jest operacją spójną/ORAZ w każdym elemencie VehicleAttributeList i uwzględniającą operację oddzielenia/LUB w zbiorze danych VehicleAttributeList.

order_by

VehicleMatchOrder

Wymagany. Określa żądane kryterium kolejności wyników.

include_back_to_back

bool

Wskazuje, czy pojazd z jedną aktywną podróżą kwalifikuje się do kolejnego dopasowania. Jeśli ustawiona jest wartość false, pojazdy z przypisanymi podróżami są wykluczone z wyników wyszukiwania. Jeśli ustawiona jest wartość true, wyniki wyszukiwania obejmują pojazdy z TripStatus o wartości ENROUTE_TO_DROPOFF.

To pole jest uwzględniane tylko wtedy, gdy określono pojedynczy element trip_type z EXCLUSIVE.

Wartością domyślną jest false.

trip_id

string

Wskazuje podróż powiązaną z tym obiektem (SearchVehicleRequest).

current_trips_present

CurrentTripsPresent

Ogranicza wyświetlanie pojazdów w wynikach wyszukiwania na podstawie ich bieżących tras.

Gdy parametr current_trips_present ma wartość NONE lub ANY, trip_types może mieć wartość EXCLUSIVE lub SHARED, ale nie obie te wartości.

filter

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane podczas wyszukiwania pojazdów. Przykłady składni filtra znajdziesz na http://aip.dev/160.

To pole zastępuje pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podana jest wartość, która nie jest pusta, pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets muszą być puste.

Ten filtr działa jako klauzula AND z innymi ograniczeniami, takimi jak 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.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami atrybutów są porównania ciągów znaków. Aby możliwe było porównanie z wartościami liczbowymi lub logicznymi, wartości muszą być wyraźnie ujęte w cudzysłów (np. attributes.<key> = "10" lub attributes.<key> = "true").

BieżącePodróże

Określa typy ograniczeń związanych z bieżącą podróżą pojazdu.

Wartości w polu enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Tylko pojazdy bez podróży mogą wyświetlać się w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji. Więcej informacji znajdziesz we fladze include_back_to_back.
NONE Pojazdy bez podróży mogą się wyświetlać w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji.
ANY Pojazdy z maksymalnie 5 aktualnymi trasami i 10 punktami pośrednimi są uwzględniane w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji.

Zamówienie_dopasowania pojazdu

Określa kolejność pojazdów w odpowiedzi.

Wartości w polu enum
UNKNOWN_VEHICLE_MATCH_ORDER Domyślne używane w przypadku nieokreślonych lub nierozpoznanych pojazdów pasuje do zamówienia.
PICKUP_POINT_ETA Rosnąco według czasu jazdy pojazdu do punktu odbioru.
PICKUP_POINT_DISTANCE Kolejność rosnąca według odległości jazdy samochodem do punktu odbioru.
DROPOFF_POINT_ETA Rosnąco według czasu jazdy pojazdu do miejsca zwrotu. Tego zamówienia można użyć tylko wtedy, gdy w żądaniu określono punkt zwrotu.
PICKUP_POINT_STRAIGHT_DISTANCE Rosnąco według odległości w prostej linii od ostatniej zgłoszonej lokalizacji pojazdu do punktu odbioru.
COST W kolejności rosnącej według skonfigurowanego kosztu dopasowania. Koszt dopasowania to ważone obliczenie odległości między odległość w linii a szacowanym czasem dotarcia. Wagi są ustawione na wartości domyślne i można je zmieniać dla poszczególnych klientów. Jeśli chcesz zmienić te wagi w projekcie, skontaktuj się z zespołem pomocy Google.

Odpowiedź z wyszukiwarki pojazdów

SearchVehicles wiadomość z odpowiedzią.

Pola
matches[]

VehicleMatch

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

SpeedReadingInterval

Wskaźnik natężenia ruchu na sąsiednim fragmencie ścieżki. Przy założeniu ścieżki z punktami P_0, P_1, ... , P_N (indeks liczony od zera) parametr SpeedReadingInterval definiuje odstęp i opisuje ruch za pomocą następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału na ścieżce. W formacie JSON, gdy indeks ma wartość 0, pole będzie puste.

end_polyline_point_index

int32

Indeks końcowy tego przedziału na ścieżce. W formacie JSON, gdy indeks ma wartość 0, pole będzie puste.

speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja szybkości linii łamanej na podstawie danych o ruchu.

Wartości w polu enum
SPEED_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NORMAL Normalna prędkość, nie wykryto opóźnienia.
SLOW Wykryto korek, ale nie utworzono korka.
TRAFFIC_JAM Wykryto korek.

Lokalizacja zatrzymania

Rzeczywista lokalizacja, w której nastąpił przystanek (odbiór/zwrot).

Pola
point

LatLng

Wymagany. Wskazuje rzeczywistą lokalizację.

timestamp

Timestamp

Wskazuje, kiedy miał miejsce postój.

stop_time
(deprecated)

Timestamp

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

Lokalizacja terminalu

Opisuje lokalizację punktu pośredniego.

Pola
point

LatLng

Wymagany. Wskazuje lokalizację punktu na trasie podróży.

terminal_point_id

TerminalPointId

Identyfikator punktu końcowego.

access_point_id
(deprecated)

string

Rola wycofana.

trip_id
(deprecated)

string

Rola wycofana.

terminal_location_type
(deprecated)

WaypointType

Wycofane: te dane będą zawierać te dane: Vehicle.waypoint.

Identyfikator punktu końcowego

Określa punkt końcowy.

Pola
value

string

Unikalny identyfikator punktu końcowego.

Pole Unii Id. Rola wycofana. Id może mieć tylko jedną z tych wartości:
place_id
(deprecated)

string

Rola wycofana.

generated_id
(deprecated)

string

Rola wycofana.

Dane Polyline Ruchu

Informacje o warunkach drogowych na oczekiwanej trasie pojazdu.

Pola
traffic_rendering

VisualTrafficReportPolylineRendering

Renderowanie liniowe pokazujące szybkość ruchu we wszystkich regionach na jednym odcinku przejazdu klienta.

Podróż

Metadane podróży.

Pola
name

string

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

vehicle_id

string

Identyfikator pojazdu w tej podróży.

trip_status

TripStatus

Aktualny stan podróży.

trip_type

TripType

Rodzaj podróży.

pickup_point

TerminalLocation

Miejsce, w którym klient wskazuje, że zostanie odebrany.

actual_pickup_point

StopLocation

Tylko dane wejściowe. Rzeczywiste miejsce i czas odbioru klienta. To pole służy dostawcy do przesyłania opinii na temat rzeczywistych informacji o odbiorze.

actual_pickup_arrival_point

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja przyjazdu kierowcy do punktu odbioru. To pole służy do przesyłania opinii o faktycznym przybyciu do punktu odbioru.

pickup_time

Timestamp

Tylko dane wyjściowe. Szacowana godzina odjazdu pasażera lub rzeczywista godzina, o której go odebrano.

intermediate_destinations[]

TerminalLocation

Przerwy pośrednie w kolejności, w jakiej zgłaszają się prośby o podróż (a nie tylko w przypadku odbioru i dostawy). Początkowo ta funkcja nie będzie dostępna w przypadku wspólnych podróży.

intermediate_destinations_version

Timestamp

Wskazuje czas ostatniej modyfikacji obiektu intermediate_destinations. Twój serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w elemencie UpdateTripRequest przy aktualizacji intermediate_destination_index, aby upewnić się, że wartość intermediate_destinations nie została zmieniona.

intermediate_destination_index

int32

Gdy TripStatus ma wartość ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu od [0..N-1] wskazująca do kolejnego miejsca docelowego, przez które pojazd przejedzie. Gdy TripStatus to ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca, w którym miejscu docelowym pośrednim znajduje się pojazd. Dostawca ustawia tę wartość. Jeśli nie ma wartości intermediate_destinations, to pole jest ignorowane.

actual_intermediate_destination_arrival_points[]

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja przyjazdu kierowcy do pośredniego miejsca docelowego. To pole służy do przesyłania opinii o faktycznym przybyciu do miejsc pośrednich.

actual_intermediate_destinations[]

StopLocation

Tylko dane wejściowe. Rzeczywiste miejsce i czas odebrania klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przesyłania opinii o rzeczywistych informacjach o odbiorze w miejscach docelowych pośrednich.

dropoff_point

TerminalLocation

Miejsce, w którym klient wskazuje, że zostanie porzucony.

actual_dropoff_point

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i miejsce wysyłki klienta. To pole służy do przesyłania opinii na temat rzeczywistych informacji o wysyłce klienta.

dropoff_time

Timestamp

Tylko dane wyjściowe. Przewidywana przyszła godzina, o której pasażerowie wysiądą na miejscu docelowym, lub rzeczywista godzina, o której wysiądzie.

remaining_waypoints[]

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka od bieżącej lokalizacji do punktu docelowego włącznie. Ścieżka może obejmować punkty na innych trasach.

vehicle_waypoints[]

TripWaypoint

To pole umożliwia ręczne porządkowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty na trasie przypisanego do pojazdu, a także punkty na drodze do miejsca odbioru i miejsca wysyłki. Jeśli podróż nie została przypisana do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane tylko przez serwer w wywołaniach UpdateTrip i CreateTrip, a nie w przypadku wywołań GetTrip.

route[]

LatLng

Tylko dane wyjściowe. Przewidywana trasa tej podróży do pierwszego wejścia w pozostałych punktach pośrednich. Pierwszy punkt może należeć do innej podróży.

current_route_segment

string

Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu na trasie.

Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

current_route_segment_version

Timestamp

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

Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK.

current_route_segment_traffic

ConsumableTrafficPolyline

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

Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK.

current_route_segment_traffic_version

Timestamp

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

Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK.

current_route_segment_end_point

TripWaypoint

Tylko dane wyjściowe. Punkt na trasie, w którym kończy się trasa current_route_segment.

remaining_distance_meters

Int32Value

Tylko dane wyjściowe. Pozostały dystans w polu current_route_segment. Wartość nie jest określona, jeśli podróż nie została przypisana do pojazdu albo została zakończona lub anulowana.

eta_to_first_waypoint

Timestamp

Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu remaining_waypoints). Wartość nie jest określona, jeśli podróż nie jest przypisana do pojazdu lub podróż jest nieaktywna (ukończona lub anulowana).

remaining_time_to_first_waypoint

Duration

Tylko dane wyjściowe. Czas od zwrócenia danych dotyczących podróży do czasu w lokalizacji Trip.eta_to_first_waypoint. Wartość nie jest określona, jeśli podróż nie jest przypisana do pojazdu lub podróż jest nieaktywna (ukończona lub anulowana).

remaining_waypoints_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatni raz został zmieniony remaining_waypoints (punkt pośredni został dodany, usunięty lub zmieniony).

remaining_waypoints_route_version

Timestamp

Tylko dane wyjściowe. Wskazuje ostatnią zmianę atrybutów remaining_waypoints.path_to_waypoint i remaining_waypoints.traffic_to_waypoint. Aplikacja kliencka powinna buforować tę wartość i przekazywać ją w obiekcie GetTripRequest, aby mieć pewność, że ścieżki i ruch dla remaining_waypoints będą zwracane tylko po zaktualizowaniu.

number_of_passengers

int32

Stała. Wskazuje liczbę pasażerów w ramach tej podróży (nie obejmuje kierowcy). Pojazd musi mieć dostępną pojemność, aby można było zwrócić go w odpowiedzi SearchVehicles.

last_location

VehicleLocation

Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie.

last_location_snappable

bool

Tylko dane wyjściowe. Wskazuje, czy element last_location pojazdu można przyciągnąć do bieżącego_segmentu_trasy. Wartość fałsz, jeśli last_location lub current_route_segment nie istnieje. Oblicza ją Fleet Engine. Wszelkie aktualizacje od klientów zostaną zignorowane.

view

TripView

Podzbiór pól Podróż, które są wypełnione i jak powinny być interpretowane.

Stan podróży

Stan podróży wskazujący jej postęp.

Wartości w polu enum
UNKNOWN_TRIP_STATUS Domyślny, używany w przypadku nieokreślonego lub nierozpoznanego stanu podróży.
NEW Nowo utworzona podróż.
ENROUTE_TO_PICKUP Kierowca jest w drodze do punktu odbioru.
ARRIVED_AT_PICKUP Kierowca dotarł do punktu odbioru.
ARRIVED_AT_INTERMEDIATE_DESTINATION Kierowca dotarł do pośredniego miejsca docelowego i czeka na pasażera.
ENROUTE_TO_INTERMEDIATE_DESTINATION Kierowca jest w drodze do pośredniego miejsca docelowego (nie do miejsca docelowego).
ENROUTE_TO_DROPOFF Kierowca odebrał pasażera i jedzie do następnego miejsca docelowego.
COMPLETE Pasażer został wysadzony i podróż się zakończyła.
CANCELED podróż została anulowana przed odebraniem przez kierowcę, pasażera lub firmę oferującą wspólne przejazdy.

Typ podróży

Rodzaj podróży.

Wartości w polu enum
UNKNOWN_TRIP_TYPE Domyślne używane w przypadku nieokreślonych lub nierozpoznanych typów podróży.
SHARED W czasie podróży pojazd może być współużytkowany z innymi podróżami.
EXCLUSIVE Podróż obejmuje tylko pojazd.

Widok TripView

Selektor różnych zestawów pól Podróż w odpowiedzi GetTrip. Kontekst znajdziesz na stronie AIP-157. Prawdopodobnie dodamy więcej widoków danych.

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie wyświetlać widok pakietu SDK. Aby zapewnić stabilność i wsparcie, zalecamy klientom wybranie atrybutu TripView innego niż SDK.
SDK Obejmuje pola, których nie można interpretować lub obsługiwać przy użyciu publicznie dostępnych bibliotek.
JOURNEY_SHARING_V1S Pola podróży są wypełniane na potrzeby funkcji udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

Punkt na trasie TripWaypoint

Opisuje punkt zatrzymania na trasie pojazdu lub punkt końcowy na trasie pojazdu.

Pola
location

TerminalLocation

Lokalizacja tego punktu na trasie.

trip_id

string

Podróż powiązana z tym punktem pośrednim.

waypoint_type

WaypointType

Rola, jaką punkt pośredni odgrywa podczas podróży, np. odbiór lub przyjazd.

path_to_waypoint[]

LatLng

Ścieżka od poprzedniego punktu do bieżącego. Nieokreślony dla pierwszego punktu pośredniego na liście. To pole jest wypełniane tylko na żądanie.

encoded_path_to_waypoint

string

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

Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

traffic_to_waypoint

ConsumableTrafficPolyline

Informacje o warunkach na drodze do tego punktu. Pamiętaj, że informacje o ruchu są dostępne tylko dla klientów korzystających z rozwiązania do obsługi Przejazdów i dostaw w Google Map Platform.

distance_meters

Int32Value

Odległość na ścieżce od poprzedniego punktu do bieżącego. Nieokreślony dla pierwszego punktu pośredniego na liście.

eta

Timestamp

Szacowana godzina dotarcia do tego punktu pośredniego. Nieokreślony dla pierwszego punktu pośredniego na liście.

duration

Duration

Czas podróży z poprzedniego punktu na trasie do tego punktu. Nieokreślony dla pierwszego punktu pośredniego na liście.

Żądanie aktualizacjiTripRequest

Komunikat z prośbą o aktualizacjęTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-consumer-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

trip

Trip

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

Poniższe 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 dla udostępnionej podróży, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów na trasie. W przeciwnym razie ich kolejność będzie nieokreślona.

Jeśli określisz właściwość Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie przejazdu pojazdu bez dodatkowych punktów na trasie. Punkty na trasie należy ustawić w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscem docelowym, a wszystkie miejsca docelowe pośrednie znajdowały się przed punktem zwrotu. Punkty na trasie podróży EXCLUSIVE nie mogą przeplatać się z innymi podróżami. Używane są pola trip_id, waypoint_type i location, a wszystkie pozostałe pola TripWaypoint w vehicle_waypoints są ignorowane.

Aby uniknąć spełnienia warunków wyścigu w przypadku podróży obejmujących wiele miejsc docelowych, podczas aktualizowania stanu podróży na ENROUTE_TO_INTERMEDIATE_DESTINATION podaj Trip.intermediate_destinations_version. Przekazana wartość Trip.intermediate_destinations_version musi być zgodna z wersją Fleet Engine. Jeśli tak nie jest, żądanie się nie powiedzie.

update_mask

FieldMask

Wymagany. Maska pola wskazująca pola do zaktualizowania w Podróżu. Pole update_mask musi zawierać co najmniej jedno pole.

Żądanie UpdateVehicleAttributesRequest

UpdateVehicleAttributes wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

attributes[]

VehicleAttribute

Wymagany. Atrybuty pojazdu do zaktualizowania. Niewymienione atrybuty nie są zmieniane ani usuwane.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes wiadomość z odpowiedzią.

Pola
attributes[]

VehicleAttribute

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

Żądanie aktualizacji lokalizacji pojazdu

UpdateVehicleLocation wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. {provider} musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego częścią jest konto usługi wywołujące to wywołanie.

current_location

VehicleLocation

Wymagany. Najnowsza lokalizacja pojazdu. Pola podrzędne location i update_time są wymagane.

current_state

VehicleState

Ustaw stan pojazdu na ONLINE lub OFFLINE. Jeśli ma wartość UNKNOWN_VEHICLE_STATE, stan pojazdu się nie zmieni.

Żądanie aktualizacji pojazdu

Komunikat żądania UpdateVehicle.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

Wymagany. Musi mieć format providers/{provider}/vehicles/{vehicle}. {provider} musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego częścią jest konto usługi wywołujące to wywołanie.

vehicle

Vehicle

Wymagany. Wartości encji Vehicle do zastosowania. Podczas aktualizowania pola Vehicle podane niżej pola mogą nie zostać zaktualizowane, ponieważ są 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że zostać zaktualizowane, ale musi zawierać wszystkie punkty na trasie znajdujące się obecnie na pojeździe, bez żadnych innych punktów na trasie.

update_mask

FieldMask

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

Pojazd

Metadane pojazdu.

Pola
name

string

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

vehicle_state

VehicleState

Stan pojazdu.

supported_trip_types[]

TripType

Rodzaje podróży obsługiwane przez ten pojazd.

current_trips[]

string

Tylko dane wyjściowe. Lista użytkowników trip_id na potrzeby podróży obecnie przypisanych do tego pojazdu.

last_location

VehicleLocation

Ostatni raport o lokalizacji pojazdu.

maximum_capacity

int32

Łączna liczba pasażerów tego pojazdu. Ta wartość nie uwzględnia kierowcy. Ta wartość nie może być mniejsza niż 1.

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

Wymagany. Typ pojazdu. Pozwala filtrować pojazdy w SearchVehicles wynikach. Wpływa też na obliczanie szacowanego czasu dotarcia i trasy.

license_plate

LicensePlate

Informacje o tablicach rejestracyjnych pojazdu.

route[]
(deprecated)

TerminalLocation

Wycofane: użyj atrybutu Vehicle.waypoints.

current_route_segment

string

Linia łamana wskazująca trasę, którą aplikacja kierowcy ma pojechać do następnego punktu na trasie. Ta lista jest też zwracana w Trip.current_route_segment w przypadku wszystkich aktywnych podróży przypisanych do pojazdu.

Uwaga: to pole jest przeznaczone wyłącznie do użycia przez pakiet Driver SDK. Dekodowanie nie jest jeszcze obsługiwane.

current_route_segment_traffic

TrafficPolylineData

Tylko dane wejściowe. Fleet Engine wykorzystuje te informacje do ulepszania udostępniania podróży. Uwaga: to pole jest przeznaczone wyłącznie do użycia przez pakiet Driver SDK.

current_route_segment_version

Timestamp

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

current_route_segment_end_point

TripWaypoint

Punkt na trasie, w którym kończy się trasa current_route_segment. Te dane mogą być podawane przez kierowców w przypadku połączeń UpdateVehicle jako pełny punkt pośredni, punkt pośredni LatLng lub jako ostatni LatLng dla current_route_segment. Jeśli nie zostanie on w pełni zdefiniowany, Fleet Engine dołoży wszelkich starań, aby interpolować go do rzeczywistego punktu pośredniego. To pole jest ignorowane w wywołaniach funkcji UpdateVehicle, chyba że określono również current_route_segment.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Szacowany czas dotarcia do pierwszego wpisu w polu waypoints. Wartość nie jest określona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste.

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

remaining_time_seconds

Int32Value

Tylko dane wejściowe. Pozostały czas jazdy samochodem: current_route_segment. Wartość nie jest określona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste. Ta wartość powinna pasować do zakresu eta_to_first_waypointcurrent_time, jeśli wszystkie grupy używają tego samego zegara.

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

waypoints[]

TripWaypoint

Pozostałe punkty na trasie przypisane do tego pojazdu.

waypoints_version

Timestamp

Tylko dane wyjściowe. Ostatnia aktualizacja pola waypoints. Klienci powinni buforować tę wartość i przekazywać ją w obiekcie GetVehicleRequest, aby mieć pewność, że pole waypoints zostanie zwrócone tylko wtedy, gdy zostanie zaktualizowane.

back_to_back_enabled

bool

Wskazuje, czy kierowca akceptuje podróże z powrotem. Jeśli true, SearchVehicles może uwzględnić pojazd, nawet jeśli jest on obecnie przypisany do podróży. Wartością domyślną jest false.

navigation_status

NavigationStatus

Stan nawigacji pojazdu.

device_settings

DeviceSettings

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

Typ pojazdu

typ pojazdu,

Pola
category

Category

Kategoria typu pojazdu

Kategoria

Kategorie typów pojazdów

Wartości w polu enum
UNKNOWN Domyślna: używana w przypadku nieokreślonych lub nierozpoznanych kategorii pojazdów.
AUTO Samochód.
TAXI Pojazdy obsługujące taksówki (zwykle licencjonowane lub podlegające regulacjom prawnym).
TRUCK Zwykle jest to samochód o dużej pojemności.
TWO_WHEELER Motocykl, motorower lub inny pojazd dwukołowy
BICYCLE Transport obsługiwany przez ludzi
PEDESTRIAN Pracownik transportu, zazwyczaj idący lub biegający, poruszający się po chodnikach.

Atrybut pojazdu

Opisuje atrybut pojazdu jako para klucz-wartość. Długość ciągu znaków „klucz:wartość” nie może przekraczać 256 znaków.

Pola
key

string

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

value

string

Wartość atrybutu.

Pole Unii vehicle_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. vehicle_attribute_value może mieć tylko jedną z tych wartości:
string_value

string

Wartość atrybutu podana jako ciąg znaków.

Uwaga: to pole jest takie samo jak pole value, które zostanie wkrótce wycofane. W przypadku metod tworzenia lub aktualizacji możesz użyć dowolnego z tych pól, ale zdecydowanie zalecamy użycie właściwości string_value. Jeśli ustawione są zarówno wartości string_value, jak i value, muszą być identyczne. W przeciwnym razie pojawi się błąd. Oba pola są wypełniane w odpowiedziach.

bool_value

bool

Wpisana wartość atrybutu logiczna.

number_value

double

Wpisano dwukrotnie wartość atrybutu.

Lista atrybutów pojazdów

Typ danych listy dla atrybutów pojazdu.

Pola
attributes[]

VehicleAttribute

Lista atrybutów w tej kolekcji.

Lokalizacja pojazdu

Lokalizacja, prędkość i kierunek pojazdu w danym momencie.

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest wysyłany do Fleet Engine, lokalizacja pojazdu jest określana na podstawie GPS-u. Gdy otrzymasz informacje o lokalizacji pojazdu, możesz podać lokalizację pojazdu, na przykład lokalizację GPS, uzupełniającą ją lub inną przybliżoną lokalizację. Źródło jest określone w polu location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu latlng_accuracy.

latlng_accuracy

DoubleValue

Dokładność location w metrach jako promienia.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu heading_accuracy.

heading_accuracy

DoubleValue

Dokładność heading w stopniach.

altitude

DoubleValue

Wysokość w metrach powyżej WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu altitude_accuracy.

altitude_accuracy

DoubleValue

Dokładność altitude w metrach.

speed_kmph
(deprecated)

Int32Value

Prędkość pojazdu w kilometrach na godzinę. Wycofane: użyj atrybutu speed.

speed

DoubleValue

Prędkość pojazdu w metrach/s

speed_accuracy

DoubleValue

Dokładność speed w metrach/s.

update_time

Timestamp

Godzina, o której czujnik location został zgłoszony przez czujnik, zgodnie z jego zegarem.

server_time

Timestamp

Tylko dane wyjściowe. Godzina, o której serwer odebrał informacje o lokalizacji.

location_sensor

LocationSensor

Dostawca danych o lokalizacji (np. GPS).

is_road_snapped

BoolValue

Określa, czy element location jest przyciągnięty do drogi.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

Tylko dane wejściowe. Czas (w sekundach) od wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji ta wartość będzie wynosić 0. Jeśli godzina jest nieznana (na przykład po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do zera.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Lokalizacja nieprzetworzonego pojazdu (nieprzetworzona przez snapper).

raw_location_time

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

raw_location_sensor

LocationSensor

Źródło nieprzetworzonej lokalizacji.

raw_location_accuracy

DoubleValue

Dokładność raw_location jako promienia w metrach.

supplemental_location

LatLng

Dodatkowa lokalizacja udostępniana przez aplikację integracyjną.

supplemental_location_time

Timestamp

Sygnatura czasowa związana z dodatkową lokalizacją.

supplemental_location_sensor

LocationSensor

Źródło dodatkowej lokalizacji.

supplemental_location_accuracy

DoubleValue

Dokładność supplemental_location jako promienia w metrach.

road_snapped
(deprecated)

bool

Wycofane: użyj atrybutu is_road_snapped.

Dopasowanie pojazdów

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

Pola
vehicle

Vehicle

Wymagany. Pojazd pasujący do żądania.

vehicle_pickup_eta

Timestamp

Szacowany czas dotarcia pojazdem do punktu odbioru określonego w żądaniu. Pusta wartość oznacza błąd przy obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli SearchVehiclesRequest.include_back_to_back to true, a pojazd ma aktywną podróż, vehicle_pickup_eta uwzględnia czas potrzebny do ukończenia aktualnej aktywnej podróży.

vehicle_pickup_distance_meters

Int32Value

Odległość od aktualnej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, z uwzględnieniem wszystkich pośrednich punktów odbioru i zwrotu w przypadku dotychczasowych podróży. Ta odległość obejmuje obliczoną odległość (trasę) oraz odległość 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 w obliczaniu odległości.

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

Szacowany czas dotarcia z pełnym pojazdem do punktu zwrotu wskazanego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje postój w dowolnym punkcie na drodze przed dropoff_point określonym w żądaniu. Ta wartość jest wypełniona tylko wtedy, gdy w żądaniu określisz punkt zwrotu. Pusta wartość oznacza błąd podczas obliczania szacowanego czasu dotarcia.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Odległość pojazdu (w metrach) od punktu odbioru do punktu zwrotu określonego w żądaniu. Odległość między dwoma punktami nie obejmuje lokalizacji pojazdu ani żadnych innych miejsc, które trzeba odwiedzić przed przybyciem do punktu odbioru lub miejsca wysyłki. Ta wartość jest wypełniana tylko wtedy, gdy w żądaniu określisz parametr dropoff_point. Pusta wartość oznacza błąd w obliczeniu odległości od punktu odbioru do punktu wysyłki określonego w żądaniu.

trip_type

TripType

Wymagany. Typ podróży w odpowiedzi na żądanie, który został użyty do obliczenia szacowanego czasu dotarcia do punktu odbioru.

vehicle_trips_waypoints[]

Waypoint

Uporządkowana lista punktów pośrednich używanych do obliczenia szacowanego czasu dotarcia. Lista obejmuje lokalizację pojazdu, punkty odbioru aktywnych przejazdów pojazdem i punkty odbioru określone w prośbie. Pusta lista oznacza błąd przy obliczaniu szacowanego czasu dotarcia w przypadku pojazdu.

vehicle_match_type

VehicleMatchType

Dopasowany typ pojazdu.

requested_ordered_by

VehicleMatchOrder

Żądana kolejność sortowania pojazdów.

ordered_by

VehicleMatchOrder

Rzeczywiste zamówienie użyte dla tego pojazdu. Zwykle ta wartość odpowiada polu „order_by” w żądaniu, ale w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, możesz użyć innej metody (np. PICKUP_POINT_STRAIGHT_DISTANCE).

Typ dopasowania pojazdu

Dopasowany typ pojazdu.

Wartości w polu enum
UNKNOWN Nieznany typ dopasowania pojazdu
EXCLUSIVE Pojazd nie ma obecnie przypisanej podróży i może zostać uwzględniony w punkcie odbioru.
BACK_TO_BACK Pojazd jest obecnie przypisany do podróży, ale po jej zakończeniu można dotrzeć do punktu odbioru. W obliczeniach szacowanego czasu dotarcia i odległości bierze się pod uwagę istniejącą podróż.
CARPOOL Pojazd ma wystarczającą pojemność na wspólne przejazdy.
CARPOOL_BACK_TO_BACK Pojazd zakończy swoją bieżącą, aktywną podróż przed przejściem do punktu odbioru. W obliczeniach szacowanego czasu dotarcia i odległości bierze się pod uwagę istniejącą podróż.

VehicleState,

Stan obiektu Vehicle.

Wartości w polu enum
UNKNOWN_VEHICLE_STATE Domyślny używany w przypadku nieokreślonych lub nierozpoznanych stanów pojazdu.
OFFLINE Pojazd nie przyjmuje nowych tras. Uwaga: pojazd może nadal działać w tym stanie podczas wykonywania przypisanej do niego podróży.
ONLINE Pojazd przyjmuje nowe trasy.

VisualTrafficReportPolylineRendering

Opisuje, jak klienci powinni pokolorować jedną część linii łamanej na trasie.

Pola
road_stretch[]

RoadStretch

Opcjonalnie. Odcinki dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia mają pewność, że nie nakładają się na siebie i nie muszą obejmować całej trasy.

Jeśli nie można dodać stylu do drogi, klient powinien zastosować dla trasy ustawienie domyślne.

Rozciąganie

Jeden odcinek drogi do wyrenderowania.

Pola
style

Style

Wymagany. Styl, który chcesz zastosować.

offset_meters

int32

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

length_meters

int32

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

Styl

Styl natężenia ruchu wskazujący prędkość ruchu.

Wartości w polu enum
STYLE_UNSPECIFIED Nie wybrano stylu.
SLOWER_TRAFFIC Ruch zwalnia.
TRAFFIC_JAM Występuje korek.

Punkt pośredni

Opisuje punkty pośrednie na trasie.

Pola
lat_lng

LatLng

Lokalizacja tego punktu na trasie.

eta

Timestamp

Szacowany czas dotarcia pojazdu do tego punktu pośredniego.

Typ punktu pośredniego

Typ punktu pośredniego.

Wartości w polu enum
UNKNOWN_WAYPOINT_TYPE Nieznany lub nieokreślony typ punktu pośredniego.
PICKUP_WAYPOINT_TYPE Punkty pośrednie do odbioru pasażerów lub przedmiotów.
DROP_OFF_WAYPOINT_TYPE Punkty pośrednie umożliwiające rezygnację z podróżujących lub przedmiotów.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie pośrednie podczas podróży z wieloma miejscami docelowymi.