Package maps.fleetengine.v1

Indeks

TripService

Usługa zarządzania podróżami.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Tworzy przejazd w silniku floty i zwraca nowy przejazd.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Informacje o pojedynczej podróży.
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Zgłoś płatne wykorzystanie podróży.
SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Znajdziesz tu wszystkie dane dotyczące podróży konkretnym pojazdem.
UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualizuje dane dotyczące przejazdu.

VehicleService

Zarządzanie pojazdami.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tworzy nowy pojazd powiązany z usługą przewozu osób lub dostaw na żądanie. Każdy Vehicle musi mieć unikalny identyfikator pojazdu.

Podczas tworzenia Vehicle wymagane są te pola Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia Vehicle są ignorowane następujące 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.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Zwraca pojazd z Fleet Engine.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Zwraca listę pojazdów, które pasują do opcji żądania.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Zapisuje zaktualizowane dane pojazdu w Fleet Engine.

Podczas aktualizowania Vehicle nie można zaktualizować tych 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. Pole waypoints również można zaktualizować, ale musi zawierać wszystkie punkty pośrednie znajdujące się obecnie w pojeździe i nie może zawierać żadnych innych punktów.
UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

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

BatteryInfo

Informacje o baterii urządzenia.

Pola
battery_status

BatteryStatus

Stan baterii, czy jest naładowana, czy ładowana itp.
power_source

PowerSource

Stan źródła zasilania baterii.
battery_percentage

float

Bieżąca wartość procentowa baterii [0–100].

BatteryStatus

Stan baterii, stan naładowania, stan naładowania itd.

Wartości w polu enum
UNKNOWN_BATTERY_STATUS Nieznany stan baterii.
BATTERY_STATUS_CHARGING Bateria jest ładowana.
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 Bateria jest słaba.

BillingPlatformIdentifier

Zbiór wartości wskazujących, na której platformie wysłano żądanie.

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

ConsumableTrafficPolyline

Natężenie ruchu na trasie dla pojazdów.

Pola
speed_reading_interval[]

SpeedReadingInterval

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

string

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

CreateTripRequest

Wiadomość z żądaniem CreateTrip.

Pola
header

RequestHeader

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

string

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

Wymagane. Unikalny identyfikator podróży. Z zastrzeżeniem tych ograniczeń:

  • 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

Wymagane. Element podróży do utworzenia.

Podczas tworzenia podróży musisz wypełnić te pola:

  • trip_type
  • pickup_point

Jeśli podasz te pola, zostaną one wykorzystane:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Pozostałe pola dotyczące podróży są ignorowane. Na przykład wszystkie podróże zaczynają się od trip_status o wartości NEW, nawet jeśli w prośbie o utworzenie zdasz trip_status o wartości CANCELED.

Tylko wyjazdy o długości EXCLUSIVE są obsługiwane w przypadku intermediate_destinations.

Jeśli ustawienie vehicle_id jest ustawione dla wspólnej podróży, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów na trasie dla pojazdu. W przeciwnym razie kolejność punktów na trasie nie będzie określona.

Jeśli podasz Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie podróży pojazdu, bez dodatkowych punktów pośrednich. Punkty pośrednie musisz zamówić w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscem docelowym pośrednim, a wszystkie miejsca docelowe pośrednie znajdowały się przed punktem nadania. Punkty na trasie EXCLUSIVE nie mogą przeplatać się z żadnymi innymi podróżami.

Pola trip_id, waypoint_type i location są używane, a pozostałe pola TripWaypoint w polu vehicle_waypoints są ignorowane.

CreateVehicleRequest

CreateVehicle prośba o spotkanie.

Pola
header

RequestHeader

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

string

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

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

  • 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ć tych znaków ASCII: '/', ':', '?', ',' ani '#'.
vehicle

Vehicle

Wymagane. Podmiot Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić te pola:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia pojazdu następujące 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.

DeviceSettings

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

Pola
location_power_save_mode

LocationPowerSaveMode

Jak funkcje lokalizacji działają na urządzeniu po włączeniu oszczędzania baterii.
is_power_save_mode

bool

Określa, czy urządzenie jest w trybie oszczędzania energii.
is_interactive

bool

Wskazuje, czy urządzenie jest w trybie interaktywnym.
battery_info

BatteryInfo

Informacje o stanie baterii.

GetTripRequest

wiadomość z prośbą o wykonanie rezerwacji.

Pola
header

RequestHeader

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

string

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

TripView

Podzbiór pól wyjazdu, które powinny zostać zwrócone, oraz ich interpretacja.
current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane z kategorii Trip.route lub Trip.current_route_segment. Jeśli dane trasy nie zmieniły się od tego sygnatury czasowej, pole route nie jest ustawione w odpowiedzi. Jeśli nie określisz minimalnej wartości, dane trasy będą zawsze pobierane.
remaining_waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są Trip.remaining_waypoints. Jeśli nie zmieniły się od tego momentu, nie są ustawiane w odpowiedzi. Jeśli to pole nie jest określone, pole remaining_waypoints jest zawsze pobierane.
route_format_type

PolylineFormatType

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

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia) dla której pobierana jest wartość Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniły się od tego sygnatury czasowej, pole current_route_segment_traffic nie jest ustawione w odpowiedzi. Jeśli nie zostanie podana wartość minimalna, dane o ruchu są zawsze pobierane. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usług przejazdów na żądanie i usług dostawy.
remaining_waypoints_route_version

Timestamp

Wskazuje minimalny znacznik czasu (wykluczający) dla którego pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli dane nie zmieniły się od tego sygnatury czasowej, powyższe pola nie są ustawione w odpowiedzi. Jeśli nie podasz argumentu remaining_waypoints_route_version, ruch i ścieżka są zawsze pobierane.

GetVehicleRequest

