Package maps.fleetengine.v1

Indeks

TripService

Usługa zarządzania podróżami.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Wyświetlanie informacji o pojedynczej podróży.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Zgłaszanie korzystania z podróży podlegającej rozliczeniu.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Wyświetl informacje o wszystkich przejazdach konkretnym pojazdem.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

aktualizuje dane podróży.

VehicleService

Zarządzanie pojazdami.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tworzy instancję nowego pojazdu powiązanego z usługodawcą oferującym wspólne przejazdy lub dostawy. Każdy element Vehicle musi mieć unikalny identyfikator pojazdu.

Następujące Vehicle pola są wymagane podczas tworzenia 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.

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.

SearchFuzzedVehicles

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Wycofane: użyj zasady SearchVehicles.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Zapisuje zaktualizowane dane pojazdu we 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 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żna zaktualizować, ale musi ono zawierać wszystkie punkty pośrednie w pojeździe, które aktualnie znajdują się na pojeździe, bez żadnych innych punktów pośrednich.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

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

UpdateVehicleLocation

rpc UpdateVehicleLocation(UpdateVehicleLocationRequest) returns (VehicleLocation)

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

BatteryInfo

Informacje o baterii urządzenia.

Pola
battery_status

BatteryStatus

Stan baterii, czy to w pełni naładowana, czy w pełni naładowana.

power_source

PowerSource

Stan źródła zasilania z baterii.

battery_percentage

float

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

BatteryStatus

Stan baterii, czy to w pełni naładowana, czy w pełni naładowana.

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 Bateria jest słaba.

BillingPlatformIdentifier

Zbiór 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żywane w przypadku nieokreślonych platform.
SERVER Platforma to serwer klienta.
WEB Platforma to przeglądarka.
ANDROID Platforma to urządzenie mobilne z Androidem.
IOS Platforma to urządzenie mobilne z systemem iOS.
OTHERS Inne platformy, których nie ma na tej liście.

ConsumableTrafficPolyline

Natężenie ruchu na trasie pojazdu.

Pola
speed_reading_interval[]

SpeedReadingInterval

Szybkość ruchu na trasie od poprzedniego punktu na trasie do bieżącego.

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

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

To pole jest wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

trip_id

string

To pole jest wymagane. Unikalny identyfikator podróży. Obowiązują następujące ograniczenia:

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

Trip

To pole jest wymagane. Element Podróż do utworzenia.

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

  • trip_type
  • pickup_point

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

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Pozostałe pola Podróże są ignorowane. Na przykład wszystkie podróże zaczynają się od trip_status o wartości NEW nawet wtedy, gdy w prośbie o utworzenie podasz trip_status z CANCELED.

Tylko podróże EXCLUSIVE obsługują intermediate_destinations.

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

Jeśli określisz wartość Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie przejazdu pojazdu bez dodatkowych punktów pośrednich. Punkty na trasie należy ułożyć 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ą się przeplatać z żadnymi innymi trasami.

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

CreateVehicleRequest

CreateVehicle wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

To pole jest wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

vehicle_id

string

To pole jest wymagane. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:

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

Vehicle

To pole jest wymagane. Element Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić te pola:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia pojazdu ignorowane są te pola:

  • 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

Sposób działania funkcji lokalizacji na urządzeniu przy włączonym oszczędzaniu baterii.

is_power_save_mode

bool

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

is_interactive

bool

Określa, czy urządzenie jest w stanie interaktywnym.

battery_info

BatteryInfo

Informacje o stanie baterii.

GetTripRequest

Komunikat żądania GetTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

To pole jest wymagane. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

view

TripView

Podzbiór pól dotyczących podróży, 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 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), dla której pobierane są elementy Trip.remaining_waypoints. Jeśli nie uległy zmianie od tej sygnatury czasowej, w odpowiedzi remaining_waypoints nie będą ustawione. Jeśli to pole nie jest określone, wartość remaining_waypoints jest zawsze pobierana.

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ą (z jej wyłączeniem), dla której pobierany jest element Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniły się od tej sygnatury czasowej, pole current_route_segment_traffic nie zostanie 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 w przypadku klientów korzystających z usługi Przejazdy na żądanie i dostawców.

remaining_waypoints_route_version

Timestamp

Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), 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, pola powyżej nie zostaną ustawione w odpowiedzi. Jeśli zasada remaining_waypoints_route_version nie jest określona, informacje o ruchu i ścieżce są zawsze pobierane.

GetVehicleRequest

GetVehicle wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

To pole jest wymagane. Musi mieć format providers/{provider}/vehicles/{vehicle}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

current_route_segment_version

Timestamp

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

waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane Vehicle.waypoints. Jeśli punkty na trasie nie zmieniły się od tej sygnatury czasowej, w odpowiedzi dane vehicle.waypoints nie zostaną ustawione. Jeśli to pole nie jest określone, wartość vehicle.waypoints jest zawsze pobierana.

LicensePlate

Informacje o tablicy rejestracyjnej pojazdu. Aby zapobiec przechowywaniu informacji umożliwiających identyfikację osób, w ramach danego podmiotu przechowujemy tylko minimalną ilość informacji na temat tablicy rejestracyjnej.

Pola
country_code

string

To pole jest wymagane. Kod kraju/regionu CLDR. Na przykład US dla Stanów Zjednoczonych i IN dla Indii.

last_character

string

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

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

ListVehiclesRequest

ListVehicles wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

To pole jest wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy 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 poprzednim wywołaniu metody ListVehicles, która umożliwia podział na strony grup pojazdów. Wartość jest nieokreślona, jeśli kryteria filtrowania w żądaniu nie są takie same jak kryteria filtra w poprzednim wywołaniu funkcji ListVehicles.

minimum_capacity

Int32Value

Określa wymaganą minimalną pojemność pojazdu. Wszystkie zwrócone pojazdy będą miały parametr maximum_capacity większy od tej wartości lub jej równy. Wartość musi być większa od 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 wysłały aktualizacje lokalizacji do Fleet Engine w określonym czasie. Nieruchome pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli ten parametr jest dostępny, musi to być prawidłowy dodatni czas trwania.

vehicle_type_categories[]

Category

To pole jest wymagane. Ogranicza odpowiedź do pojazdów z jednej ze wskazanych kategorii. 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 jest listą; required_one_of_attributes używa wiadomości, która może być listą list. Łącząc te 2 pola, można utworzyć kompozycję 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 z określonymi atrybutami. To pole jest łączeniem/ORAZ. Dozwolonych jest maksymalnie 50 atrybutów wymaganych. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe. Każdy powtórzony ciąg znaków powinien mieć format „klucz:wartość”.

required_one_of_attributes[]

string

Ogranicza odpowiedź do pojazdów z co najmniej jednym z określonych atrybutów w każdym atrybucie VehicleAttributeList. Na każdej liście pojazd musi pasować do co najmniej jednego z atrybutów. To pole zawiera operację rozłączania/LUB w każdym obiekcie VehicleAttributeList oraz operacji łączenia/ORAZ w zbiorze danych 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 required_one_of_attributes, required_one_of_attribute_sets używa wiadomości, która zezwala na tworzenie listy z wyrażeniami takimi 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, które pasują do wszystkich atrybutów w VehicleAttributeList. Pojazd musi pasować do wszystkich atrybutów na każdej liście. To pole jest łączoną operacji/ORAZ w każdej funkcji VehicleAttributeList i uwzględniającą operację rozdzielenia/LUB w zbiorze danych VehicleAttributeList. Każdy powtórzony 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

Zwrot pojazdów tylko w ramach aktualnej podróży.

filter

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane przy wyświetlaniu listy 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 określona jest wartość, która nie jest pusta, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula ORAZ 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ń dozwolona w zapytaniu filtra to 50.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami z atrybutami są porównania w postaci ciągów znaków. Aby można było porównać wartości z liczbami lub wartościami logicznymi, muszą one być ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

viewport

Viewport

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

ListVehiclesResponse

ListVehicles odpowiedź.

Pola
vehicles[]

Vehicle

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

next_page_token

string

Token, który pozwala pobrać następną stronę z pojazdami, lub pusty, jeśli nie ma więcej pojazdów, które spełniają kryteria żądania.

total_size

int64

To pole jest wymagane. Łączna liczba pojazdów na wszystkich stronach spełniających kryteria żądania.

LocationPowerSaveMode

Konfiguracja funkcji lokalizacji na urządzeniu mobilnym, gdy włączona jest funkcja „Oszczędzanie 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 w lokalizacji
LOCATION_MODE_NO_CHANGE Oszczędzanie baterii nie powinno mieć wpływu na dostawców usług lub jest wyłączone.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Dostawca usług lokalizacyjnych 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 usług lokalizacyjnych powinni być wyłączeni.
LOCATION_MODE_FOREGROUND_ONLY Wszyscy dostawcy lokalizacji pozostaną dostępni, ale poprawki lokalizacji należy podawać tylko w aplikacjach działających na pierwszym planie.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokalizacja nie zostanie wyłączona, ale Menedżer lokalizacji będzie ograniczać wszystkie żądania wysyłane do dostawców, gdy urządzenie nie jest interaktywne.

