Indeks
TripService
(interfejs)VehicleService
(interfejs)BatteryInfo
(komunikat)BatteryStatus
(wyliczenie)BillingPlatformIdentifier
(wyliczenie)ConsumableTrafficPolyline
(komunikat)CreateTripRequest
(komunikat)CreateVehicleRequest
(komunikat)DeviceSettings
(komunikat)GetTripRequest
(komunikat)GetVehicleRequest
(komunikat)LicensePlate
(komunikat)ListVehiclesRequest
(komunikat)ListVehiclesResponse
(komunikat)LocationPowerSaveMode
(wyliczenie)LocationSensor
(wyliczenie)NavigationStatus
(wyliczenie)PolylineFormatType
(wyliczenie)PowerSource
(wyliczenie)ReportBillableTripRequest
(komunikat)ReportBillableTripRequest.SolutionType
(wyliczenie)RequestHeader
(komunikat)RequestHeader.Platform
(wyliczenie)RequestHeader.SdkType
(wyliczenie)SearchTripsRequest
(komunikat)SearchTripsResponse
(komunikat)SearchVehiclesRequest
(komunikat)SearchVehiclesRequest.CurrentTripsPresent
(wyliczenie)SearchVehiclesRequest.VehicleMatchOrder
(wyliczenie)SearchVehiclesResponse
(komunikat)SpeedReadingInterval
(komunikat)SpeedReadingInterval.Speed
(wyliczenie)StopLocation
(komunikat)TerminalLocation
(komunikat)TerminalPointId
(komunikat) (wycofane)TrafficPolylineData
(komunikat)Trip
(komunikat)TripStatus
(wyliczenie)TripType
(wyliczenie)TripView
(wyliczenie)TripWaypoint
(komunikat)UpdateTripRequest
(komunikat)UpdateVehicleAttributesRequest
(komunikat)UpdateVehicleAttributesResponse
(komunikat)UpdateVehicleRequest
(komunikat)Vehicle
(komunikat)Vehicle.VehicleType
(komunikat)Vehicle.VehicleType.Category
(wyliczenie)VehicleAttribute
(komunikat)VehicleAttributeList
(komunikat)VehicleLocation
(komunikat)VehicleMatch
(komunikat)VehicleMatch.VehicleMatchType
(wyliczenie)VehicleState
(wyliczenie)VisualTrafficReportPolylineRendering
(komunikat)VisualTrafficReportPolylineRendering.RoadStretch
(komunikat)VisualTrafficReportPolylineRendering.RoadStretch.Style
(wyliczenie)Waypoint
(komunikat)WaypointType
(wyliczenie)
TripService
Usługa zarządzania podróżami.
CreateTrip |
---|
Tworzy podróż we Fleet Engine i zwraca nową podróż. |
GetTrip |
---|
Informacje o pojedynczej podróży. |
ReportBillableTrip |
---|
Zgłoś płatne wykorzystanie podróży. |
SearchTrips |
---|
Znajdziesz tu wszystkie dane dotyczące podróży konkretnym pojazdem. |
UpdateTrip |
---|
Aktualizuje dane o podróży. |
VehicleService
Zarządzanie pojazdami.
CreateVehicle |
---|
Tworzony jest nowy pojazd powiązany z usługą wspólnych przejazdów na żądanie lub z dostawcą. Każdy element Podczas tworzenia
Podczas tworzenia
Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostały podane. |
GetVehicle |
---|
Zwraca pojazd z Fleet Engine. |
ListVehicles |
---|
Zwraca podzieloną na strony listę pojazdów powiązanych z dostawcą, które pasują do opcji żądania. |
SearchVehicles |
---|
Zwraca listę pojazdów, które pasują do opcji żądania. |
UpdateVehicle |
---|
Zapisuje zaktualizowane dane pojazdów we Fleet Engine. Podczas aktualizowania elementu
Nie można zaktualizować pojazdu Jeśli pole |
UpdateVehicleAttributes |
---|
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 |
BatteryInfo
Informacje o baterii urządzenia.
Pola | |
---|---|
battery_status |
Stan baterii, stan naładowania, stan naładowania itd. |
power_source |
Stan źródła zasilania baterii. |
battery_percentage |
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 |
Trwa ładowanie baterii. |
BATTERY_STATUS_DISCHARGING |
Bateria się rozładowuje. |
BATTERY_STATUS_FULL |
Bateria jest naładowana. |
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żywane w przypadku nieokreślonych platform. |
SERVER |
Platforma jest serwerem klienta. |
WEB |
Platforma jest przeglądarką. |
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[] |
Prędkość ruchu na trasie od poprzedniego punktu do bieżącego punktu pośredniego. |
encoded_path_to_waypoint |
Ścieżka, którą podąża kierowca od poprzedniego punktu do bieżącego punktu. Na tej ścieżce znajdują się punkty orientacyjne, dzięki którym klienci mogą wyświetlać oznaczenia natężenia ruchu (patrz |
CreateTripRequest
Wiadomość z żądaniem CreateTrip.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
trip_id |
Wymagane. Unikalny identyfikator podróży. Obowiązują następujące ograniczenia:
|
trip |
Wymagane. Element podróży do utworzenia. Podczas tworzenia podróży musisz wypełnić te pola:
Te pola będą używane, jeśli je podasz:
Wszystkie pozostałe pola Podróż są ignorowane. Na przykład wszystkie podróże zaczynają się od Tylko podróże ( Jeśli ustawienie Jeśli podasz Pola |
CreateVehicleRequest
Wiadomość z prośbą: CreateVehicle
.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
vehicle_id |
Wymagane. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:
|
vehicle |
Wymagane. Podmiot Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić te pola:
Podczas tworzenia pojazdu ignorowane są te pola:
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 |
Jak funkcje lokalizacji działają na urządzeniu po włączeniu oszczędzania baterii. |
is_power_save_mode |
Określa, czy urządzenie jest obecnie w trybie oszczędzania energii. |
is_interactive |
Wskazuje, czy urządzenie jest w trybie interaktywnym. |
battery_info |
Informacje o stanie baterii. |
GetTripRequest
Wiadomość z żądaniem GetTrip.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
view |
Podzbiór pól Podróży, które powinny zostać zwrócone, i ich interpretacji. |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane z kategorii |
remaining_waypoints_version |
Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są |
route_format_type |
Zwracany bieżący format trasy: |
current_route_segment_traffic_version |
Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik |
remaining_waypoints_route_version |
Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane z kategorii |
GetVehicleRequest
Wiadomość z prośbą: GetVehicle
.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik |
waypoints_version |
Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane funkcji |
LicensePlate
Informacje o tablicach rejestracyjnych 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 |
Wymagane. Kod kraju/regionu CLDR. Na przykład |
last_character |
Ostatnia cyfra tablicy rejestracyjnej lub „-1” oznacza brak wartości liczbowej na tablicy rejestracyjnej.
|
ListVehiclesRequest
Wiadomość z prośbą: ListVehicles
.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
page_size |
Maksymalna liczba pojazdów do zwrotu. Wartość domyślna: 100. |
page_token |
Wartość pola |
minimum_capacity |
Określa wymaganą minimalną pojemność pojazdu. W przypadku wszystkich zwróconych pojazdów wartość |
trip_types[] |
Ogranicza odpowiedź do pojazdów, które obsługują co najmniej jeden z podanych typów podróży. |
maximum_staleness |
Ogranicza odpowiedź do pojazdów, które w określonym czasie wysłały aktualizacje lokalizacji do Fleet Engine. Stacjonarne pojazdy, które nadal przesyłają swoje lokalizacje, nie są uznawane za nieaktualne. Jeśli występuje, musi mieć prawidłową wartość dodatnią. |
vehicle_type_categories[] |
Wymagane. Ogranicza odpowiedź do pojazdów z jedną z określonych kategorii typów. |
required_attributes[] |
Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól
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[] |
Ogranicza odpowiedź do pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym elemencie |
required_one_of_attribute_sets[] |
Podobnie jak w zasadzie
Ogranicza odpowiedź do pojazdów pasujących do wszystkich atrybutów w atrybucie |
vehicle_state |
Ogranicza odpowiedź do pojazdów w tym stanie. |
on_trip_only |
Zwracaj tylko te pojazdy, które są obecnie dostępne. |
filter |
Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyświetlaniu listy pojazdów. Przykłady składni filtrów znajdziesz na stronie http://aip.dev/160. To pole zastępuje pola Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (na przykład 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ównać wartości z wartościami liczbowymi lub logicznymi, wartości muszą być jawnie ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. |
viewport |
Opcjonalnie: Filtr ograniczający liczbę pojazdów zwracanych do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze. |
ListVehiclesResponse
ListVehicles
odpowiedź.
Pola | |
---|---|
vehicles[] |
Pojazdy spełniające kryteria zapytania. Maksymalna liczba zwróconych pojazdów jest określana przez pole |
next_page_token |
Token umożliwiający pobranie następnej strony pojazdów lub pusty, jeśli nie ma więcej pojazdów spełniających kryteria żądania. |
total_size |
Wymagane. Łączna liczba pojazdów spełniających kryteria żądania na wszystkich stronach. |
LocationPowerSaveMode
Jak są skonfigurowane funkcje lokalizacji do działania na urządzeniu mobilnym po włączeniu trybu „Oszczędzanie baterii” jest włączona. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Wartości w polu enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
Niezdefiniowany tryb oszczędzania lokalizacji |
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 lokalizacji wykorzystujący GPS powinien być wyłączony, gdy jest włączone oszczędzanie baterii, a urządzenie nie jest interaktywne. |
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 |
Wszyscy dostawcy lokalizacji będą dostępni, ale poprawki lokalizacji należy udostępniać tylko w przypadku aplikacji działających 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 używana 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 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 udostępniane przez last_location.supplemental_location_sensor pojazdu. |
FLEET_ENGINE_LOCATION |
Lokalizacja obliczana przez Fleet Engine na podstawie dostępnych dla niej sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli otrzyma ją w żądaniu. |
FUSED_LOCATION_PROVIDER |
Dostawca uśrednionej lokalizacji na Androidzie. |
CORE_LOCATION |
Dostawca lokalizacji w systemach operacyjnych Apple. |
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 |
Jego źródłem zasilania jest ładowarka sieciowa. |
POWER_SOURCE_USB |
Źródło zasilania to port USB. |
POWER_SOURCE_WIRELESS |
Źródło zasilania jest bezprzewodowe. |
POWER_SOURCE_UNPLUGGED |
Bateria jest odłączona. |
ReportBillableTripRequest
Wiadomość z żądaniem ReportBillableTrip.
Pola | |
---|---|
name |
Wymagane. Musi mieć format |
country_code |
Wymagane. Dwuliterowy kod kraju, w którym odbywa się podróż. Cena jest określona na podstawie kodu kraju. |
platform |
Platforma, na której przesłano żądanie. |
related_ids[] |
Identyfikatory, które są bezpośrednio związane ze zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) operacji wstępnej rezerwacji wykonanych przed udostępnieniem identyfikatora podróży. Liczba |
solution_type |
Typ rozwiązania GMP (np. |
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 funkcja wspólnych przejazdów i podróży z dostawą dostępna na żądanie. |
RequestHeader
Pole RequestHeader zawiera pola wspólne dla wszystkich żądań RPC Fleet Engine.
Pola | |
---|---|
language_code |
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: |
region_code |
Wymagane. Kod regionu CLDR regionu, z którego pochodzi żądanie. Przykład wartości pola: |
sdk_version |
Wersja pakietu SDK wywołującego (jeśli dotyczy). Format wersji to „major.minor.patch”, np. |
os_version |
Wersja systemu operacyjnego, w którym działa pakiet SDK wywołujący. Przykłady wartości pól: |
device_model |
Model urządzenia, na którym działa pakiet SDK wywołujący. Przykłady wartości pól: |
sdk_type |
Typ pakietu SDK, który wysyła żądanie. |
maps_sdk_version |
Wersja pakietu SDK MapSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. |
nav_sdk_version |
Wersja pakietu NavSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. |
platform |
Platforma pakietu SDK wywołującego. |
manufacturer |
Producent urządzenia z Androidem z pakietu SDK wywołującego. Dotyczy tylko pakietów Android SDK. Przykład wartości pola: |
android_api_level |
Poziom interfejsu API Androida wywołującego pakiet SDK, dotyczy tylko pakietów Android SDK. Przykład wartości pola: |
trace_id |
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 w przypadku pominięcia platformy. |
ANDROID |
Prośba pochodzi z Androida. |
IOS |
Prośba 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 wersja konsumenta. |
DRIVER |
Wywołujący pakiet SDK to sterownik. |
JAVASCRIPT |
Wywoływanie SDK to JavaScript. |
SearchTripsRequest
Komunikat żądania SearchTrips.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
vehicle_id |
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ą:
|
active_trips_only |
Jeśli ma wartość Prawda, odpowiedź będzie obejmować Podróże, które mają wpływ na trasę kierowcy. |
page_size |
Jeśli jej nie skonfigurujesz, serwer decyduje o liczbie wyników do zwrócenia. |
page_token |
Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwrócona w polu |
minimum_staleness |
Jeśli został podany, zwraca podróże, które nie zostały zaktualizowane po czasie |
SearchTripsResponse
Komunikat odpowiedzi SearchTrips.
Pola | |
---|---|
trips[] |
Lista przejazdów żądanym pojazdem. |
next_page_token |
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 |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
pickup_point |
Wymagane. Punkt odbioru w pobliżu. |
dropoff_point |
Zamierzone miejsce dostawy klienta. Pole jest wymagane, jeśli |
pickup_radius_meters |
Wymagane. Określa promień wyszukiwania pojazdu wokół punktu odbioru. Zwrócone zostaną tylko pojazdy znajdujące się w promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie). |
count |
Wymagane. Określa maksymalną liczbę pojazdów do zwrotu. Wartość musi znajdować się w zakresie od 1 do 50 (włącznie). |
minimum_capacity |
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[] |
Wymagane. Reprezentuje typ proponowanej podróży. Musi zawierać dokładnie 1 typ. |
maximum_staleness |
Ogranicza wyszukiwanie tylko do tych pojazdów, które w określonym czasie wysłały aktualizacje lokalizacji do Fleet Engine. Stacjonarne pojazdy, które nadal przesyłają swoje lokalizacje, nie są uznawane za nieaktualne. Jeśli to pole nie jest skonfigurowane, serwer ustawia domyślną wartość z pięciu minut. |
vehicle_types[] |
Wymagane. Ogranicza wyszukiwanie do pojazdów jednego z określonych typów. Należy określić co najmniej jeden typ pojazdu. Typy pojazdów o kategorii |
required_attributes[] |
Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól
Ogranicza wyszukiwanie 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. |
required_one_of_attributes[] |
Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym |
required_one_of_attribute_sets[] |
Podobnie jak w zasadzie
Ogranicza wyszukiwanie tylko do pojazdów mających wszystkie atrybuty w atrybucie |
order_by |
Wymagane. Określa żądane kryterium kolejności wyników. |
include_back_to_back |
Wskazuje, czy do tego wyszukiwania kwalifikują się pojazdy z pojedynczą aktywną podróżą. To pole jest używane tylko wtedy, gdy pole Wartością domyślną jest |
trip_id |
Wskazuje podróż powiązaną z tym obiektem: |
current_trips_present |
Wskazuje, czy do tego wyszukiwania kwalifikują się pojazdy, które aktywnie podróżują. Jeśli parametr |
filter |
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 zastępuje pola Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (na przykład 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ównać wartości z wartościami liczbowymi lub logicznymi, wartości muszą być jawnie ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. |
CurrentTripsPresent
Określa rodzaje ograniczeń dotyczących bieżącej trasy pojazdu.
Wartości w polu enum | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Dostępność pojazdów z możliwością podróży jest określana w polu include_back_to_back . |
NONE |
Pojazdy, które nie będą przejazdami, mogą pojawiać się w wynikach wyszukiwania. W przypadku użycia tej wartości dyrektywa include_back_to_back nie może być ustawiona jako true . |
ANY |
W wynikach wyszukiwania uwzględniane są pojazdy, z którymi aktualnie pokonuje się maks. 5 tras i 10 punktów pośrednich. W przypadku użycia tej wartości dyrektywa include_back_to_back nie może być ustawiona jako true . |
VehicleMatchOrder
Określa kolejność dopasowań 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. |
PICKUP_POINT_ETA |
Rosnąco według czasu przejazdu pojazdu do punktu odbioru. |
PICKUP_POINT_DISTANCE |
Rosnąco według odległości pojazdu do punktu odbioru. |
DROPOFF_POINT_ETA |
Kolejność rosnąca według czasu przejazdu pojazdu do punktu nadania. Tego zamówienia można użyć tylko wtedy, gdy punkt zwrotu jest określony w żądaniu. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Kolejność rosnąca według bezpośredniej odległości od ostatniej zgłoszonej 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[] |
Lista pojazdów spełniających kryteria |
SpeedReadingInterval
Wskaźnik natężenia ruchu na sąsiadującym odcinku ścieżki. Biorąc pod uwagę ścieżkę z punktami P_0, P_1, ... , P_N (indeks liczony od zera), SpeedReadingInterval definiuje interwał i opisuje ruch przy użyciu następujących kategorii.
Pola | |
---|---|
start_polyline_point_index |
Indeks początkowy tego interwału w ścieżce. Jeśli indeks w pliku JSON wynosi 0, pole będzie puste. |
end_polyline_point_index |
Indeks końcowy tego przedziału w ścieżce. Jeśli indeks w pliku JSON wynosi 0, pole będzie puste. |
speed |
Prędkość ruchu w tym przedziale czasu. |
Szybkość
Klasyfikacja prędkości linii łamanej na podstawie danych o natężeniu 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 korek, ale nie było żadnych korków. |
TRAFFIC_JAM |
Wykryto korek. |
StopLocation
Rzeczywista lokalizacja, w której miała miejsce przystanek (odbiór/zwrot).
Pola | |
---|---|
point |
Wymagane. Wskazuje rzeczywistą lokalizację. |
timestamp |
Wskazuje, kiedy doszło do postoju. |
stop_time |
Tylko dane wejściowe. Rola wycofana. Użyj pola sygnatury czasowej. |
TerminalLocation
Opisuje lokalizację punktu pośredniego.
Pola | |
---|---|
point |
Wymagane. Wskazuje lokalizację punktu pośredniego podróży. |
terminal_point_id |
Wycofano: zamiast tego podaj pole |
access_point_id |
Wycofano: zamiast tego podaj pole |
trip_id |
Rola wycofana. |
terminal_location_type |
Wycofano: te dane będą dostępne dla: |
TerminalPointId
Wycofano: Fleet Engine nie obsługuje już punktów TerminalPoint. Użyj w zamian zasady TerminalLocation.point
.
Pola | |
---|---|
value |
Rola wycofana. |
Pole sumy Id . Rola wycofana. Id może mieć tylko jedną z tych wartości: |
|
place_id |
Rola wycofana. |
generated_id |
Rola wycofana. |
TrafficPolylineData
Warunki na drodze do oczekiwanej trasy pojazdu.
Pola | |
---|---|
traffic_rendering |
Renderowanie łamane pokazujące prędkość ruchu we wszystkich regionach na jednym odcinku przejazdu klienta. |
Podróż
Metadane podróży.
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}” |
vehicle_id |
Identyfikator pojazdu, który pokonuje tę podróż. |
trip_status |
Bieżący stan podróży. |
trip_type |
Typ podróży. |
pickup_point |
Miejsce, w którym klient wskazuje, że zostanie odebrany. |
actual_pickup_point |
Tylko dane wejściowe. Rzeczywista lokalizacja i miejsce odbioru klienta. To pole jest przeznaczone dla usługodawcy do przekazywania opinii na temat rzeczywistych informacji o odbiorze. |
actual_pickup_arrival_point |
Tylko dane wejściowe. Rzeczywista godzina przyjazdu kierowcy do punktu odbioru i lokalizacja kierowcy. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru. |
pickup_time |
Tylko dane wyjściowe. Szacowana godzina przyjazdu pasażerów lub faktyczna godzina ich odebrania w przyszłości. |
intermediate_destinations[] |
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 |
Wskazuje, kiedy po raz ostatni zmodyfikowano |
intermediate_destination_index |
Jeśli |
actual_intermediate_destination_arrival_points[] |
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[] |
Tylko dane wejściowe. Rzeczywisty czas i miejsce odbioru klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania informacji o rzeczywistych informacjach o odbiorze w miejscach docelowych pośrednich. |
dropoff_point |
Lokalizacja, w której klient wskazuje, że zostanie odesłany. |
actual_dropoff_point |
Tylko dane wejściowe. Rzeczywiste miejsce i godzinę odejścia klienta. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o rezygnacji. |
dropoff_time |
Tylko dane wyjściowe. Szacowana godzina, o której pasażerowie wysiądą w przyszłości, albo godzina, o której pasażerowie wysiądzie. |
remaining_waypoints[] |
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[] |
To pole umożliwia ręczne porządkowanie punktów na trasie dla podróży. Zawiera wszystkie pozostałe punkty na trasie dla przypisanego pojazdu, a także punkty odbioru i zakończenia podróży dla 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ń |
route[] |
Tylko dane wyjściowe. Przewidywana trasa do pierwszego wejścia w pozostałe punkty pośrednie. Pamiętaj, że pierwszy punkt pośredni może należeć do innej podróży. |
current_route_segment |
Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu pośredniego. 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 |
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 |
Tylko dane wyjściowe. Wskazuje natężenie ruchu na drodze Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. |
current_route_segment_traffic_version |
Tylko dane wyjściowe. Wskazuje, kiedy po raz ostatni zmodyfikowano Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. |
current_route_segment_end_point |
Tylko dane wyjściowe. Punkt na trasie, w którym kończy się |
remaining_distance_meters |
Tylko dane wyjściowe. Pozostała odległość samochodem podana w polu |
eta_to_first_waypoint |
Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu |
remaining_time_to_first_waypoint |
Tylko dane wyjściowe. Czas od zwrócenia danych o podróży do momentu w polu |
remaining_waypoints_version |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono element |
remaining_waypoints_route_version |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano |
number_of_passengers |
Stała. Wskazuje liczbę pasażerów tej podróży bez uwzględniania kierowcy. Pojazd musi mieć dostępną pojemność, aby można go było zwrócić w odpowiedzi |
last_location |
Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie. |
last_location_snappable |
Tylko dane wyjściowe. Wskazuje, czy atrybut |
view |
Podzbiór pól Podróże, które zostały wypełnione 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 pośredniego miejsca docelowego (nie do punktu nadania). |
ENROUTE_TO_DROPOFF |
Kierowca zabierze pasażera i jest w drodze do następnego miejsca docelowego. |
COMPLETE |
Pasażer wysiądzie i podróż się zakończyła. |
CANCELED |
Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub dostawcę wspólnych przejazdów. |
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 ramach tej podróży pojazdem może podróżować inne osoby. |
EXCLUSIVE |
Przejażdżka jest dostępna wyłącznie dla pojazdu. |
TripView
Selektor różnych zestawów pól Podróż w odpowiedzi GetTrip
. Kontekst znajdziesz na stronie AIP-157. Prawdopodobnie uda się dodać więcej widoków.
Wartości w polu enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API domyślnie użyje widoku pakietu SDK. Aby zapewnić stabilność i wsparcie, klienci powinni wybrać TripView inne 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 zastosowania funkcji udostępniania 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 |
Lokalizacja tego punktu na trasie. |
trip_id |
Podróż powiązana z tym punktem na trasie. |
waypoint_type |
Rola, jaką ten punkt pośredni odgrywa w danej podróży, np. w przypadku odbioru lub zwrotu. |
path_to_waypoint[] |
Ścieżka od poprzedniego punktu do bieżącego. Nieokreślony dla pierwszego punktu na liście. To pole jest wypełniane tylko na żądanie. |
encoded_path_to_waypoint |
Zakodowana ścieżka od poprzedniego punktu do bieżącego. Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane. |
traffic_to_waypoint |
Informacje o natężeniu ruchu na trasie do tego punktu pośredniego. 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 |
Odległość ścieżki od poprzedniego punktu pośredniego do bieżącego. Nieokreślony dla pierwszego punktu na liście. |
eta |
Szacowany czas dotarcia do tego punktu na trasie. Nieokreślony dla pierwszego punktu na liście. |
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 |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
trip |
Wymagane. Podróż powiązana z aktualizacją. Poniższe pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą Trip.update.
Kiedy aktualizujesz Jeśli podasz Aby uniknąć warunku wyścigu w przypadku podróży obejmujących wiele miejsc docelowych, podczas aktualizowania stanu podróży na |
update_mask |
Wymagane. Maska pola wskazująca, które pola w Podróży mają zostać zaktualizowane. |
UpdateVehicleAttributesRequest
Wiadomość z prośbą: UpdateVehicleAttributes
.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
attributes[] |
Wymagane. Atrybuty pojazdu do zaktualizowania. Atrybuty, które nie są wymienione, nie są zmieniane ani usuwane. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
odpowiedź.
Pola | |
---|---|
attributes[] |
Wymagane. Zaktualizowana pełna lista atrybutów pojazdów, w tym nowych, zmienionych i niezmienionych atrybutów. |
UpdateVehicleRequest
„Zaktualizuj wiadomość z prośbą o pojazd.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
vehicle |
Wymagane. Wartości elementu
Jeśli pole Pole |
update_mask |
Wymagane. Maska pola wskazująca, które pola obiektu |
Pojazd
Metadane pojazdu.
Pola | |
---|---|
name |
Tylko dane wyjściowe. Niepowtarzalna nazwa tego pojazdu. Format to |
vehicle_state |
Stan pojazdu. |
supported_trip_types[] |
Typy podróży obsługiwane przez ten pojazd. |
current_trips[] |
Tylko dane wyjściowe. Lista |
last_location |
Ostatnio zgłoszona lokalizacja pojazdu. |
maximum_capacity |
Łączna liczba osób, które może przewieźć ten pojazd. Kierowca nie jest uwzględniany w tej wartości. Ta wartość nie może być mniejsza niż 1. |
attributes[] |
Lista atrybutów pojazdu. Pojazd może mieć maksymalnie 100 atrybutów, a każdy atrybut musi mieć unikalny klucz. |
vehicle_type |
Wymagane. Typ tego pojazdu. Może służyć do filtrowania pojazdów w wynikach wyszukiwania w usłudze |
license_plate |
Informacje o tablicach rejestracyjnych pojazdu. |
route[] |
Wycofane: użyj atrybutu |
current_route_segment |
Linia łamana określająca trasę, którą aplikacja kierowcy zamierza podążać do następnego punktu pośredniego. Ta lista jest też zwracana w języku Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK. Dekodowanie nie jest jeszcze obsługiwane. |
current_route_segment_traffic |
Tylko dane wejściowe. Fleet Engine używa tych informacji do ulepszania udostępniania przejazdów. Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK. |
current_route_segment_version |
Tylko dane wyjściowe. Czas ustawienia parametru |
current_route_segment_end_point |
Punkt na trasie, w którym kończy się |
remaining_distance_meters |
Pozostały dystans jazdy samochodem przez |
eta_to_first_waypoint |
Szacowany czas dotarcia na miejsce do pierwszego wpisu w polu Podczas aktualizowania pojazdu zasada |
remaining_time_seconds |
Tylko dane wejściowe. Pozostały czas jazdy samochodem Podczas aktualizowania pojazdu zasada |
waypoints[] |
Pozostałe punkty na trasie przypisane do tego pojazdu. |
waypoints_version |
Tylko dane wyjściowe. Data ostatniej aktualizacji pola |
back_to_back_enabled |
Wskazuje, czy kierowca akceptuje połączenia w obie strony. Jeśli zasada |
navigation_status |
Stan nawigacji pojazdu. |
device_settings |
Tylko dane wejściowe. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę. |
VehicleType
Typ pojazdu.
Pola | |
---|---|
category |
Kategoria typu pojazdu |
Kategoria
Kategorie typów pojazdów
Wartości w polu enum | |
---|---|
UNKNOWN |
Domyślnie 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 |
Osobisty środek transportu, zwykle pieszo lub biegnący po ścieżkach. |
VehicleAttribute
Opisuje atrybut pojazdu w postaci pary klucz-wartość. Pole „klucz:wartość” Długość ciągu znaków nie może przekraczać 256 znaków.
Pola | |
---|---|
key |
Klucz atrybutu. Klucze nie mogą zawierać znaku dwukropka (:). |
value |
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 mieć tylko jedną z tych wartości: |
|
string_value |
Wartość atrybutu z ciągiem znaków. Uwaga: działa tak samo jak pole |
bool_value |
Wartość atrybutu wpisanego z użyciem wartości logicznej. |
number_value |
Wartość atrybutu została wpisana dwukrotnie. |
VehicleAttributeList
Typ danych listy list dla atrybutów pojazdów.
Pola | |
---|---|
attributes[] |
Lista atrybutów w tej kolekcji. |
VehicleLocation
lokalizacja, prędkość i kierunek pojazdu w określonym czasie;
Pola | |
---|---|
location |
Lokalizacja pojazdu. Gdy jest on wysyłany do Fleet Engine, lokalizacją pojazdu jest 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 polu |
horizontal_accuracy |
Wycofane: użyj atrybutu |
latlng_accuracy |
Dokładność promienia |
heading |
Kierunek, w którym pojazd porusza się w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360). |
bearing_accuracy |
Wycofane: użyj atrybutu |
heading_accuracy |
Dokładność: |
altitude |
Wysokość w metrach nad WGS84. |
vertical_accuracy |
Wycofane: użyj atrybutu |
altitude_accuracy |
Dokładność: |
speed_kmph |
Prędkość pojazdu w kilometrach na godzinę. Wycofane: użyj atrybutu |
speed |
Prędkość pojazdu w metrach/s |
speed_accuracy |
Dokładność |
update_time |
Godzina, o której czujnik ( |
server_time |
Tylko dane wyjściowe. Czas otrzymania przez serwer informacji o lokalizacji. |
location_sensor |
Dostawca danych o lokalizacji (np. |
is_road_snapped |
Określa, czy obiekt |
is_gps_sensor_enabled |
Tylko dane wejściowe. Wskazuje, czy czujnik GPS jest włączony w urządzeniu mobilnym. |
time_since_update |
Tylko dane wejściowe. Czas (w sekundach) od momentu wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (na przykład po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do 0. |
num_stale_updates |
Tylko dane wejściowe. Wycofane: do określenia, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały. |
raw_location |
Nieprzetworzona lokalizacja pojazdu (nieprzetworzona przez narzędzie do wykrywania dróg). |
raw_location_time |
Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją. |
raw_location_sensor |
Źródło nieprzetworzonej lokalizacji. Domyślna wartość to |
raw_location_accuracy |
Dokładność |
supplemental_location |
Dodatkowa lokalizacja udostępniana przez aplikację integracyjną. |
supplemental_location_time |
Sygnatura czasowa powiązana z dodatkową lokalizacją. |
supplemental_location_sensor |
Źródło dodatkowej lokalizacji. Domyślna wartość to |
supplemental_location_accuracy |
Dokładność |
road_snapped |
Wycofane: użyj atrybutu |
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 |
Wymagane. Pojazd zgodny z żądaniem. |
vehicle_pickup_eta |
Szacowany czas dotarcia pojazdu na miejsce do punktu odbioru określonego w żądaniu. Pusta wartość oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli |
vehicle_pickup_distance_meters |
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). Pusta wartość oznacza błąd podczas obliczania odległości. |
vehicle_pickup_straight_line_distance_meters |
Wymagane. Długość linii prostej między pojazdem a punktem odbioru określonego w żądaniu. |
vehicle_dropoff_eta |
Szacowany czas dotarcia na miejsce z całego pojazdu do punktu postoju wskazanego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje zatrzymanie w dowolnym punkcie pośrednim przed |
vehicle_pickup_to_dropoff_distance_meters |
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 |
trip_type |
Wymagane. Rodzaj podróży użyty w żądaniu, który został użyty do obliczenia szacowanego czasu dotarcia do punktu odbioru. |
vehicle_trips_waypoints[] |
Uporządkowana lista punktów na trasie używanych do obliczania szacowanego czasu dotarcia na miejsce. Lista zawiera lokalizację pojazdu, punkty odbioru aktywnych podróży i punkty odbioru podane w prośbie. Pusta lista oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce. |
vehicle_match_type |
Typ dopasowania pojazdu. |
requested_ordered_by |
Zażądano kolejności sortowania zgodnych pojazdów. |
ordered_by |
Rzeczywiste zamówienie użyte w przypadku tego pojazdu. Normalnie wartość będzie pasować do parametru „order_by” z żądania; jednak w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, można użyć innej metody (takiej jak |
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 podróży, ale po zakończeniu trwającej podróży może przejść do punktu odbioru. Przy obliczaniu szacowanego czasu dotarcia na miejsce i dystansu brana jest pod uwagę dotychczasowa podróż. |
CARPOOL |
Pojazd ma wystarczającą pojemność do wspólnego przejazdu. |
CARPOOL_BACK_TO_BACK |
Pojazd zakończy bieżącą, aktywną podróż, zanim dotrze do punktu odbioru. Przy obliczaniu szacowanego czasu dotarcia na miejsce i dystansu brana jest pod uwagę dotychczasowa podróż. |
VehicleState
Stan elementu Vehicle
.
Wartości w polu enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
Domyślna używana 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 podróże. |
VisualTrafficReportPolylineRendering
Opisuje, jak klienci powinni kolorować jedną część linii łamanej na trasie.
Pola | |
---|---|
road_stretch[] |
Opcjonalnie: Odcinki dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia nie nakładają się na siebie i nie muszą obejmować całej trasy. Jeśli nie ma rozciągania drogi do stylu, klient powinien zastosować do trasy domyślną wartość. |
RoadStretch
Jeden odcinek drogi do wyrenderowania.
Pola | |
---|---|
style |
Wymagane. Styl, który ma zostać zastosowany. |
offset_meters |
Wymagane. Styl powinien być stosowany między |
length_meters |
Wymagane. Długość ścieżki, w której chcesz zastosować styl. |
Styl
Styl ruchu wskazujący prędkość ruchu.
Wartości w polu enum | |
---|---|
STYLE_UNSPECIFIED |
Nie wybrano stylu. |
SLOWER_TRAFFIC |
Ruch jest zwalniany. |
TRAFFIC_JAM |
Występuje korek. |
Punkt pośredni
Opisuje punkty pośrednie na trasie przejazdu przez: VehicleMatch
w: SearchVehiclesResponse
. Ta koncepcja jest reprezentowana jako TripWaypoint
we wszystkich innych punktach końcowych.
Pola | |
---|---|
lat_lng |
Lokalizacja tego punktu na trasie. |
eta |
Szacowana godzina, o której pojazd dotrze 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, za pomocą których można odebrać pasażerów lub przedmioty. |
DROP_OFF_WAYPOINT_TYPE |
Punkty pośrednie, w których można wywieźć pasażerów lub przedmioty. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
Punkty pośrednie w przypadku podróży z kilkoma miejscami docelowymi. |