Wiadomość z prośbą: GetVehicle.

Pola
header

RequestHeader

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

string

Wymagane. 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 wykonujące to wywołanie.
current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik Vehicle.current_route_segment. Jeśli od tego momentu trasa nie uległa zmianie, pole current_route_segment nie jest ustawione w odpowiedzi. Jeśli nie określono minimalnej wartości, zawsze pobierana jest wartość current_route_segment.
waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane funkcji Vehicle.waypoints. Jeśli punkty pośrednie nie uległy zmianie od tego sygnatury czasowej, dane vehicle.waypoints nie są ustawione w odpowiedzi. 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ę osób, w ramach danego podmiotu przechowywana jest tylko minimalna ilość informacji na temat tablicy rejestracyjnej.

Pola
country_code

string

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

string

Ostatnia cyfra tablicy rejestracyjnej lub „-1” oznaczająca brak wartości liczbowej na tablicy rejestracyjnej.

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

ListVehiclesRequest

Wiadomość z prośbą: ListVehicles.

Pola
header

RequestHeader

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

string

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

int32

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

string

Wartość pola next_page_token podana w poprzednim wywołaniu funkcji ListVehicles, która umożliwia podział na strony w grupach pojazdów. Wartość jest nieokreślona, jeśli kryteria filtrowania w żądaniu nie są takie same jak kryteria filtrowania poprzedniego wywołania funkcji ListVehicles.
minimum_capacity

Int32Value

Określa wymaganą minimalną pojemność pojazdu. W przypadku wszystkich zwróconych pojazdów wartość maximum_capacity będzie większa lub równa tej wartości. Jeśli jest ustawiona, musi być równa 0 lub większa.
trip_types[]

TripType

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

Duration

Ogranicza odpowiedź do pojazdów, które wysłały do Fleet Engine aktualizacje lokalizacji w określonym czasie. Pojazdy stojące, które nadal przesyłają swoje lokalizacje, nie są uważane za nieaktualne. Jeśli występuje, musi mieć prawidłową wartość dodatnią.
vehicle_type_categories[]

Category

Wymagane. Ogranicza odpowiedź do pojazdów należących do jednej z podanych kategorii typu. UNKNOWN – to jest niedozwolone.
required_attributes[]

string

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

required_attributes to lista; required_one_of_attributes używa wiadomości, która umożliwia utworzenie listy list. Połączenie tych 2 pol pozwala stworzyć to wyrażenie:

(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 spójnikiem/operacją ORAZ. Maksymalna dozwolona liczba atrybutów wymaganych to 50. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe. Każdy powtarzany ciąg znaków powinien mieć format „klucz:wartość”.
required_one_of_attributes[]

string

Ogranicza odpowiedź do pojazdów z co najmniej 1 z określonych atrybutów w każdym elemencie VehicleAttributeList. Pojazd musi pasować do co najmniej jednego atrybutu na każdej liście. To pole zawiera rozdzielność/operator LUB w każdym elemencie VehicleAttributeList oraz operację spójności/ORAZ w zbiorze funkcji VehicleAttributeList. Każdy powtórzony ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.
required_one_of_attribute_sets[]

string

required_one_of_attribute_sets udostępnia dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, required_one_of_attribute_sets używa wiadomości, która umożliwia utworzenie listy list, co pozwala na wyrażenia takie 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 pliku VehicleAttributeList. Pojazd musi spełniać warunki wszystkich atrybutów na każdej liście. To pole jest operacją konjunkcji (I) w przypadku każdego VehicleAttributeList i operacją z wykluczeniem (LUB) w przypadku zbioru VehicleAttributeList. Każdy powtarzany ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.
vehicle_state

VehicleState

Ogranicza odpowiedź do pojazdów w tym stanie.
on_trip_only

bool

Zwracaj tylko te pojazdy, które są obecnie dostępne.
filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyświetlaniu 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 tutaj zostanie podana niepusta wartość, pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets muszą być puste.

Ten filtr działa jak klauzula I w połączeniu z innymi ograniczeniami, takimi jak vehicle_state lub on_trip_only.

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

Ponadto wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedyne obsługiwane porównania atrybutów to porównania ciągów znaków. Aby można było porównywać je z wartościami liczbowymi lub logicznymi, muszą być one wyraźnie umieszczone w cudzysłowie (np. attributes.<key> = "10" lub attributes.<key> = "true").
viewport

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.

ListVehiclesResponse

ListVehicles odpowiedź.

Pola
vehicles[]

Vehicle

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

string

Token do pobierania następnej strony pojazdów lub pusty, jeśli nie ma już żadnych pojazdów, które spełniają kryteria żądania.
total_size

int64

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

LocationPowerSaveMode

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

Wartości w polu enum
UNKNOWN_LOCATION_POWER_SAVE_MODE Nieokreślony tryb oszczędzania energii
LOCATION_MODE_NO_CHANGE Oszczędzanie baterii nie powinno mieć wpływu na dostawców usług lokalizacyjnych lub w przypadku tej funkcji jest ona wyłączona.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Dostawca danych o lokalizacji na podstawie GPS powinien być wyłączony, gdy włączone jest oszczędzanie baterii, a urządzenie nie jest aktywne.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Wyłącz wszystkich dostawców usług lokalizacji, gdy urządzenie nie jest interaktywne, a tryb oszczędzania baterii jest włączony.
LOCATION_MODE_FOREGROUND_ONLY W dalszym ciągu będą dostępne wszystkie usługi lokalizacyjne, ale poprawki lokalizacji powinny być dostarczane tylko aplikacjom na pierwszym planie.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokalizacja nie zostanie wyłączona, ale LocationManager będzie ograniczać wszystkie żądania do dostawców, gdy urządzenie nie będzie interaktywne.

LocationSensor

Czujnik lub metodologia służąca do określania 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 sieci komórkowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej sieci komórkowej lub punkt dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobna lokalizacja drogi.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji podanej ze źródeł innych niż urządzenie mobilne z pakietem Driver SDK. Jeśli oryginalne źródło jest opisane za pomocą jednej z pozostałych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle podawane za pomocą last_location.supplemental_location_sensor pojazdu.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli otrzyma ją w żądaniu.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji w 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 Dostępna jest szczegółowa nawigacja, a nawigacja w aplikacji Kierowca została przełączona w tryb 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.

PolylineFormatType

Typ formatu linii łamanej.

Wartości w polu enum
UNKNOWN_FORMAT_TYPE Format nie został określony lub jest nieznany.
LAT_LNG_LIST_TYPE Lista: google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia złożona zakodowana za pomocą algorytmu kompresji linii złożonej. Dekodowanie nie jest jeszcze obsługiwane.

PowerSource

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ło zasilania to ł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.

ReportBillableTripRequest

Wiadomość z żądaniem ReportBillableTrip.

Pola
name

string

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

string

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

BillingPlatformIdentifier

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

string

Identyfikatory, które są bezpośrednio związane ze zgłaszaną podróżą. Zwykle są to identyfikatory (np. identyfikatory sesji) operacji związanych z rezerwacją dokonanych przed udostępnieniem identyfikatora podróży. Liczba related_ids jest ograniczona do 50.
solution_type

SolutionType

Typ rozwiązania związanego z usługami Google Marketing Platform (np. ON_DEMAND_RIDESHARING_AND_DELIVERIES) użytego do zgłoszonej podróży.

SolutionType

Selektor różnych rodzajów rozwiązań w zgłoszonej 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ć atrybutu ON_DEMAND_RIDESHARING_AND_DELIVERIES, który jest pierwszym obsługiwanym typem rozwiązania.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Rozwiązaniem jest przejazd i dostawy na żądanie.

RequestHeader

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 podasz żadnej wartości, odpowiedź może być w dowolnym języku, a preferowany jest język angielski, o ile taka nazwa istnieje. Przykład wartości pola: en-US.
region_code

string

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

string

Wersja wywoływanego pakietu SDK (jeśli dotyczy). Format wersji to „major.minor.patch”, np. 1.1.2.
os_version

string

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

string

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

SdkType

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

string

Wersja MapSDK, z której korzysta wywoływany pakiet SDK (w odpowiednich przypadkach). Format wersji to „major.minor.patch”, np. 5.2.1.
nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. 2.1.0.
platform

Platform

Platforma wywołującego pakietu SDK.
manufacturer

string

Producent urządzenia z Androidem z wywołającego pakietu SDK. Dotyczy tylko pakietów Android SDK. Przykład wartości pola: Samsung.
android_api_level

int32

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

string

Opcjonalny identyfikator, który można podać do celów logowania i zidentyfikować żądanie.

Platforma

Platforma wywołującego pakietu SDK.

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

SdkType

Możliwe typy pakietu SDK.

Wartości w polu enum
SDK_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli pominiesz właściwość sdk_type.
CONSUMER Pakiet SDK wywołujący to Consumer.
DRIVER Pakiet SDK wywołujący to Driver.
JAVASCRIPT Wywoływanie SDK to JavaScript.

SearchTripsRequest

Wiadomość z prośbą o podróż SearchTrips.

Pola
header

RequestHeader

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

string

Wymagane. 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 wykonujące to wywołanie.
vehicle_id

string

Pojazd związany z podróżami, których dotyczy prośba. Jeśli te informacje nie są określone, 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ź będzie obejmować Podróże, które mają wpływ na trasę kierowcy.
page_size

int32

Jeśli nie skonfigurujesz tej opcji, serwer sam zdecyduje, ile wyników ma zwrócić.
page_token

string

Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwrócona w polu SearchTripsResponse.
minimum_staleness

Duration

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

SearchTripsResponse

wiadomość z odpowiedzią SearchTrips.

Pola
trips[]

Trip

Lista przejazdów dla wybranego pojazdu.
next_page_token

string

Przekaż ten token w SearchTripsRequest, aby przeglądać wyniki z listy. Interfejs API zwraca listę przejazdów przy każdym wywołaniu, a gdy nie ma już żadnych wyników, lista przejazdów jest pusta.

SearchVehiclesRequest

Wiadomość z prośbą: SearchVehicles.

Pola
header

RequestHeader

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

string

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

Wymagane. Punkt odbioru, w pobliżu którego chcesz szukać.
dropoff_point

TerminalLocation

Zamierzone miejsce dostawy klienta. Pole jest wymagane, jeśli trip_types zawiera TripType.SHARED.
pickup_radius_meters

int32

Wymagane. Określa promień wyszukiwania pojazdu wokół punktu odbioru. Zwracane są tylko pojazdy w promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie).
count

int32

Wymagane. Określa maksymalną liczbę pojazdów do zwrotu. Wartość musi zawierać się w przedziale od 1 do 50 (włącznie).
minimum_capacity

int32

Wymagane. Określa liczbę pasażerów uwzględnianych w podróży. Wartość nie może być mniejsza niż 1. Kierowca nie jest uwzględniany w wartości pojemności.
trip_types[]

TripType

Wymagane. Reprezentuje typ proponowanej podróży. Musi zawierać dokładnie 1 typ. UNKNOWN_TRIP_TYPE – to jest niedozwolone. Ogranicza wyszukiwanie do pojazdów, które obsługują dany typ podróży.
maximum_staleness

Duration

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

VehicleType

Wymagane. Ogranicza wyszukiwanie do pojazdów jednego z wybranych typów. Należy określić co najmniej jeden typ pojazdu. Typy pojazdów z kategorią UNKNOWN są niedozwolone.
required_attributes[]

VehicleAttribute