LocationSensor

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 punkt dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobne miejsce na drodze.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji podawanej 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 przez 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 zostanie przesłana 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 Dostępna jest szczegółowa nawigacja, a w aplikacji kierowcy jest włączony 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 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.

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łem zasilania jest port USB.
POWER_SOURCE_WIRELESS Źródło zasilania jest bezprzewodowe.
POWER_SOURCE_UNPLUGGED Bateria jest odłączona.

ReportBillableTripRequest

Komunikat żądania ReportBillableTrip.

Pola
name

string

To pole jest wymagane. Musi mieć format providers/{provider}/billableTrips/{billable_trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

country_code

string

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

platform

BillingPlatformIdentifier

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

related_ids[]

string

Identyfikatory, które są bezpośrednio związane z zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) działań związanych z wstępną rezerwacją wykonanych przed udostępnieniem identyfikatora podróży. Liczba elementów related_ids jest ograniczona do 50.

solution_type

SolutionType

Typ rozwiązania usługi GMP (np. ON_DEMAND_RIDESHARING_AND_DELIVERIES) używanego w zgłoszonej podróży.

SolutionType

Selektor do różnych typów rozwiązań objętych raportowaną podróżą.

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 – jest to pierwszy obsługiwany typ rozwiązania.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Rozwiązaniem jest usługa przewozu osób na żądanie z dostawą.

RequestHeader

Nagłówek 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. W przypadku takiej nazwy preferowana jest angielski. Przykład wartości pola: en-US.

region_code

string

To pole jest wymagane. 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 „główna.podrzędna.poprawka”, na przykład: 1.1.2.

os_version

string

Wersja systemu operacyjnego, w którym działa pakiet SDK wywołujący. 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órego zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „główna.podrzędna.poprawka”, na przykład: 5.2.1.

nav_sdk_version

string

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

platform

Platform

Platforma wywołującego pakietu SDK.

manufacturer

string

Producent urządzenia z Androidem za pomocą wywołującego pakietu SDK. Dotyczy tylko pakietów SDK 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.

trace_id

string

Opcjonalny identyfikator, który można podać na potrzeby logowania w celu identyfikacji żądania.

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 została pominięta.
ANDROID Żądanie pochodzi z Androida.
IOS Żądanie pochodzi z iOS.
WEB Żądanie pochodzi z internetu.

SdkType

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 Wywołujący pakiet SDK to Sterownik.
JAVASCRIPT Wywołujący pakiet SDK to JavaScript.

SearchTripsRequest

Komunikat z prośbą o SearchTrips.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

To pole jest wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy 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, zwracane 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ź uwzględnia podróże, które mają wpływ 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, ustaw tę wartość na wartość zwróconą wcześniej w polu SearchTripsResponse.

minimum_staleness

Duration

Jeśli podano ten argument, zwraca podróże, które nie zostały zaktualizowane po godzinie (current - minimum_staleness).

SearchTripsResponse

Komunikat z odpowiedzią SearchTrips.

Pola
trips[]

Trip

Lista przejazdów żądanego pojazdu.

next_page_token

string

Przekaż ten token w żądaniu SearchTripsRequest do strony z wynikami 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.

SearchVehiclesRequest

SearchVehicles wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

To pole jest wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

pickup_point

TerminalLocation

To pole jest wymagane. Położony w pobliżu punkt odbioru, który chcesz wyszukać.

dropoff_point

TerminalLocation

Zamierzone miejsce docelowe zwrotu klienta. Pole jest wymagane, jeśli trip_types zawiera TripType.SHARED.

pickup_radius_meters

int32

To pole jest wymagane. 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

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

minimum_capacity

int32

To pole jest wymagane. Określa liczbę pasażerów uwzględnianych podczas podróży. Wartość nie może być mniejsza niż 1. W zakresie pojemności nie brany jest pod uwagę kierowca.

trip_types[]

TripType

To pole jest wymagane. Reprezentuje typ proponowanej podróży. Musi zawierać dokładnie 1 typ. UNKNOWN_TRIP_TYPE – to jest niedozwolone. Ogranicza wyszukiwanie tylko do tych pojazdów, które mogą obsłużyć dany typ podróży.

maximum_staleness

Duration

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

vehicle_types[]

VehicleType

To pole jest wymagane. Ogranicza wyszukiwanie do pojazdów jednego z określonych typów. Musisz określić co najmniej jeden typ pojazdu. Typy pojazdów z kategorii UNKNOWN są niedozwolone.

required_attributes[]

VehicleAttribute

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 jest listą; required_one_of_attributes używa wiadomości, która może być listą list. Łącząc te 2 pola, można utworzyć kompozycję wyrażenia:

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

