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) (wycofano)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óż w Fleet Engine i zwraca nową podróż. |
GetTrip |
---|
Wyświetlanie informacji o pojedynczej podróży. |
ReportBillableTrip |
---|
Zgłaszanie korzystania z podróży podlegającej rozliczeniu. |
SearchTrips |
---|
Wyświetl informacje o wszystkich przejazdach konkretnym pojazdem. |
UpdateTrip |
---|
aktualizuje dane podróży. |
VehicleService
Zarządzanie pojazdami.
CreateVehicle |
---|
Tworzy instancję nowego pojazdu powiązanego z usługodawcą oferującym wspólne przejazdy lub dostawy. Każdy element Następujące
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 pasujących do opcji w żądaniu. |
UpdateVehicle |
---|
Zapisuje zaktualizowane dane pojazdu we Fleet Engine. Podczas aktualizowania
Nie można zaktualizować pojazdu Jeśli pole |
UpdateVehicleAttributes |
---|
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 |
BatteryInfo
Informacje o baterii urządzenia.
Pola | |
---|---|
battery_status |
Stan baterii, czy to w pełni naładowana, czy w pełni naładowana. |
power_source |
Stan źródła zasilania z baterii. |
battery_percentage |
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[] |
Szybkość ruchu na trasie od poprzedniego punktu na trasie do bieżącego. |
encoded_path_to_waypoint |
Ś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 |
CreateTripRequest
Komunikat z prośbą o 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óż do utworzenia. Podczas tworzenia podróży musisz wypełnić te pola:
Jeśli podasz te pola, zostaną one użyte:
Pozostałe pola Podróże są ignorowane. Na przykład wszystkie podróże zaczynają się od Tylko podróże Gdy ustawisz program Jeśli określisz wartość Używane są pola |
CreateVehicleRequest
CreateVehicle
wiadomość z prośbą.
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. Element 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 |
Sposób działania funkcji lokalizacji na urządzeniu przy włączonym oszczędzaniu baterii. |
is_power_save_mode |
Określa, czy urządzenie jest obecnie w trybie oszczędzania energii. |
is_interactive |
Określa, czy urządzenie jest w stanie interaktywnym. |
battery_info |
Informacje o stanie baterii. |
GetTripRequest
Komunikat żądania GetTrip.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
view |
Podzbiór pól dotyczących podróży, które powinny zostać zwrócone, oraz ich interpretacja. |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane |
remaining_waypoints_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są elementy |
route_format_type |
Zwrócony aktualny format trasy: |
current_route_segment_traffic_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierany jest element |
remaining_waypoints_route_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane |
GetVehicleRequest
GetVehicle
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierany jest element |
waypoints_version |
Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane |
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 |
Wymagane. Kod kraju/regionu CLDR. Na przykład |
last_character |
Ostatnia cyfra na tablicy rejestracyjnej lub „-1” oznacza brak wartości liczbowej.
|
ListVehiclesRequest
ListVehicles
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
page_size |
Maksymalna liczba pojazdów do zwrócenia. Wartość domyślna: 100. |
page_token |
Wartość parametru |
minimum_capacity |
Określa wymaganą minimalną pojemność pojazdu. Wszystkie zwrócone pojazdy będą miały parametr |
trip_types[] |
Ogranicza odpowiedź do pojazdów, które obsługują co najmniej jeden z określonych typów podróży. |
maximum_staleness |
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[] |
Wymagane. Ogranicza odpowiedź do pojazdów z jednej ze wskazanych kategorii. |
required_attributes[] |
Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól
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[] |
Ogranicza odpowiedź do pojazdów z co najmniej jednym z określonych atrybutów w każdym atrybucie |
required_one_of_attribute_sets[] |
Podobnie jak
Ogranicza odpowiedź do pojazdów, które pasują do wszystkich atrybutów w |
vehicle_state |
Ogranicza odpowiedź do pojazdów w tym stanie. |
on_trip_only |
Zwrot pojazdów tylko w ramach aktualnej podróży. |
filter |
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 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 (np. 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. |
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[] |
Pojazdy spełniające kryteria podane w żądaniu. Maksymalna liczba zwróconych pojazdów jest określana przez pole |
next_page_token |
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 |
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. |
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 |
Wymagane. Musi mieć format |
country_code |
Wymagane. Dwuliterowy kod kraju, w którym odbywa się podróż. Cena jest określana na podstawie kodu kraju. |
platform |
Platforma, na którą wysłano żądanie. |
related_ids[] |
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 |
solution_type |
Typ rozwiązania usługi GMP (np. |
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 |
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: |
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 (w stosownych przypadkach). Format wersji to „główna.podrzędna.poprawka”, na przykład: |
os_version |
Wersja systemu operacyjnego, w którym działa pakiet SDK wywołujący. Przykładowe wartości pól: |
device_model |
Model urządzenia, na którym działa wywołujący pakiet SDK. Przykładowe wartości pól: |
sdk_type |
Typ pakietu SDK, który wysyła żądanie. |
maps_sdk_version |
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: |
nav_sdk_version |
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: |
platform |
Platforma wywołującego pakietu SDK. |
manufacturer |
Producent urządzenia z Androidem za pomocą wywołującego pakietu SDK. Dotyczy tylko pakietów SDK Androida. Przykład wartości pola: |
android_api_level |
Poziom interfejsu API Androida wywołującego SDK, dotyczy tylko pakietów Android SDK. Przykład wartości pola: |
trace_id |
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 |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
vehicle_id |
Pojazd powiązany z podróżami w żądaniu. Jeśli nie określono inaczej, zwracane podróże nie zawierają:
|
active_trips_only |
Jeśli ma wartość Prawda, odpowiedź uwzględnia podróże, które mają wpływ na trasę kierowcy. |
page_size |
Jeśli zasada nie jest skonfigurowana, serwer określa liczbę wyników do zwrócenia. |
page_token |
Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwróconą wcześniej w polu |
minimum_staleness |
Jeśli podano ten argument, zwraca podróże, które nie zostały zaktualizowane po godzinie |
SearchTripsResponse
Komunikat z odpowiedzią SearchTrips.
Pola | |
---|---|
trips[] |
Lista przejazdów żądanego pojazdu. |
next_page_token |
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 |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagane. Musi mieć format |
pickup_point |
Wymagane. Położony w pobliżu punkt odbioru, który chcesz wyszukać. |
dropoff_point |
Zamierzone miejsce docelowe zwrotu 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 określonym 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 zwrócenia. Wartość musi mieścić się w przedziale od 1 do 50 (włącznie). |
minimum_capacity |
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[] |
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 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[] |
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 |
required_attributes[] |
Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól
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[] |
Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej jeden z określonych atrybutów w każdym atrybucie |
required_one_of_attribute_sets[] |
Podobnie jak
Ogranicza wyszukiwanie tylko do tych pojazdów ze wszystkimi atrybutami marki |
order_by |
Wymagane. Określa żądane kryterium kolejności wyników. |
include_back_to_back |
Ta wartość określa, czy pojazdy z 1 aktywną podróżą kwalifikują się do tego wyszukiwania. To pole jest używane tylko wtedy, gdy pole Wartością domyślną jest |
trip_id |
Wskazuje podróż powiązaną z obiektem |
current_trips_present |
Ta wartość określa, czy pojazdy z aktywnymi podróżami kwalifikują się do tego wyszukiwania. Jeśli zasada |
filter |
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 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 (np. 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. |
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[] |
Lista pojazdów, które spełniają kryteria |
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 |
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 |
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 |
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 |
Wymagane. Wskazuje rzeczywistą lokalizację. |
timestamp |
Wskazuje, kiedy doszło do zatrzymania. |
stop_time |
Tylko wejście. Rola wycofana. Użyj pola sygnatury czasowej. |
TerminalLocation
Opisuje lokalizację punktu na trasie.
Pola | |
---|---|
point |
Wymagane. Wskazuje lokalizację punktu na trasie podróży. |
terminal_point_id |
Wycofane: zamiast tego podaj pole |
access_point_id |
Wycofane: zamiast tego podaj pole |
trip_id |
Rola wycofana. |
terminal_location_type |
Wycofane: te dane będą zawierać te dane: |
TerminalPointId
Wycofano: punkty TerminalPoint nie są już obsługiwane we Fleet Engine. Użyj w zamian zasady TerminalLocation.point
.
Pola | |
---|---|
value |
Rola wycofana. |
Pole sumy Id . Rola wycofana. Id może być tylko jedną z tych wartości: |
|
place_id |
Rola wycofana. |
generated_id |
Rola wycofana. |
TrafficPolylineData
Informacje o natężeniu ruchu na oczekiwanej trasie pojazdu.
Pola | |
---|---|
traffic_rendering |
Renderowanie za pomocą linii łamanej szybkości ruchu we wszystkich regionach na jednym odcinku przejazdu klienta. |
Podróż
Metadane podróży.
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „providers/{dostawca}/trips/{trip}” |
vehicle_id |
Identyfikator pojazdu podróżującego. |
trip_status |
Aktualny stan podróży. |
trip_type |
Typ podróży. |
pickup_point |
Lokalizacja, w której klient wskazuje, że zostanie odebrany. |
actual_pickup_point |
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 |
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 |
Tylko dane wyjściowe. Oszacowany czas przyjazdu pasażerów lub rzeczywista godzina przyjazdu tej osoby. |
intermediate_destinations[] |
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 |
Wskazuje czas ostatniej modyfikacji obiektu |
intermediate_destination_index |
Gdy |
actual_intermediate_destination_arrival_points[] |
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[] |
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 |
Lokalizacja, w której klient wskazuje, że zostanie wysadzony. |
actual_dropoff_point |
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 |
Tylko dane wyjściowe. Oszacowany czas wysiedlenia pasażerów w miejscu docelowym lub szacowany czas wysiedlenia w przyszłości. |
remaining_waypoints[] |
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[] |
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 |
route[] |
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 |
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 |
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 |
Tylko dane wyjściowe. Wskazuje warunki na drodze na Uwaga: to pole jest przeznaczone tylko do użycia przez pakiety Driver SDK i Consumer SDK. |
current_route_segment_traffic_version |
Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji obiektu Uwaga: to pole jest przeznaczone tylko do użycia przez pakiety Driver SDK i Consumer SDK. |
current_route_segment_end_point |
Tylko dane wyjściowe. Punkt na trasie, gdzie kończy się |
remaining_distance_meters |
Tylko dane wyjściowe. Pozostała odległość 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 momentu zwrócenia danych o podróży do godziny w strefie czasowej |
remaining_waypoints_version |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono obiekt |
remaining_waypoints_route_version |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono |
number_of_passengers |
Stałe. Wskazuje liczbę pasażerów tej podróży bez uwzględniania kierowcy. Aby można było zwrócić pojazd w odpowiedzi |
last_location |
Tylko dane wyjściowe. Wskazuje ostatnią zgłoszona lokalizację pojazdu na trasie. |
last_location_snappable |
Tylko dane wyjściowe. Wskazuje, czy obiekt |
view |
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 |
Lokalizacja tego punktu na trasie. |
trip_id |
Podróż powiązana z tym punktem na trasie. |
waypoint_type |
Rola tego punktu pośredniego w podróży, taka jak odbiór lub przyjazd. |
path_to_waypoint[] |
Ś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 |
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 |
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 |
Odległość na ścieżce od poprzedniego punktu do bieżącego punktu. Wartość nieokreślona dla pierwszego punktu pośredniego na liście. |
eta |
Szacowany czas dotarcia do tego punktu na trasie. Wartość nieokreślona dla pierwszego punktu pośredniego na liście. |
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 |
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ą elementu Trip.update.
Przy aktualizacji elementu Jeśli określisz wartość Aby uniknąć spełnienia warunków wyścigu w przypadku podróży z wieloma miejscami docelowymi, podczas aktualizowania stanu podróży na |
update_mask |
Wymagane. Maska pola wskazująca pola, które w Podróżu mają zostać zaktualizowane. Pole |
UpdateVehicleAttributesRequest
UpdateVehicleAttributes
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
attributes[] |
Wymagane. Atrybuty pojazdu do zaktualizowania. Wymienione atrybuty nie są zmieniane ani usuwane. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
odpowiedź.
Pola | |
---|---|
attributes[] |
Wymagane. Zaktualizowana pełna lista atrybutów pojazdu, w tym nowe, zmienione i nienaruszone. |
UpdateVehicleRequest
`Komunikat z prośbą o aktualizację pojazdu.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagane. Musi mieć format |
vehicle |
Wymagane. Wartości encji
Jeśli pole Podobnie pole |
update_mask |
Wymagane. Maska pola wskazująca, które pola obiektu |
Pojazd
Metadane pojazdu.
Pola | |
---|---|
name |
Tylko dane wyjściowe. Unikalna nazwa tego pojazdu. Format to |
vehicle_state |
Stan pojazdu. |
supported_trip_types[] |
Rodzaje 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 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[] |
Lista atrybutów pojazdu. Pojazd może mieć maksymalnie 100 atrybutów, a każdy atrybut musi mieć unikalny klucz. |
vehicle_type |
Wymagane. Typ pojazdu. Tych informacji można używać do filtrowania pojazdów w wynikach wyszukiwania w kategorii |
license_plate |
Informacje o tablicach rejestracyjnych pojazdu. |
route[] |
Wycofane: użyj zasady |
current_route_segment |
Linia łamana określająca trasę, którą aplikacja kierowcy ma pojechać do następnego punktu pośredniego. Ta lista jest też zwracana w Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK sterownika. Dekodowanie nie jest jeszcze obsługiwane. |
current_route_segment_traffic |
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 |
Tylko dane wyjściowe. Godzina, o której ustawiono |
current_route_segment_end_point |
Punkt na trasie, gdzie kończy się |
remaining_distance_meters |
Pozostała odległość dojazdu samochodem z: |
eta_to_first_waypoint |
Szacowany czas dotarcia na miejsce dla pierwszego wpisu w polu Podczas aktualizowania pojazdu zasada |
remaining_time_seconds |
Tylko wejście. Pozostały czas jazdy samochodem: Podczas aktualizowania pojazdu zasada |
waypoints[] |
Pozostałe punkty pośrednie przypisane do tego pojazdu. |
waypoints_version |
Tylko dane wyjściowe. Data ostatniej aktualizacji pola |
back_to_back_enabled |
Wskazuje, czy kierowca akceptuje przejazdy jedna po drugiej. Jeśli |
navigation_status |
Stan nawigacji pojazdu. |
device_settings |
Tylko wejście. 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ś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 |
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 typem typu double. vehicle_attribute_value może być tylko jedną z tych wartości: |
|
string_value |
Wartość atrybutu wpisanego przez ciąg znaków. Uwaga: to pole jest takie samo jak pole |
bool_value |
Wartość atrybutu o typie logicznym. |
number_value |
Podwójna wartość atrybutu. |
VehicleAttributeList
Typ danych „lista list” dla atrybutów pojazdu.
Pola | |
---|---|
attributes[] |
Lista atrybutów w tej kolekcji. |
VehicleLocation
Lokalizacja, prędkość i kierunek pojazdu w określonym czasie.
Pola | |
---|---|
location |
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 |
horizontal_accuracy |
Wycofane: użyj zasady |
latlng_accuracy |
Dokładność |
heading |
Kierunek ruchu pojazdu w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360). |
bearing_accuracy |
Wycofane: użyj zasady |
heading_accuracy |
Dokładność |
altitude |
Wysokość w metrach powyżej WGS84. |
vertical_accuracy |
Wycofane: użyj zasady |
altitude_accuracy |
Dokładność |
speed_kmph |
Prędkość pojazdu w kilometrach na godzinę. Wycofane: użyj zasady |
speed |
Prędkość pojazdu w metrach/s |
speed_accuracy |
Dokładność |
update_time |
Czas zgłoszenia wartości |
server_time |
Tylko dane wyjściowe. Godzina, o której serwer otrzymał informacje o lokalizacji. |
location_sensor |
Dostawca danych o lokalizacji (np. |
is_road_snapped |
Określa, czy obiekt |
is_gps_sensor_enabled |
Tylko wejście. Wskazuje, czy czujnik GPS jest włączony na urządzeniu mobilnym. |
time_since_update |
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 |
Tylko wejście. Wycofano: do określania, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały. |
raw_location |
Przybliżona lokalizacja pojazdu (nieprzetworzona przez snappera). |
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 podana przez aplikację integracyjną. |
supplemental_location_time |
Sygnatura czasowa zwią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 zasady |
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 |
Wymagane. Pojazd pasujący do żądania. |
vehicle_pickup_eta |
Szacowany czas dotarcia pojazdu do miejsca odbioru wskazanego 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 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 |
Wymagane. W linii prostej między pojazdem a punktem odbioru określonym w żądaniu. |
vehicle_dropoff_eta |
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 |
vehicle_pickup_to_dropoff_distance_meters |
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 |
trip_type |
Wymagane. Typ podróży dla żądania, które zostało użyte 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 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 |
Typ dopasowania pojazdu. |
requested_ordered_by |
Żądana kolejność sortowania pojazdów. |
ordered_by |
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. |
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[] |
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 |
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 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 |
Lokalizacja tego punktu na trasie. |
eta |
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. |