Aplikacje wywołujące mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól required_attributes, required_one_of_attributes i required_one_of_attribute_sets.

required_attributes to lista; required_one_of_attributes używa wiadomości, która umożliwia utworzenie listy list. Połączenie tych 2 pol pozwala stworzyć to wyrażenie:

(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 z określonymi atrybutami. To pole jest operacją konjunkcji (AND). Maksymalna dozwolona liczba atrybutów wymaganych to 50. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe.
required_one_of_attributes[]

VehicleAttributeList

Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej jeden z wymienionych atrybutów w każdej VehicleAttributeList. Pojazd musi pasować do co najmniej jednego atrybutu na każdej liście. To pole jest operacją łącznie z wykluczeniem OR w każdym VehicleAttributeList i operacją z wykluczeniem AND w zbiorze VehicleAttributeList.
required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets zapewnia dodatkowe funkcje.

Podobnie jak w zasadzie required_one_of_attributes, required_one_of_attribute_sets używa komunikatu, który umożliwia listę list, umożliwiając użycie takich wyrażeń:

(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 tych pojazdów, które mają wszystkie atrybuty w VehicleAttributeList. W każdej z list pojazd musi spełniać wszystkie atrybuty. To pole stanowi operację spójności/I w każdym elemencie VehicleAttributeList oraz operacji obejmującej funkcję rozdzielenia/LUB w zbiorze VehicleAttributeList.
order_by

VehicleMatchOrder

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

bool

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

Wartością domyślną jest false.
trip_id

string

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

CurrentTripsPresent

Wskazuje, czy do tego wyszukiwania kwalifikują się pojazdy, które aktywnie podróżują. Jeśli trip_type zawiera SHARED, musisz ustawić tę wartość na inną niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.
filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyszukiwaniu pojazdów. Przykłady składni filtrów 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 tutaj zostanie podana niepusta wartość, pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets muszą być puste.

Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak minimum_capacity lub vehicle_types.

Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (na przykład 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 jedynym obsługiwanym porównaniam z atrybutami są porównania ciągów znaków. Aby można było porównywać je z wartościami liczbowymi lub logicznymi, muszą być one wyraźnie umieszczone w cudzysłowie (np. attributes.<key> = "10" lub attributes.<key> = "true").

CurrentTripsPresent

Określa typy ograniczeń dotyczących bieżących przejazdów pojazdu.

Wartości w polu enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Dostępność pojazdów z obecnymi podróżami zależy od pola include_back_to_back.
NONE Pojazdy, które nie zostały pokonane, mogą pojawiać się w wynikach wyszukiwania. Gdy używana jest ta wartość, include_back_to_back nie może być równe true.
ANY Wyniki wyszukiwania obejmują pojazdy z maksymalnie 5 bieżącymi podróżami i 10 punktami pośrednimi. Gdy używana jest ta wartość, include_back_to_back nie może być równe true.

VehicleMatchOrder

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

Wartości w polu enum
UNKNOWN_VEHICLE_MATCH_ORDER Domyślna, używana w przypadku nieokreślonego lub nierozpoznanego pojazdu dopasowującego zamówienie.
PICKUP_POINT_ETA rosnąco według czasu przejazdu pojazdu do punktu odbioru;
PICKUP_POINT_DISTANCE Rosnąco według odległości od miejsca odbioru pojazdu do punktu odbioru.
DROPOFF_POINT_ETA rosnąco według czasu przejazdu pojazdu do miejsca dostawy; Tego zamówienia można użyć tylko wtedy, gdy punkt zwrotu jest określony w żądaniu.
PICKUP_POINT_STRAIGHT_DISTANCE rosnąco według odległości w linii prostej od ostatniej odnotowanej lokalizacji pojazdu do punktu odbioru;
COST Kolejność rosnąca według skonfigurowanego kosztu dopasowania. Koszt dopasowania to obliczenie ważone między długością linii prostej a szacowanym czasem dotarcia na miejsce. Wagi są ustawiane na wartości domyślne i można je modyfikować dla poszczególnych klientów. Jeśli musisz zmodyfikować te wagi na potrzeby projektu, skontaktuj się z zespołem pomocy Google.

SearchVehiclesResponse

SearchVehicles odpowiedź.

Pola
matches[]

VehicleMatch

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

SpeedReadingInterval

Wskaźnik natężenia ruchu na sąsiadującym odcinku ścieżki. Na podstawie ścieżki z punktami P_0, P_1,…, P_N (indeks zaczyna się od 0) interwał odczytu szybkości określa interwał i opis ruchu za pomocą tych kategorii.

Pola
start_polyline_point_index

int32

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

int32

Indeks końcowy tego interwału w ścieżce. W pliku JSON, gdy indeks ma wartość 0, pole będzie wyglądać na 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 spowolnienia.
SLOW Wykryto spowolnienie, ale nie utworzyła się korka.
TRAFFIC_JAM Wykryto korek.

StopLocation

Rzeczywista lokalizacja przystanku (odbiór/zwrot).

Pola
point

LatLng

Wymagane. Wskazuje rzeczywistą lokalizację.
timestamp

Timestamp

Wskazuje, kiedy nastąpiło zatrzymanie.
stop_time
(deprecated)

Timestamp

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

TerminalLocation

Określa lokalizację punktu kontrolnego.

Pola
point

LatLng

Wymagane. Wskazuje lokalizację punktu kontrolnego podróży.
terminal_point_id
(deprecated)

TerminalPointId

Wycofano: zamiast tego podaj pole point.
access_point_id
(deprecated)

string

Wycofano: zamiast tego podaj pole point.
trip_id
(deprecated)

string

Rola wycofana.
terminal_location_type
(deprecated)

WaypointType

Nieużywane: te dane będą dostępne w sekcji Vehicle.waypoint.

TerminalPointId

Wycofano: Fleet Engine nie obsługuje już punktów TerminalPoint. Użyj w zamian zasady TerminalLocation.point.

Pola
value
(deprecated)

string

Rola wycofana.
Pole sumy 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.

TrafficPolylineData

Warunki na drodze do oczekiwanej trasy pojazdu.

Pola
traffic_rendering

VisualTrafficReportPolylineRendering

Wyrenderowanie ścieżki wieloliniowej pokazujące, jak szybki jest ruch na wszystkich odcinkach trasy przejazdu klienta.

Podróż

Metadane podróży.

Pola
name

string

Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}”
vehicle_id

string

Identyfikator pojazdu mierzącego tę podróż.
trip_status

TripStatus

Bieżący stan podróży.
trip_type

TripType

Typ podróży.
pickup_point

TerminalLocation

Miejsce, w którym klient wskazuje, że chce odebrać przesyłkę.
actual_pickup_point

StopLocation

Tylko dane wejściowe. Rzeczywista lokalizacja i miejsce odbioru klienta. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o rzeczywistym odbiorze.
actual_pickup_arrival_point

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do punktu odbioru. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.
pickup_time

Timestamp

Tylko dane wyjściowe. Przewidywany czas, w którym pasażerowie zostaną odebrani, lub faktyczny czas, w którym zostali odebrani.
intermediate_destinations[]

TerminalLocation

Pośrednie przystanki na potrzeby podróży (oprócz prośby o odbiór i powrót). Początkowo nie będzie to obsługiwane w przypadku wspólnych podróży.
intermediate_destinations_version

Timestamp

Wskazuje, kiedy intermediate_destinations został ostatnio zmodyfikowany. Aby zapewnić, że intermediate_destinations nie została zmieniona, serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w UpdateTripRequest po aktualizacji intermediate_destination_index.
intermediate_destination_index

int32

Jeśli TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazuje pośredni miejsce docelowe, przez które pojazd będzie następny. Gdy TripStatus = ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1], która wskazuje, w jakiej lokalizacji pośredniej znajduje się pojazd. Dostawca ustawia tę wartość. W przypadku braku wartości intermediate_destinations to pole jest ignorowane.
actual_intermediate_destination_arrival_points[]

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja dotarcia kierowcy do pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do miejsc pośrednich.
actual_intermediate_destinations[]

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce odbioru klienta z miejsca docelowego pośredniego. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o faktycznych danych dotyczących odbioru w miejscach pośrednich.
dropoff_point

TerminalLocation

Lokalizacja, w której klient wskazuje, że zostanie odesłany.
actual_dropoff_point

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja klienta, kiedy i gdzie został on odesłany. To pole jest przeznaczone dla dostawcy, aby mógł podać opinię na temat rzeczywistych informacji o odesłaniu.
dropoff_time

Timestamp

Tylko dane wyjściowe. Przewidywana godzina, o której pasażerowie zostaną wysadzeni w miejscu docelowym, lub rzeczywista godzina wysadzania.
remaining_waypoints[]

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka z bieżącej lokalizacji do punktu zwrotu (włącznie). Ta ścieżka może obejmować punkty na trasie innych podróży.
vehicle_waypoints[]

TripWaypoint

To pole umożliwia ręczne sortowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty pośrednie dla przypisanego pojazdu, a także punkty odbioru i rozładunku w ramach tej podróży. 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 przez serwer tylko w przypadku wywołań UpdateTrip i CreateTrip, a nie GetTrip.
route[]

LatLng

Tylko dane wyjściowe. Przewidywana trasa do pierwszego wejścia w pozostałe punkty pośrednie. Pamiętaj, że pierwszy punkt kontrolny może należeć do innej podróży.
current_route_segment

string

Tylko dane wyjściowe. zakodowana ścieżka do następnego punktu orientacyjnego;

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety 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 do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.
current_route_segment_traffic

ConsumableTrafficPolyline

Tylko dane wyjściowe. Wskazuje natężenie ruchu na drodze current_route_segment, jeśli są dostępne.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.
current_route_segment_traffic_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy po raz ostatni zmodyfikowano current_route_segment_traffic.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.
current_route_segment_end_point

TripWaypoint

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

Int32Value

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

Timestamp

Tylko dane wyjściowe. Przewidywany czas dojazdu do następnego punktu orientacyjnego (pierwszy wpis w polu remaining_waypoints). Wartość jest nieokreślona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).
remaining_time_to_first_waypoint