Ogranicza wyszukiwanie tylko do pojazdów o określonych atrybutach. To pole jest łączeniem/ORAZ. Dozwolonych jest maksymalnie 50 atrybutów wymaganych. 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 określonych atrybutów w każdym atrybucie VehicleAttributeList. Na każdej liście pojazd musi pasować do co najmniej jednego z atrybutów. To pole zawiera operację rozłączania/LUB w każdym obiekcie VehicleAttributeList oraz operacji łączenia/ORAZ w zbiorze danych VehicleAttributeList.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets udostępnia dodatkowe funkcje.

Podobnie jak required_one_of_attributes, required_one_of_attribute_sets używa wiadomości, która zezwala na tworzenie listy z wyrażeniami takimi 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 tych pojazdów ze wszystkimi atrybutami marki VehicleAttributeList. Pojazd musi pasować do wszystkich atrybutów na każdej liście. To pole jest łączoną operacji/ORAZ w każdej funkcji VehicleAttributeList i uwzględniającą operację rozdzielenia/LUB w zbiorze danych VehicleAttributeList.

order_by

VehicleMatchOrder

To pole jest wymagane. Określa żądane kryterium kolejności wyników.

include_back_to_back

bool

Ta wartość określa, czy pojazdy z 1 aktywną podróżą kwalifikują się do tego wyszukiwania. To pole jest używane tylko wtedy, gdy pole current_trips_present jest nieokreślone. Gdy nie określono atrybutu current_trips_present, a to pole zawiera wartość false, pojazdy z przypisanymi podróżami są wykluczane z wyników wyszukiwania. Gdy pole current_trips_present nie jest określone, a to pole ma wartość true, wyniki wyszukiwania mogą uwzględniać pojazdy z jedną aktywną podróżą ze stanem ENROUTE_TO_DROPOFF. Jeśli pole current_trips_present jest określone, nie można ustawić wartości prawda.

Wartością domyślną jest false.

trip_id

string

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

current_trips_present

CurrentTripsPresent

Ta wartość określa, czy pojazdy z aktywnymi podróżami kwalifikują się do tego wyszukiwania. Jeśli zasada trip_type zawiera SHARED, ta wartość musi być inna niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.

filter

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane przy wyszukiwaniu 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 określona jest wartość, która nie jest pusta, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

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 (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Maksymalna liczba ograniczeń dozwolona w zapytaniu filtra to 50.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami z atrybutami są porównania w postaci ciągów znaków. Aby można było porównać wartości z liczbami lub wartościami logicznymi, muszą one być ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").

CurrentTripsPresent

Określa rodzaje ograniczeń obowiązujących w bieżącej trasie pojazdu.

Wartości w polu enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Dostępność pojazdów, w których dostępne są podróże, jest określana w polu include_back_to_back.
NONE Pojazdy bez podróży mogą się wyświetlać w wynikach wyszukiwania. Gdy jest używana ta wartość, include_back_to_back nie może mieć wartości true.
ANY W wynikach wyszukiwania uwzględniane są pojazdy z maksymalnie 5 aktualnymi trasami i 10 punktami pośrednimi. Gdy jest używana ta wartość, include_back_to_back nie może mieć wartości true.

VehicleMatchOrder

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

Wartości w polu enum
UNKNOWN_VEHICLE_MATCH_ORDER Domyślnie używana w przypadku nieokreślonego lub nierozpoznanego dopasowania pojazdu do zamówienia.
PICKUP_POINT_ETA Rosnąco według czasu jazdy pojazdu do punktu odbioru.
PICKUP_POINT_DISTANCE Rosnąco według odległości jazdy pojazdem do punktu odbioru.
DROPOFF_POINT_ETA Rosnąco według czasu jazdy pojazdem do miejsca docelowego. Tego zamówienia można użyć tylko wtedy, gdy w prośbie podano punkt zwrotu.
PICKUP_POINT_STRAIGHT_DISTANCE Rosnąco według odległości w linii prostej od ostatniej zarejestrowanej lokalizacji pojazdu do punktu odbioru.
COST W kolejności rosnącej według skonfigurowanego kosztu dopasowania. Koszt dopasowania jest obliczony jako obliczenie ważone między odległością w linii prostej a szacowanym czasem dotarcia na miejsce. Wagi są ustalane z wartościami domyślnymi i można je modyfikować w zależności od klienta. Jeśli chcesz zmienić te wagi w projekcie, skontaktuj się z zespołem pomocy Google.

SearchVehiclesResponse

SearchVehicles odpowiedź.

Pola
matches[]

VehicleMatch

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

SpeedReadingInterval

Wskaźnik natężenia ruchu na przyległym odcinku ścieżki. Biorąc pod uwagę ścieżkę z punktami P_0, P_1, ... , P_N (indeks liczony od zera), parametr SpeedReadingInterval definiuje przedział i opisuje jego ruch za pomocą następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego interwału na ścieżce. Jeśli indeks w formacie JSON ma wartość 0, to pole będzie wyglądać na puste.

end_polyline_point_index

int32

Indeks końcowy tego interwału na ścieżce. Jeśli indeks w formacie JSON ma wartość 0, to pole będzie wyglądać na puste.

speed

Speed

Szybkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja prędkoś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 korków.
SLOW Wykryto korek, ale nie pojawił się korek.
TRAFFIC_JAM Wykryto korek.

StopLocation

Rzeczywiste miejsce, w którym zatrzymano się (odbiór/zwrot).

Pola
point

LatLng

To pole jest wymagane. Wskazuje rzeczywistą lokalizację.

timestamp

Timestamp

Wskazuje, kiedy doszło do zatrzymania.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Opisuje lokalizację punktu na trasie.

Pola
point

LatLng

To pole jest wymagane. 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.

TerminalPointId

Określa punkt końcowy.

Pola
value

string

Unikalny identyfikator punktu końcowego.

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

string

Rola wycofana.

generated_id
(deprecated)

string

Rola wycofana.

TrafficPolylineData

Informacje o natężeniu ruchu na oczekiwanej trasie pojazdu.

Pola
traffic_rendering

VisualTrafficReportPolylineRendering

Renderowanie za pomocą linii łamanej szybkości ruchu we wszystkich regionach na jednym odcinku przejazdu klienta.

Podróż

Metadane podróży.

Pola
name

string

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

vehicle_id

string

Identyfikator pojazdu podróżującego.

trip_status

TripStatus

Aktualny stan podróży.

trip_type

TripType

Typ podróży.

pickup_point

TerminalLocation

Lokalizacja, w której klient wskazuje, że zostanie odebrany.

actual_pickup_point

StopLocation

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

actual_pickup_arrival_point

StopLocation

Tylko wejście. Rzeczywista godzina i lokalizacja kierowcy na miejscu odbioru. To pole służy dostawcy do przesyłania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.

pickup_time

Timestamp

Tylko dane wyjściowe. Oszacowany czas przyjazdu pasażerów lub rzeczywista godzina przyjazdu tej osoby.

intermediate_destinations[]

TerminalLocation

Przesiadki pośrednie w kolejności, w której przyszła prośba o podróż (oprócz odbioru i zwrotu). Początkowo nie będzie ona dostępna w przypadku wspólnych podróży.

intermediate_destinations_version

Timestamp

Wskazuje czas ostatniej modyfikacji obiektu intermediate_destinations. Serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w funkcji UpdateTripRequest przy aktualizacji intermediate_destination_index, aby zapewnić, że intermediate_destinations nie ulegnie zmianie.

intermediate_destination_index

int32

Gdy TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, jest to liczba z zakresu [0..N-1] wskazująca, przez który trasę pośrednią pojazd przemieści się w następnej kolejności. 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. Tę wartość ustawia dostawca. Jeśli nie ma parametru intermediate_destinations, to pole jest ignorowane.

actual_intermediate_destination_arrival_points[]

StopLocation

Tylko wejście. Rzeczywiste miejsce przyjazdu kierowcy i miejsce przyjazdu do miejsca docelowego pośredniego. To pole służy dostawcy do przesyłania opinii na temat rzeczywistych informacji o przybyciu do miejsc pośrednich.

actual_intermediate_destinations[]

StopLocation

Tylko wejście. Rzeczywiste miejsce i czas odebrania klienta z pośredniego miejsca docelowego. To pole służy do przesyłania opinii na temat rzeczywistych informacji o odbiorze w pośrednich miejscach docelowych.

dropoff_point

TerminalLocation

Lokalizacja, w której klient wskazuje, że zostanie wysadzony.

actual_dropoff_point

StopLocation

Tylko wejście. Rzeczywiste miejsce oraz czas i miejsce wysyłki klienta. To pole służy do przesyłania opinii na temat rzeczywistych informacji o porzuceniu.

dropoff_time

Timestamp

Tylko dane wyjściowe. Oszacowany czas wysiedlenia pasażerów w miejscu docelowym lub szacowany czas wysiedlenia w przyszłości.

remaining_waypoints[]

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka od bieżącej lokalizacji do punktu docelowego włącznie. Ta ścieżka może zawierać punkty na trasie z innych tras.

vehicle_waypoints[]

TripWaypoint

To pole umożliwia ręczne porządkowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty pośrednie dla przypisanego pojazdu, jak również punkty na początku i końcu trasy w przypadku 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 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. Pamiętaj, że pierwszy punkt na trasie 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 tylko do użycia 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 tylko do użycia przez pakiety 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 tylko do użycia przez pakiety 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 tylko do użycia przez pakiety Driver SDK i Consumer SDK.

current_route_segment_end_point

TripWaypoint

Tylko dane wyjściowe. Punkt na trasie, gdzie kończy się current_route_segment.

remaining_distance_meters

Int32Value

Tylko dane wyjściowe. Pozostała odległość w polu current_route_segment. Wartość nie jest określona, jeśli podróż nie została przypisana do pojazdu albo jeśli podróż 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 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 godziny w strefie czasowej Trip.eta_to_first_waypoint. Wartość nie jest określona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

remaining_waypoints_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono obiekt remaining_waypoints (dodano, usunięto lub zmodyfikowano punkt na trasie).

remaining_waypoints_route_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono remaining_waypoints.path_to_waypoint i remaining_waypoints.traffic_to_waypoint. Aplikacja kliencka powinna buforować tę wartość i przekazywać ją w elemencie GetTripRequest, aby mieć pewność, że ścieżki i ruch generowany przez remaining_waypoints są zwracane tylko po ich zaktualizowaniu.

number_of_passengers

int32

Stałe. Wskazuje liczbę pasażerów tej podróży bez uwzględniania kierowcy. Aby można było zwrócić pojazd w odpowiedzi SearchVehicles, pojazd musi mieć dostępną pojemność.

last_location

VehicleLocation

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

last_location_snappable

bool

Tylko dane wyjściowe. Wskazuje, czy obiekt 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. Tę wartość oblicza Fleet Engine. Wszystkie aktualizacje klientów zostaną zignorowane.

view

TripView

Podzbiór wypełnionych pól dotyczących podróży i sposobu ich interpretacji.

TripStatus

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 statusu podróży.
NEW Nowo utworzona podróż.
ENROUTE_TO_PICKUP Kierowca jest w drodze do punktu odbioru.
ARRIVED_AT_PICKUP Kierowca dotarł do miejsca odbioru.
ARRIVED_AT_INTERMEDIATE_DESTINATION Kierowca dotarł do miejsca docelowego pośredniego i czeka na pasażera.
ENROUTE_TO_INTERMEDIATE_DESTINATION Kierowca jest w drodze do miejsca docelowego pośredniego (nie do miejsca zwrotu).
ENROUTE_TO_DROPOFF Kierowca podwoził pasażera i jedzie do następnego miejsca docelowego.
COMPLETE Pasażer został wysadzony, a podróż zakończona.
CANCELED Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub firmę oferującą wspólne przejazdy.

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 W podróży z innymi podróżami może brać udział pojazd.
EXCLUSIVE Podróż obejmuje tylko pojazd.

TripView

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

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API zostanie domyślnie ustawiony na widok SDK. W celu zapewnienia stabilności i obsługi klienta zalecamy wybranie TripView innego niż SDK.
SDK Obejmuje pola, których interpretacja lub obsługa za pomocą publicznie dostępnych bibliotek może nie być możliwa.
JOURNEY_SHARING_V1S Pola dotyczące podróży są wypełnione w przypadku korzystania z udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

TripWaypoint

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

Pola
location

TerminalLocation

Lokalizacja tego punktu na trasie.

trip_id

string

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

waypoint_type

WaypointType

Rola tego punktu pośredniego w podróży, taka jak odbiór lub przyjazd.

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

Zakodowana ścieżka z poprzedniego punktu na trasie do bieżącego.

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

traffic_to_waypoint

ConsumableTrafficPolyline

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

distance_meters

Int32Value

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

eta

Timestamp

Szacowany czas dotarcia do tego punktu na trasie. Wartość nieokreślona dla pierwszego punktu pośredniego na liście.

duration

Duration

Czas podróży z poprzedniego punktu na trasie do tego punktu. Wartość nieokreślona dla pierwszego punktu pośredniego na liście.

UpdateTripRequest

Komunikat z żądaniem UpdateTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

To pole jest wymagane. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-consumer-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

trip

Trip

To pole jest wymagane. Podróż powiązana z aktualizacją.

Poniższe pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą elementu 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

Przy aktualizacji elementu Trip.vehicle_id dla wspólnej 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 wartość Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie przejazdu pojazdu bez dodatkowych punktów pośrednich. Punkty na trasie należy ułożyć 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ą się przeplatać z żadnymi innymi trasami. Używane są pola trip_id, waypoint_type i location, a wszystkie pozostałe pola TripWaypoint w polu vehicle_waypoints są ignorowane.

Aby uniknąć spełnienia warunków wyścigu w przypadku podróży z wieloma miejscami docelowymi, podczas aktualizowania stanu podróży na ENROUTE_TO_INTERMEDIATE_DESTINATION podaj wartość Trip.intermediate_destinations_version. Przekazany plik Trip.intermediate_destinations_version musi być zgodny z wersją Fleet Engine. Jeśli tak nie jest, żądanie się nie powiedzie.

update_mask

FieldMask

To pole jest wymagane. Maska pola wskazująca pola, które w Podróżu mają zostać zaktualizowane. Pole update_mask musi zawierać co najmniej 1 pole.

UpdateVehicleAttributesRequest

UpdateVehicleAttributes wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

To pole jest wymagane. Musi mieć format providers/{provider}/vehicles/{vehicle}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) w projekcie Google Cloud, do którego należy konto usługi wywołujące to wywołanie.