Duration

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

Timestamp

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

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano remaining_waypoints.path_to_waypoint i remaining_waypoints.traffic_to_waypoint. Aplikacja kliencka powinna przekazywać tę wartość w pamięci podręcznej i przekazywać ją w narzędziu GetTripRequest, aby ścieżki i ruch związane z parametrem remaining_waypoints były zwracane tylko po zaktualizowaniu.
number_of_passengers

int32

Stały. Wskazuje liczbę pasażerów tej podróży bez uwzględniania kierowcy. Pojazd musi mieć dostępne miejsce, aby można było zwrócić odpowiedź SearchVehicles.
last_location

VehicleLocation

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

bool

Tylko dane wyjściowe. Wskazuje, czy last_location pojazdu może być dopasowany do current_route_segment. Fałsz, jeśli atrybut last_location lub current_route_segment nie istnieje. Obliczane przez Fleet Engine. Wszelkie aktualizacje od klientów zostaną zignorowane.
view

TripView

Podzbiór wypełnionych pól Podróży i sposób ich interpretacji.

TripStatus

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

Wartości w polu enum
UNKNOWN_TRIP_STATUS Domyślna używana 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 miejsca docelowego pośredniego (a nie do miejsca wysadzania).
ENROUTE_TO_DROPOFF Kierowca odebrał pasażera i jedzie do następnego miejsca docelowego.
COMPLETE Pasażer został już odwieziony, a przejazd został zakończony.
CANCELED Przejazd został anulowany przed odbiorem przez kierowcę, pasażera lub dostawcę usług przewozu.

TripType

Typ podróży.

Wartości w polu enum
UNKNOWN_TRIP_TYPE Domyślna używana w przypadku nieokreślonych lub nierozpoznanych typów podróży.
SHARED Podróż może być realizowana tym samym pojazdem co inne.
EXCLUSIVE Przejażdżka jest dostępna wyłącznie dla pojazdu.

TripView

Selektor różnych zestawów pól Podróż w odpowiedzi GetTrip. Więcej informacji znajdziesz w AIP-157. Prawdopodobnie uda się dodać więcej widoków.

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Ze względu na zgodność wsteczną interfejs API domyślnie wyświetla widok pakietu SDK. Aby zapewnić stabilność i obsługę, zalecamy klientom wybranie TripView innego niż SDK.
SDK Obejmuje pola, których interpretacja lub działanie może być niemożliwe przy użyciu publicznie dostępnych bibliotek.
JOURNEY_SHARING_V1S Pola dotyczące podróży są wypełniane w przypadku użycia funkcji Udostępnianie trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

TripWaypoint

Opisuje punkt postoju na trasie pojazdu lub punkt końcowy na trasie przejazdu.

Pola
location

TerminalLocation

Lokalizacja tego punktu kontrolnego.
trip_id

string

Podróż powiązana z tym punktem na trasie.
waypoint_type

WaypointType

Rola, jaką ten punkt kontrolny odgrywa w ramach danej podróży, np. odbiór lub odwóz.
path_to_waypoint[]

LatLng

Ścieżka od poprzedniego punktu do bieżącego. Niezdefiniowane dla pierwszego punktu 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 tylko do użycia przez pakiet SDK sterownika i pakiet SDK dla konsumentów. Dekodowanie nie jest jeszcze obsługiwane.
traffic_to_waypoint

ConsumableTrafficPolyline

Warunki na drodze do tego punktu kontrolnego. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usługi przejazdy i dostawy w ramach Google Map Platform.
distance_meters

Int32Value

Odległość na ścieżce od poprzedniego punktu do bieżącego punktu. Niezdefiniowane dla pierwszego punktu na liście.
eta

Timestamp

Szacowany czas dotarcia do tego punktu orientacyjnego. Nieokreślony dla pierwszego punktu na liście.
duration

Duration

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

UpdateTripRequest

Wiadomość z prośbą UpdateTrip.

Pola
header

RequestHeader

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

string

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

Trip

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

Kiedy 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 kolejność nie będzie ustalona.

Gdy podasz wartość Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty pośrednie podróży pojazdu bez dodatkowych punktów pośrednich. Punkty pośrednie muszą być uporządkowane w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed punktami pośrednimi, a wszystkie punkty pośrednie przed punktem docelowym. Punkty pośrednie podróży EXCLUSIVE nie mogą nakładać się na żadne inne podróże. Używane są pola trip_id, waypoint_type i location, a pozostałe pola TripWaypoint w vehicle_waypoints są ignorowane.

Aby uniknąć warunków wyścigu w przypadku podróży z większą liczbą miejsc docelowych, podczas aktualizowania stanu podróży na ENROUTE_TO_INTERMEDIATE_DESTINATION należy podać Trip.intermediate_destinations_version. Przekazana wartość Trip.intermediate_destinations_version musi być zgodna z wersją Fleet Engine. Jeśli nie, żądanie się nie powiedzie.
update_mask

FieldMask

Wymagane. Maska pól określająca, które pola w podróży mają zostać zaktualizowane. update_mask musi zawierać co najmniej 1 pole.

UpdateVehicleAttributesRequest

Wiadomość z prośbą: UpdateVehicleAttributes.

Pola
header

RequestHeader

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

string

Wymagane. 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 wykonujące to wywołanie.
attributes[]

VehicleAttribute

Wymagane. Atrybuty pojazdu do zaktualizowania. Atrybuty, które nie są wymienione, nie są zmieniane ani usuwane.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes odpowiedź.

Pola
attributes[]

VehicleAttribute

Wymagane. Zaktualizowana pełna lista atrybutów pojazdów, w tym nowych, zmienionych i niezmienionych atrybutów.

UpdateVehicleRequest