attributes[]

VehicleAttribute

To pole jest wymagane. Atrybuty pojazdu do zaktualizowania. Wymienione atrybuty nie są zmieniane ani usuwane.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes odpowiedź.

Pola
attributes[]

VehicleAttribute

To pole jest wymagane. Zaktualizowana pełna lista atrybutów pojazdu, w tym nowe, zmienione i nienaruszone.

UpdateVehicleLocationRequest

UpdateVehicleLocation wiadomość z prośbą.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

current_location

VehicleLocation

To pole jest wymagane. ostatnia 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.

UpdateVehicleRequest

`Komunikat z prośbą o aktualizację pojazdu.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

vehicle

Vehicle

To pole jest wymagane. Wartości encji Vehicle, które mają zostać zastosowane. Podczas aktualizowania 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żna zaktualizować, ale musi ono zawierać wszystkie punkty pośrednie w pojeździe, które aktualnie znajdują się na pojeździe, bez żadnych innych punktów pośrednich.

update_mask

FieldMask

To pole jest wymagane. Maska pola wskazująca, które pola obiektu Vehicle mają zostać zaktualizowane. Musisz podać co najmniej jedną nazwę pola.

Pojazd

Metadane pojazdu.

Pola
name

string

Tylko dane wyjściowe. Unikalna nazwa tego 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 trip_id przejazdów, które obecnie są przypisane do tego pojazdu.

last_location

VehicleLocation

Ostatnio zgłoszona lokalizacja pojazdu.

maximum_capacity

int32

Łączna liczba pasażerów, którymi ten pojazd może przejechać. 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 100 atrybutów, a każdy atrybut musi mieć unikalny klucz.

vehicle_type

VehicleType

To pole jest wymagane. Typ pojazdu. Tych informacji można używać do filtrowania pojazdów w wynikach wyszukiwania w kategorii SearchVehicles. Wpływa też na szacowany czas dotarcia i trasę.

license_plate

LicensePlate

Informacje o tablicach rejestracyjnych pojazdu.

route[]
(deprecated)

TerminalLocation

Wycofane: użyj zasady Vehicle.waypoints.

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

Tylko wejście. Fleet Engine wykorzystuje te informacje do ulepszania udostępniania podróży. Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK sterownika.

current_route_segment_version

Timestamp

Tylko dane wyjściowe. Godzina, o której ustawiono current_route_segment. Może być przechowywany przez klienta i przekazywany w przyszłych żądaniach GetVehicle, aby zapobiegać zwróceniu tras, które nie uległy zmianie.

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Szacowany czas dotarcia na miejsce dla 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 wejście. 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 być zgodna z eta_to_first_waypointcurrent_time, jeśli wszystkie strony 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 pośrednie przypisane do tego pojazdu.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

Wskazuje, czy kierowca akceptuje przejazdy jedna po drugiej. 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 wejście. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę.

VehicleType

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 Każdy pojazd pełniący funkcję taksówki (zwykle licencjonowany lub podlegający regulacjom prawnym).
TRUCK Zwykle jest to pojazd o dużej pojemności.
TWO_WHEELER Motocykl, motorower lub inny pojazd dwukołowy
BICYCLE Transport napędzany przez człowieka.
PEDESTRIAN Osoba transportowa, zazwyczaj idąca lub biegająca, podróżująca po chodnikach.

VehicleAttribute

Opisuje atrybut pojazdu w postaci pary 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 typem typu double. vehicle_attribute_value może być tylko jedną z tych wartości:
string_value

string

Wartość atrybutu wpisanego przez ciąg znaków.

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

bool_value

bool

Wartość atrybutu o typie logicznym.

number_value

double

Podwójna wartość atrybutu.

VehicleAttributeList

Typ danych „lista list” dla atrybutów pojazdu.

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 dane są wysyłane do Fleet Engine, lokalizacja pojazdu jest lokalizacją GPS. Gdy otrzymasz informację o lokalizacji pojazdu, możesz podać lokalizację pojazdu według GPS, lokalizację dodatkową lub inną orientacyjną lokalizację. Źródło jest określone w polu location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj zasady latlng_accuracy.

latlng_accuracy

DoubleValue

Dokładność location w metrach jako promienia.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj zasady 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 zasady altitude_accuracy.

altitude_accuracy

DoubleValue

Dokładność altitude w metrach.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Prędkość pojazdu w metrach/s

speed_accuracy

DoubleValue

Dokładność speed w metrach/s.

update_time

Timestamp

Czas zgłoszenia wartości location przez czujnik, zgodny z jego zegarem.

server_time

Timestamp

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

location_sensor

LocationSensor

Dostawca danych o lokalizacji (np. GPS).

is_road_snapped

BoolValue

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

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

Tylko wejście. Czas (w sekundach) od wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (np. podczas ponownego uruchamiania aplikacji), ta wartość jest resetowana.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Przybliżona lokalizacja pojazdu (nieprzetworzona przez snappera).

raw_location_time

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

raw_location_sensor

LocationSensor

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

raw_location_accuracy

DoubleValue

Dokładność raw_location jako promienia w metrach.

supplemental_location

LatLng

Dodatkowa lokalizacja podana przez aplikację integracyjną.

supplemental_location_time

Timestamp

Sygnatura czasowa zwią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 jako promienia w metrach.

road_snapped
(deprecated)

bool

Wycofane: użyj zasady is_road_snapped.

VehicleMatch

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

Pola
vehicle

Vehicle

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

vehicle_pickup_eta

Timestamp

Szacowany czas dotarcia pojazdu do miejsca odbioru wskazanego w żądaniu. Pusta wartość oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli SearchVehiclesRequest.include_back_to_back to true, a ten pojazd ma aktywną podróż, vehicle_pickup_eta uwzględnia czas potrzebny do ukoń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 wszystkich pośrednich punktów odbioru lub miejsca zwrotu w przypadku dotychczasowych podróży. Ta odległość obejmuje obliczoną odległość (trasę) oraz odległość w linii prostej między punktem końcowym nawigacji a żądanym punktem odbioru. (Odległość między punktem końcowym nawigacji a żądanym punktem odbioru jest zwykle mała). Pusta wartość oznacza błąd przy obliczaniu odległości.

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

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

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

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

vehicle_match_type

VehicleMatchType

Typ dopasowania pojazdu.

requested_ordered_by

VehicleMatchOrder

Żądana kolejność sortowania pojazdów.

ordered_by

VehicleMatchOrder

Rzeczywiste zamówienie użyte w przypadku tego pojazdu. Zwykle ta wartość odpowiada polu „order_by” z żądania, ale w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, można użyć innej metody (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 udać się do punktu odbioru.
BACK_TO_BACK Pojazd jest obecnie przypisany do podróży, ale może przejść do punktu odbioru po zakończeniu trwającej podróży. Przy obliczaniu czasu dotarcia i dystansu uwzględnia się istniejącą trasę.
CARPOOL Pojazd ma wystarczającą pojemność na wspólne przejazdy.
CARPOOL_BACK_TO_BACK Pojazd zakończy swoją bieżącą, aktywną podróż, zanim dotrzesz do punktu odbioru. Przy obliczaniu czasu dotarcia i dystansu uwzględnia się istniejącą trasę.

VehicleState

Stan elementu Vehicle.

Wartości w polu enum
UNKNOWN_VEHICLE_STATE Wartość domyślna używana 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 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. Fragmenty dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia nie muszą się na siebie nakładać i nie muszą obejmować całej trasy.

Jeśli nie ma fragmentu drogi do stylu, klient powinien zastosować do trasy domyślne hasło.

RoadStretch

Jeden odcinek drogi do wyrenderowania.

Pola
style

Style

To pole jest wymagane. Styl, który ma zostać zastosowany.

offset_meters

int32

To pole jest wymagane. Styl powinien być stosowany między [offset_meters, offset_meters + length_meters).

length_meters

int32

To pole jest wymagane. Długość ścieżki, w której ma zostać zastosowany styl.

Styl

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

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

Punkt pośredni

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

Pola
lat_lng

LatLng

Lokalizacja tego punktu na trasie.

eta

Timestamp

Szacowany czas dotarcia pojazdu do tego punktu pośredniego.

WaypointType

Typ punktu na trasie.

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, za których pomocą możesz zostawić pasażerów lub przedmioty.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie podczas podróży obejmujących wiele miejsc.