`UpdateVehicle request message.

Pola
header

RequestHeader

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

string

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

Vehicle

Wymagane. Wartości elementu Vehicle do zastosowania. Podczas aktualizowania Vehicle te 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 prośbie. Jeśli chcesz zaktualizować tylko niektóre atrybuty, użyj metody UpdateVehicleAttributes.

Pole waypoints również można zaktualizować, ale musi zawierać wszystkie punkty pośrednie znajdujące się obecnie w pojeździe i nie może zawierać żadnych innych punktów.
update_mask

FieldMask

Wymagane. 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. Niepowtarzalna nazwa tego pojazdu. Format to providers/{provider}/vehicles/{vehicle}.
vehicle_state

VehicleState

Stan pojazdu.
supported_trip_types[]

TripType

Typy podróży obsługiwane przez ten pojazd.
current_trips[]

string

Tylko dane wyjściowe. Lista trip_id na potrzeby podróży aktualnie przypisanych do tego pojazdu.
last_location

VehicleLocation

Ostatnio zgłoszona lokalizacja pojazdu.
maximum_capacity

int32

Łączna liczba pasażerów, których może przewieźć pojazd. W tej wartości nie uwzględnia się kierowcy. Ta wartość nie może być mniejsza niż 1.
attributes[]

VehicleAttribute

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

VehicleType

Wymagane. Typ pojazdu. Może służyć do filtrowania pojazdów w wynikach wyszukiwania w usłudze SearchVehicles. Wpływa też na szacowany czas dotarcia na miejsce i obliczanie trasy.
license_plate

LicensePlate

Informacje o tablicach rejestracyjnych pojazdu.
route[]
(deprecated)

TerminalLocation

Wycofane: użyj atrybutu Vehicle.waypoints.
current_route_segment

string

Linia łamana określająca trasę, którą aplikacja kierowcy ma poprowadzić do następnego punktu orientacyjnego. Ta lista jest również zwracana w Trip.current_route_segment dla 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.
current_route_segment_traffic

TrafficPolylineData

Tylko dane wejściowe. Fleet Engine używa tych informacji, aby ulepszyć udostępnianie przejazdów. Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet Driver SDK.
current_route_segment_version

Timestamp

Tylko dane wyjściowe. Czas ustawienia parametru 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.
current_route_segment_end_point

TripWaypoint

Punkt orientacyjny, w którym kończy się current_route_segment. Mogą je przekazać kierowcy podczas połączeń UpdateVehicle jako punkt na trasie obejmującej całą podróż, jako punkt pośredni LatLng lub jako ostatni element LatLng pojazdu current_route_segment. Jeśli nie zostanie w pełni określony, Fleet Engine podejmie wtedy wszelkie możliwe działania, aby interpolować do rzeczywistego punktu pośredniego. To pole jest ignorowane w wywołaniach UpdateVehicle, chyba że określono też pole current_route_segment.
remaining_distance_meters

Int32Value

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

Timestamp

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

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

Int32Value

Tylko dane wejściowe. Pozostały czas jazdy w przypadku current_route_segment. Wartość jest nieokreślona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste. Ta wartość powinna pasować do zakresu od eta_to_first_waypoint do current_time, jeśli wszystkie strony używają tego samego zegara.

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

TripWaypoint

Pozostałe punkty na trasie przypisane do tego pojazdu.
waypoints_version

Timestamp

Tylko dane wyjściowe. Data ostatniej aktualizacji pola waypoints. Klienci powinni przechowywać tę wartość w pamięci podręcznej i przekazywać ją w polu GetVehicleRequest, aby mieć pewność, że pole waypoints zostanie zwrócone tylko wtedy, gdy zostanie zaktualizowane.
back_to_back_enabled

bool

Wskazuje, czy kierowca akceptuje połączenia w obie strony. Jeśli true, SearchVehicles może obejmować 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ę.

VehicleType

Typ pojazdu.

Pola
category

Category

Kategoria typu pojazdu

Kategoria

Kategorie typu pojazdu

Wartości w polu enum
UNKNOWN Domyślna, używana w przypadku nieokreślonych lub nierozpoznanych kategorii pojazdów.
AUTO Samochód.
TAXI Wszelkie pojazdy służące jako taksówka (zwykle licencjonowane lub objęte regulacjami).
TRUCK Zazwyczaj są to samochody o dużej pojemności pamięci masowej.
TWO_WHEELER Motocykl, motorower lub inny pojazd dwukołowy
BICYCLE Transport napędzany przez człowieka.
PEDESTRIAN Osoba poruszająca się pieszo lub biegnąca po chodniku.

VehicleAttribute

Opisuje atrybut pojazdu jako parę 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 sumy vehicle_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. vehicle_attribute_value może być tylko jednym z tych elementów:
string_value

string

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

Uwaga: działa tak samo jak pole value, które z czasem zostanie wycofane. Do tworzenia i aktualizacji danych możesz użyć dowolnego z tych pól, ale zdecydowanie zalecamy użycie string_value. Jeśli opcje string_value i value są ustawione, muszą być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.
bool_value

bool

Wartość atrybutu typu logicznego.
number_value

double

Wartość atrybutu została wpisana dwukrotnie.

VehicleAttributeList

Typ danych listy list dla atrybutów pojazdów.

Pola
attributes[]

VehicleAttribute

Lista atrybutów w tej kolekcji.

VehicleLocation

lokalizacja, prędkość i kierunek pojazdu w określonym czasie;

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest wysyłany do Fleet Engine, lokalizacja pojazdu to lokalizacja GPS. Po otrzymaniu odpowiedzi możesz określić lokalizację pojazdu na podstawie GPS-u, dodatkową lokalizację lub inną orientacyjną lokalizację. Źródło jest określone w pliku location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu latlng_accuracy.
latlng_accuracy

DoubleValue

Dokładność promienia location w metrach.
heading

Int32Value

Kierunek ruchu pojazdu w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj w zastępstwie zasady heading_accuracy.
heading_accuracy

DoubleValue

Dokładność heading w stopniach.
altitude

DoubleValue

Wysokość w metrach nad 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

Czas, gdy czujnik location został zgłoszony przez czujnik zgodnie z jego zegarem.
server_time

Timestamp

Tylko dane wyjściowe. Czas otrzymania przez serwer informacji o lokalizacji.
location_sensor

LocationSensor

Dostawca danych o lokalizacji (na przykład GPS).
is_road_snapped

BoolValue

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

BoolValue

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

Int32Value

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

Int32Value

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

LatLng

Nieprzetworzona lokalizacja pojazdu (nieprzetworzona przez narzędzie do wykrywania dróg).
raw_location_time

Timestamp

Sygnatura czasowa powiązana z lokalizacją w postaci nieprzetworzonych danych.
raw_location_sensor

LocationSensor

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

DoubleValue

Dokładność raw_location w postaci promienia w metrach.
supplemental_location

LatLng

Dodatkowa lokalizacja dostarczona przez aplikację integrującą.
supplemental_location_time

Timestamp

Sygnatura czasowa powiązana z dodatkową lokalizacją.
supplemental_location_sensor

LocationSensor

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

DoubleValue

Dokładność supplemental_location w postaci promienia w metrach.
road_snapped
(deprecated)

bool

Wycofane: użyj atrybutu is_road_snapped.

VehicleMatch

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

Pola
vehicle

Vehicle

Wymagane. pojazd, który odpowiada żądaniu;
vehicle_pickup_eta

Timestamp

Szacowany czas dotarcia pojazdu na miejsce do punktu odbioru określonego w żądaniu. Pustą wartość oznacza błąd obliczania przewidywanego czasu dotarcia pojazdu. Jeśli SearchVehiclesRequest.include_back_to_back to true, a pojazd ma aktywną podróż, vehicle_pickup_eta obejmować będzie czas potrzebny do zakończenia bieżącej aktywnej podróży.
vehicle_pickup_distance_meters

Int32Value

Odległość od bieżącej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, z uwzględnieniem wszelkich pośrednich punktów odbioru i zwrotu w przypadku dotychczasowych podróży. Na tę odległość składają się obliczona odległość dojazdu (trasa) oraz odległość w linii prostej między punktem końcowym nawigacji a żądanym punktem odbioru. (Odległość między punktem końcowym nawigacji a żądanym punktem odbioru jest zwykle niewielka). Pustą wartość oznacza błąd obliczenia odległości.
vehicle_pickup_straight_line_distance_meters

Int32Value

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

Timestamp

Przewidywany czas dojazdu do miejsca docelowego wskazanego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje zatrzymanie w dowolnym punkcie pośrednim przed dropoff_point określonym w żądaniu. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie określony punkt zwrotu. Pusta wartość oznacza błąd podczas obliczania szacowanego czasu dotarcia na miejsce.
vehicle_pickup_to_dropoff_distance_meters

Int32Value

Odległość pojazdu (w metrach) od punktu odbioru do miejsca nadania określonego w żądaniu. Odległość jest ograniczona tylko do tych 2 punktów i nie obejmuje lokalizacji pojazdu ani innych punktów, które należy odwiedzić, zanim pojazd dotrze do punktu odbioru lub punktu nadania. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu określisz atrybut dropoff_point. Pustą wartość oznacza błąd obliczania odległości od punktu odbioru do punktu docelowego określonego w żądaniu.
trip_type

TripType

Wymagane. Typ przejazdu, którego żądanie posłużyło do obliczenia przewidywanego czasu dojazdu do punktu odbioru.
vehicle_trips_waypoints[]

Waypoint

Uporządkowana lista punktów na trasie używanych do obliczania szacowanego czasu dotarcia na miejsce. Lista zawiera lokalizację pojazdu, punkty odbioru w przypadku aktywnych przejazdów oraz punkty odbioru podane w prośbie. Pusta lista oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce.
vehicle_match_type

VehicleMatchType

Typ dopasowania pojazdu.
requested_ordered_by

VehicleMatchOrder

żądany porządek sortowania dopasowań pojazdów.
ordered_by

VehicleMatchOrder

Rzeczywiste zamówienie użyte w przypadku tego pojazdu. Zwykle pole to odpowiada polu „order_by” w żądaniu, ale w pewnych okolicznościach, np. w przypadku wewnętrznego błędu serwera, może być używana inna metoda (np. PICKUP_POINT_STRAIGHT_DISTANCE).

VehicleMatchType

Typ dopasowania pojazdu.

Wartości w polu enum
UNKNOWN Nieznany typ dopasowania pojazdu
EXCLUSIVE Pojazd nie ma obecnie przypisanej podróży i może dotrzeć do punktu odbioru.
BACK_TO_BACK Pojazd jest obecnie przypisany do przejazdu, ale po zakończeniu bieżącego przejazdu może udać się do punktu odbioru. Obliczenia czasu i odległości uwzględniają bieżącą podróż.
CARPOOL Pojazd ma wystarczającą pojemność do wspólnego przejazdu.
CARPOOL_BACK_TO_BACK Pojazd dojedzie do punktu odbioru dopiero po zakończeniu bieżącej, aktywnej podróży. Obliczenia czasu i odległości uwzględniają bieżącą podróż.

VehicleState

Stan elementu 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 przejazdów. Uwaga: pojazd może nadal działać w tym stanie podczas przypisanej do niego podróży.
ONLINE Pojazd przyjmuje nowe przejazdy.

VisualTrafficReportPolylineRendering

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

Pola
road_stretch[]

RoadStretch

Opcjonalnie: Odcinki dróg, które powinny 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 stylizacji, klient powinien zastosować domyślny styl dla trasy.

RoadStretch

Jeden odcinek drogi do wyrenderowania.

Pola
style

Style

Wymagane. Styl, który chcesz zastosować.
offset_meters

int32

Wymagane. Styl należy zastosować w miejscu [offset_meters, offset_meters + length_meters).
length_meters

int32

Wymagane. Długość ścieżki, w której chcesz zastosować styl.

Styl

Styl ruchu, który wskazuje prędkość ruchu.

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

Punkt pośredni

Opisuje punkty pośrednie na trasie VehicleMatch w ramach SearchVehiclesResponse. Ta koncepcja jest reprezentowana jako TripWaypoint we wszystkich innych punktach końcowych.

Pola
lat_lng

LatLng

Lokalizacja tego punktu na trasie.
eta

Timestamp

Szacowana godzina, o której pojazd dotrze do tego punktu pośredniego.

WaypointType

Typ punktu orientacyjnego.

Wartości w polu enum
UNKNOWN_WAYPOINT_TYPE Nieznany lub nieokreślony typ punktu pośredniego.
PICKUP_WAYPOINT_TYPE Punkty pośrednie do odbierania pasażerów lub przesyłek.
DROP_OFF_WAYPOINT_TYPE Punkty pośrednie na potrzeby wysadzenia pasażerów lub dostawy towarów.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie na trasie z wieloma miejscami docelowymi.