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)TrafficPolylineData
(komunikat)Trip
(komunikat)TripStatus
(wyliczenie)TripType
(wyliczenie)TripView
(wyliczenie)TripWaypoint
(komunikat)UpdateTripRequest
(komunikat)UpdateVehicleAttributesRequest
(komunikat)UpdateVehicleAttributesResponse
(komunikat)UpdateVehicleLocationRequest
(komunikat) (wycofano)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)
Usługa TripService
Usługa zarządzania podróżami.
Utwórz podróż |
---|
Tworzy podróż we Fleet Engine i zwraca nową. |
Podróż |
---|
Wyświetlanie informacji o pojedynczej podróży. |
Zgłoś podróż płatniczą |
---|
Raportowanie wykorzystania płatnych podróży. |
Podróże z wyszukiwaniem |
---|
Wyświetl wszystkie informacje dotyczące danego pojazdu. |
Podróż po aktualizacji |
---|
Aktualizuje dane podróży. |
Serwis samochodowy
Zarządzanie pojazdami.
Tworzenie pojazdu |
---|
Tworzy nowy pojazd powiązany z usługą wspólnych przejazdów na żądanie lub dostawcom. Każdy element Podczas tworzenia
Podczas tworzenia
Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostały podane. |
Pobieranie pojazdu |
---|
Zwraca pojazd z Fleet Engine. |
Wyświetlanie listy pojazdów |
---|
Zwraca podzieloną na strony listę pojazdów powiązanych z dostawcą, które pasują do opcji żądania. |
Zjawiskowe pojazdy |
---|
Wycofane: użyj atrybutu |
Szukaj pojazdów |
---|
Zwraca listę pojazdów pasujących do opcji żądania. |
Aktualizuj pojazd |
---|
Zapisuje zaktualizowane dane o pojazdach we Fleet Engine. Podczas aktualizowania pola
Nie można też zaktualizować pojazdu Jeśli pole |
Aktualizuj atrybutyPojazdu |
---|
Częściowo aktualizuje atrybuty pojazdu. Zostaną zaktualizowane tylko atrybuty wymienione w żądaniu. Pozostałe atrybuty NIE ulegną zmianie. Uwaga: różni się to w przypadku parametru |
Aktualizuj lokalizację pojazdu |
---|
Wycofane: użyj metody |
Informacje o baterii
Informacje o baterii urządzenia.
Pola | |
---|---|
battery_status |
Stan baterii (pełna, naładowana itp.). |
power_source |
Stan źródła zasilania baterii. |
battery_percentage |
Obecny procentowy poziom naładowania baterii [0-100]. |
Stan baterii
Stan baterii (pełna, naładowana itp.).
Wartości w polu enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
Nieznany stan baterii. |
BATTERY_STATUS_CHARGING |
Trwa ładowanie baterii. |
BATTERY_STATUS_DISCHARGING |
Bateria się rozładowuje. |
BATTERY_STATUS_FULL |
Bateria jest pełna. |
BATTERY_STATUS_NOT_CHARGING |
Bateria się nie ładuje. |
BATTERY_STATUS_POWER_LOW |
Słaba bateria. |
Identyfikator platformy rozliczeniowej
Zestaw wartości wskazujących, do której platformy zostało wysłane żądanie.
Wartości w polu enum | |
---|---|
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED |
Domyślny: Używany w przypadku nieokreślonych platform. |
SERVER |
Platforma to serwer klienta. |
WEB |
Platforma to przeglądarka. |
ANDROID |
Platformą jest urządzenie mobilne z Androidem. |
IOS |
Platformą jest urządzenie mobilne z systemem iOS. |
OTHERS |
Inne platformy, które nie są wymienione w tym wyliczeniu. |
Linia ConsumableTrafficPolyline
Natężenie ruchu na trasie pojazdu.
Pola | |
---|---|
speed_reading_interval[] |
Prędkość ruchu na trasie od poprzedniego punktu do bieżącego punktu. |
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 utworzenie wycieczki.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagany. Musi mieć format |
trip_id |
Wymagany. Unikalny identyfikator podróży. Obowiązują następujące ograniczenia:
|
trip |
Wymagany. Podróż do utworzenia. Podczas tworzenia podróży wymagane są te pola:
Te pola będą używane, jeśli je podasz:
Wszystkie pozostałe pola Podróże są ignorowane. Na przykład wszystkie podróże zaczynają się od Tylko Gdy ustawisz Jeśli określisz właściwość Używane są pola |
CreateVehicleRequest (Żądanie pojazdu)
CreateVehicle
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagany. Musi mieć format |
vehicle_id |
Wymagany. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:
|
vehicle |
Wymagany. Element Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić te pola:
Podczas tworzenia pojazdu te pola są ignorowane:
Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostały podane. |
Ustawienia urządzenia
Informacje o różnych ustawieniach na urządzeniu mobilnym.
Pola | |
---|---|
location_power_save_mode |
Sposób działania funkcji lokalizacji na urządzeniu po włączeniu oszczędzania baterii. |
is_power_save_mode |
Wskazuje, czy urządzenie jest obecnie w trybie oszczędzania energii. |
is_interactive |
Określa, czy urządzenie jest w trybie interakcji. |
battery_info |
Informacje o stanie baterii. |
GetTripRequest
Komunikat z żądaniem GetTrip.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
view |
Podzbiór pól podróży, które powinny zostać zwrócone, oraz ich interpretacja. |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane |
remaining_waypoints_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której pobierane są elementy |
route_format_type |
Zwrócony aktualny format trasy, |
current_route_segment_traffic_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której element |
remaining_waypoints_route_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane |
Pobieranie żądaniaPojazdu
GetVehicle
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
current_route_segment_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), z której element |
waypoints_version |
Wskazuje minimalną sygnaturę czasową (bez uwzględnienia), dla której pobierane są dane |
LicensePlate
Informacje o tablicy rejestracyjnej pojazdu. Aby uniknąć przechowywania informacji umożliwiających identyfikację osoby, wraz z podmiotem przechowywane są tylko minimum informacje o tablicy rejestracyjnej.
Pola | |
---|---|
country_code |
Wymagany. Kod kraju/regionu CLDR. Na przykład |
last_character |
Ostatnia cyfra na tablicy rejestracyjnej lub „-1” oznacza, że na tablicy nie ma żadnej wartości liczbowej.
|
Wyświetlanie żądań pojazdów
ListVehicles
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagany. 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 zwracane pojazdy będą miały |
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 w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Stacjonarne pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli występuje, to musi być prawidłową wartością dodatnią. |
vehicle_type_categories[] |
Wymagany. Ogranicza odpowiedź do pojazdów z jednej ze wskazanych kategorii. |
required_attributes[] |
Wywołujący mogą wykonywać złożone operacje logiczne przy użyciu dowolnej kombinacji pól
Ogranicza odpowiedź do pojazdów o określonych atrybutach. To pole jest połączeniem/ORAZ. Maksymalna dozwolona liczba atrybutów_wymaganych to 50. Ta wartość odpowiada maksymalnej liczbie atrybutów dozwolonych w pojeździe. Każdy powtórzony ciąg powinien mieć format „klucz:wartość”. |
required_one_of_attributes[] |
Ogranicza odpowiedź do pojazdów, które w każdym elemencie |
required_one_of_attribute_sets[] |
Podobnie jak w przypadku
Ogranicza odpowiedź do pojazdów pasujących do wszystkich atrybutów w |
vehicle_state |
Ogranicza odpowiedź do pojazdów z tym stanem pojazdu. |
on_trip_only |
Zwracaj tylko pojazdy związane z bieżącą podróżą. |
filter |
Opcjonalnie. Zapytanie o filtr, który ma być stosowany przy wyświetlaniu informacji o pojazdach. Przykłady składni filtra znajdziesz na http://aip.dev/160. To pole zastępuje pola Ten filtr działa jako klauzula AND 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 atrybutów są porównania ciągów znaków. Aby możliwe było porównanie z wartościami liczbowymi lub logicznymi, wartości muszą być wyraźnie ujęte w cudzysłów (np. |
viewport |
Opcjonalnie. Filtr, który ogranicza zwracane pojazdy do tych, których ostatnią znaną lokalizację znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze. |
Wyświetlanie odpowiedzi o pojazdach
ListVehicles
wiadomość z odpowiedzią.
Pola | |
---|---|
vehicles[] |
Pojazdy spełniające kryteria określone w żądaniu. Maksymalna liczba zwróconych pojazdów jest określana przez pole |
next_page_token |
Token pobierania następnej strony pojazdów lub pusty, jeśli nie ma więcej pojazdów spełniających kryteria żądania. |
total_size |
Wymagany. Łączna liczba pojazdów na wszystkich stronach, które spełniają kryteria żądania. |
Tryb oszczędzania energii lokalizacji
Jak są skonfigurowane funkcje lokalizacji na urządzeniu mobilnym, gdy jest na nim włączona funkcja „Oszczędzanie baterii”. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Wartości w polu enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
Niezdefiniowany tryb oszczędzania energii lokalizacji |
LOCATION_MODE_NO_CHANGE |
Oszczędzanie baterii nie powinno mieć wpływu na dostawców lokalizacji lub jest wyłączone. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
Dostawca lokalizacji oparty na GPS powinien być wyłączony, gdy oszczędzanie baterii jest włączone, a urządzenie nie jest interaktywne. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
Gdy oszczędzanie baterii jest włączone, a urządzenie nie jest interaktywne, wszyscy dostawcy lokalizacji powinni być wyłączeni. |
LOCATION_MODE_FOREGROUND_ONLY |
Wszyscy dostawcy usług lokalizacyjnych pozostaną dostępni, ale poprawki lokalizacji należy udostępniać tylko aplikacjom działającym na pierwszym planie. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
Lokalizacja nie zostanie wyłączona, ale Menedżer lokalizacji ograniczy wszystkie żądania wysyłane do dostawców, gdy urządzenie nie jest interaktywne. |
Czujnik lokalizacji
Czujnik lub metodologia użyta do określenia lokalizacji.
Wartości w polu enum | |
---|---|
UNKNOWN_SENSOR |
Czujnik jest nieokreślony lub nieznany. |
GPS |
GPS lub wspomagany GPS. |
NETWORK |
Wspomagany GPS, identyfikator stacji bazowej lub punkt dostępu Wi-Fi. |
PASSIVE |
Identyfikator stacji bazowej lub punktu dostępu Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobna pozycja na drodze. |
CUSTOMER_SUPPLIED_LOCATION |
Lokalizacja podana przez klienta z niezależnego źródła. Zazwyczaj ta wartość jest używana w przypadku lokalizacji pochodzących ze źródeł innych niż urządzenie mobilne, na którym działa pakiet SDK sterownika. Jeśli pierwotne źródło jest opisane przez jedną z pozostałych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle dostarczane za pomocą: last_location.supplemental_location_sensor pojazdu. |
FLEET_ENGINE_LOCATION |
Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych dla niej sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli zostanie odebrana w żądaniu. |
FUSED_LOCATION_PROVIDER |
Dostawca uśrednionej lokalizacji na Androidzie. |
CORE_LOCATION |
Dostawca lokalizacji w systemach operacyjnych Apple. |
Typ formatu łamanego
Typ formatu linii łamanej.
Wartości w polu enum | |
---|---|
UNKNOWN_FORMAT_TYPE |
Format jest nieokreślony lub nieznany. |
LAT_LNG_LIST_TYPE |
Lista google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
Linia łamana zakodowana za pomocą algorytmu kompresji linii łamanej. Dekodowanie nie jest jeszcze obsługiwane. |
Źródło zasilania
Typ ładowarki używanej do ładowania baterii.
Wartości w polu enum | |
---|---|
UNKNOWN_POWER_SOURCE |
Nieznane źródło zasilania. |
POWER_SOURCE_AC |
Źródłem zasilania jest ładowarka sieciowa. |
POWER_SOURCE_USB |
Źródło zasilania to port USB. |
POWER_SOURCE_WIRELESS |
Źródło zasilania jest bezprzewodowe. |
POWER_SOURCE_UNPLUGGED |
Bateria jest odłączona. |
Żądanie ReportBillableTrip
Komunikat z żądaniem ReportBillableTrip.
Pola | |
---|---|
name |
Wymagany. Musi mieć format |
country_code |
Wymagany. Dwuliterowy kod kraju, do którego odbędzie się podróż. Cena jest określona według kodu kraju. |
platform |
Platforma, na którą wysłano żądanie. |
related_ids[] |
Identyfikatory bezpośrednio związane z zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) operacji wstępnej rezerwacji, które zostały wykonane, zanim identyfikator podróży jest dostępny. Liczba wartości |
solution_type |
Typ rozwiązania GMP (np. |
Typ rozwiązania
Selektor różnych typów rozwiązań zgłoszonych podczas podróży.
Wartości w polu enum | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie używał ON_DEMAND_RIDESHARING_AND_DELIVERIES , czyli pierwszego obsługiwanego typu rozwiązania. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
Rozwiązaniem jest transport na żądanie z dostawą. |
Nagłówek żądania
Element RequestHeader zawiera pola wspólne dla wszystkich żądań RPC Fleet Engine.
Pola | |
---|---|
language_code |
Kod języka BCP-47, np. en-US lub sr-Latn. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli nie określisz żadnej nazwy, odpowiedź może być w dowolnym języku. W przypadku takiej nazwy odpowiedź będzie preferowana w języku angielskim. Przykład wartości pola: |
region_code |
Wymagany. 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 „major.podrzędna.poprawka”, na przykład: |
os_version |
Wersja systemu operacyjnego, w którym działa wywołujący pakiet SDK. 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órej zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „major.podrzędna.poprawka”, na przykład: |
nav_sdk_version |
Wersja pakietu NavSDK, od której zależy pakiet SDK wywołujący (w stosownych przypadkach). Format wersji to „major.podrzędna.poprawka”, na przykład: |
platform |
Platforma wywołującego SDK. |
manufacturer |
Producent urządzenia z Androidem z pakietu SDK do wywoływania. Dotyczy tylko pakietów SDK na 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: |
Platforma
Platforma wywołującego SDK.
Wartości w polu enum | |
---|---|
PLATFORM_UNSPECIFIED |
Wartość domyślna. Ta wartość jest używana, jeśli platforma została pominięta. |
ANDROID |
Żądanie pochodzi z Androida. |
IOS |
Żądanie pochodzi z iOS. |
WEB |
Żądanie pochodzi z internetu. |
Typ pakietu SDK
Możliwe typy pakietów SDK.
Wartości w polu enum | |
---|---|
SDK_TYPE_UNSPECIFIED |
Wartość domyślna. Ta wartość jest używana, jeśli pominięto sdk_type . |
CONSUMER |
Wywołujący pakiet SDK to konsument. |
DRIVER |
Pakiet SDK do wywoływania to sterownik. |
JAVASCRIPT |
Pakiet SDK wywołujący to JavaScript. |
Żądanie SearchTrips
Wiadomość z prośbą SearchTrips.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagany. Musi mieć format |
vehicle_id |
Pojazd powiązany z podróżami w żądaniu. Jeśli nie określono inaczej, zwrócone podróże nie zawierają:
|
active_trips_only |
Jeśli ma wartość Prawda, odpowiedź obejmuje podróże, które wpływają 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, wpisz tutaj wartość zwrócona wcześniej w polu |
minimum_staleness |
Jeśli jest określony, zwraca podróże, które nie zostały zaktualizowane po czasie |
Odpowiedź wyszukiwania
Komunikat z odpowiedzią SearchTrips.
Pola | |
---|---|
trips[] |
Lista przejazdów żądanym pojazdem. |
next_page_token |
Przekaż ten token w żądaniu SearchTripsRequest do strony wyników listy. Interfejs API zwraca listę podróży przy każdym wywołaniu, a gdy nie ma więcej wyników, lista podróży jest pusta. |
Żądanie wyszukiwania pojazdów
SearchVehicles
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
parent |
Wymagany. Musi mieć format |
pickup_point |
Wymagany. Punkt odbioru, który chcesz wyszukać. |
dropoff_point |
Zamierzone miejsce docelowe zwrotu kosztów przez klienta. To pole jest wymagane, jeśli |
pickup_radius_meters |
Wymagany. Określa promień wyszukiwania pojazdu wokół punktu odbioru. Zwrócone zostaną tylko pojazdy znajdujące się w określonym promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie). |
count |
Wymagany. Określa maksymalną liczbę pojazdów do zwrócenia. Wartość musi mieścić się w zakresie od 1 do 50 (włącznie). |
minimum_capacity |
Wymagany. Określa liczbę pasażerów uwzględnianych podczas podróży. Wartość nie może być mniejsza niż 1. Kierowca nie jest brany pod uwagę przy określaniu pojemności. |
trip_types[] |
Wymagany. Określa typ proponowanej podróży. Kwalifikujące się pojazdy to takie, które mogą obsłużyć co najmniej 1 z określonych typów podróży.
|
maximum_staleness |
Ogranicza wyszukiwanie tylko do tych pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Stacjonarne pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli to pole nie zostanie ustawione, serwer użyje wartości domyślnej 5 minut. |
vehicle_types[] |
Wymagany. Ogranicza wyszukiwanie do pojazdów określonego typu. Musisz określić co najmniej jeden typ pojazdu. Obiekty VehicleType z kategorii |
required_attributes[] |
Wywołujący mogą wykonywać złożone operacje logiczne przy użyciu dowolnej kombinacji pól
Ogranicza wyszukiwanie tylko do tych pojazdów o określonych atrybutach. To pole jest połączeniem/ORAZ. Maksymalna dozwolona liczba atrybutów_wymaganych to 50. Ta wartość odpowiada maksymalnej liczbie atrybutów dozwolonych w pojeździe. |
required_one_of_attributes[] |
Ogranicza wyszukiwanie tylko do pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym atrybucie |
required_one_of_attribute_sets[] |
Podobnie jak w przypadku
Ogranicza wyszukiwanie tylko do pojazdów ze wszystkimi atrybutami w grupie |
order_by |
Wymagany. Określa żądane kryterium kolejności wyników. |
include_back_to_back |
Wskazuje, czy pojazd z jedną aktywną podróżą kwalifikuje się do kolejnego dopasowania. Jeśli ustawiona jest wartość To pole jest uwzględniane tylko wtedy, gdy określono pojedynczy element Wartością domyślną jest |
trip_id |
Wskazuje podróż powiązaną z tym obiektem ( |
current_trips_present |
Ogranicza wyświetlanie pojazdów w wynikach wyszukiwania na podstawie ich bieżących tras. Gdy parametr current_trips_present ma wartość |
filter |
Opcjonalnie. Zapytanie filtra, które ma być stosowane podczas wyszukiwania pojazdów. Przykłady składni filtra znajdziesz na http://aip.dev/160. To pole zastępuje pola Ten filtr działa jako klauzula AND 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 atrybutów są porównania ciągów znaków. Aby możliwe było porównanie z wartościami liczbowymi lub logicznymi, wartości muszą być wyraźnie ujęte w cudzysłów (np. |
BieżącePodróże
Określa typy ograniczeń związanych z bieżącą podróżą pojazdu.
Wartości w polu enum | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Tylko pojazdy bez podróży mogą wyświetlać się w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji. Więcej informacji znajdziesz we fladze include_back_to_back . |
NONE |
Pojazdy bez podróży mogą się wyświetlać w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji. |
ANY |
Pojazdy z maksymalnie 5 aktualnymi trasami i 10 punktami pośrednimi są uwzględniane w wynikach wyszukiwania. Jeśli zasada include_back_to_back ma wartość prawda, wysyłany jest wyjątek weryfikacji. |
Zamówienie_dopasowania pojazdu
Określa kolejność pojazdów w odpowiedzi.
Wartości w polu enum | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
Domyślne używane w przypadku nieokreślonych lub nierozpoznanych pojazdów pasuje do zamówienia. |
PICKUP_POINT_ETA |
Rosnąco według czasu jazdy pojazdu do punktu odbioru. |
PICKUP_POINT_DISTANCE |
Kolejność rosnąca według odległości jazdy samochodem do punktu odbioru. |
DROPOFF_POINT_ETA |
Rosnąco według czasu jazdy pojazdu do miejsca zwrotu. Tego zamówienia można użyć tylko wtedy, gdy w żądaniu określono punkt zwrotu. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Rosnąco według odległości w prostej linii od ostatniej zgłoszonej lokalizacji pojazdu do punktu odbioru. |
COST |
W kolejności rosnącej według skonfigurowanego kosztu dopasowania. Koszt dopasowania to ważone obliczenie odległości między odległość w linii a szacowanym czasem dotarcia. Wagi są ustawione na wartości domyślne i można je zmieniać dla poszczególnych klientów. Jeśli chcesz zmienić te wagi w projekcie, skontaktuj się z zespołem pomocy Google. |
Odpowiedź z wyszukiwarki pojazdów
SearchVehicles
wiadomość z odpowiedzią.
Pola | |
---|---|
matches[] |
Lista pojazdów spełniających kryteria |
SpeedReadingInterval
Wskaźnik natężenia ruchu na sąsiednim fragmencie ścieżki. Przy założeniu ścieżki z punktami P_0, P_1, ... , P_N (indeks liczony od zera) parametr SpeedReadingInterval definiuje odstęp i opisuje ruch za pomocą następujących kategorii.
Pola | |
---|---|
start_polyline_point_index |
Indeks początkowy tego przedziału na ścieżce. W formacie JSON, gdy indeks ma wartość 0, pole będzie puste. |
end_polyline_point_index |
Indeks końcowy tego przedziału na ścieżce. W formacie JSON, gdy indeks ma wartość 0, pole będzie puste. |
speed |
Prędkość ruchu w tym przedziale czasu. |
Szybkość
Klasyfikacja szybkości linii łamanej na podstawie danych o ruchu.
Wartości w polu enum | |
---|---|
SPEED_UNSPECIFIED |
Wartość domyślna. Ta wartość nie jest używana. |
NORMAL |
Normalna prędkość, nie wykryto opóźnienia. |
SLOW |
Wykryto korek, ale nie utworzono korka. |
TRAFFIC_JAM |
Wykryto korek. |
Lokalizacja zatrzymania
Rzeczywista lokalizacja, w której nastąpił przystanek (odbiór/zwrot).
Pola | |
---|---|
point |
Wymagany. Wskazuje rzeczywistą lokalizację. |
timestamp |
Wskazuje, kiedy miał miejsce postój. |
stop_time |
Tylko dane wejściowe. Rola wycofana. Użyj pola sygnatury czasowej. |
Lokalizacja terminalu
Opisuje lokalizację punktu pośredniego.
Pola | |
---|---|
point |
Wymagany. Wskazuje lokalizację punktu na trasie podróży. |
terminal_point_id |
Identyfikator punktu końcowego. |
access_point_id |
Rola wycofana. |
trip_id |
Rola wycofana. |
terminal_location_type |
Wycofane: te dane będą zawierać te dane: |
Identyfikator punktu końcowego
Określa punkt końcowy.
Pola | |
---|---|
value |
Unikalny identyfikator punktu końcowego. |
Pole Unii Id . Rola wycofana. Id może mieć tylko jedną z tych wartości: |
|
place_id |
Rola wycofana. |
generated_id |
Rola wycofana. |
Dane Polyline Ruchu
Informacje o warunkach drogowych na oczekiwanej trasie pojazdu.
Pola | |
---|---|
traffic_rendering |
Renderowanie liniowe pokazujące szybkość ruchu we wszystkich regionach na jednym odcinku przejazdu klienta. |
Podróż
Metadane podróży.
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „providers/{provider}/trips/{trip}” |
vehicle_id |
Identyfikator pojazdu w tej podróży. |
trip_status |
Aktualny stan podróży. |
trip_type |
Rodzaj podróży. |
pickup_point |
Miejsce, w którym klient wskazuje, że zostanie odebrany. |
actual_pickup_point |
Tylko dane wejściowe. Rzeczywiste miejsce i czas odbioru klienta. To pole służy dostawcy do przesyłania opinii na temat rzeczywistych informacji o odbiorze. |
actual_pickup_arrival_point |
Tylko dane wejściowe. Rzeczywista godzina i lokalizacja przyjazdu kierowcy do punktu odbioru. To pole służy do przesyłania opinii o faktycznym przybyciu do punktu odbioru. |
pickup_time |
Tylko dane wyjściowe. Szacowana godzina odjazdu pasażera lub rzeczywista godzina, o której go odebrano. |
intermediate_destinations[] |
Przerwy pośrednie w kolejności, w jakiej zgłaszają się prośby o podróż (a nie tylko w przypadku odbioru i dostawy). Początkowo ta funkcja nie będzie dostępna w przypadku wspólnych podróży. |
intermediate_destinations_version |
Wskazuje czas ostatniej modyfikacji obiektu |
intermediate_destination_index |
Gdy |
actual_intermediate_destination_arrival_points[] |
Tylko dane wejściowe. Rzeczywista godzina i lokalizacja przyjazdu kierowcy do pośredniego miejsca docelowego. To pole służy do przesyłania opinii o faktycznym przybyciu do miejsc pośrednich. |
actual_intermediate_destinations[] |
Tylko dane wejściowe. Rzeczywiste miejsce i czas odebrania klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przesyłania opinii o rzeczywistych informacjach o odbiorze w miejscach docelowych pośrednich. |
dropoff_point |
Miejsce, w którym klient wskazuje, że zostanie porzucony. |
actual_dropoff_point |
Tylko dane wejściowe. Rzeczywista godzina i miejsce wysyłki klienta. To pole służy do przesyłania opinii na temat rzeczywistych informacji o wysyłce klienta. |
dropoff_time |
Tylko dane wyjściowe. Przewidywana przyszła godzina, o której pasażerowie wysiądą na miejscu docelowym, lub rzeczywista godzina, o której wysiądzie. |
remaining_waypoints[] |
Tylko dane wyjściowe. Pełna ścieżka od bieżącej lokalizacji do punktu docelowego włącznie. Ścieżka może obejmować punkty na innych trasach. |
vehicle_waypoints[] |
To pole umożliwia ręczne porządkowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty na trasie przypisanego do pojazdu, a także punkty na drodze do miejsca odbioru i miejsca wysyłki. Jeśli podróż nie została przypisana do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane tylko przez serwer w wywołaniach |
route[] |
Tylko dane wyjściowe. Przewidywana trasa tej podróży do pierwszego wejścia w pozostałych punktach pośrednich. Pierwszy punkt może należeć do innej podróży. |
current_route_segment |
Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu na trasie. Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane. |
current_route_segment_version |
Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji trasy. Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. |
current_route_segment_traffic |
Tylko dane wyjściowe. Wskazuje warunki na drodze na Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. |
current_route_segment_traffic_version |
Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji obiektu Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. |
current_route_segment_end_point |
Tylko dane wyjściowe. Punkt na trasie, w którym kończy się trasa |
remaining_distance_meters |
Tylko dane wyjściowe. Pozostały dystans 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 dotyczących podróży do czasu w lokalizacji |
remaining_waypoints_version |
Tylko dane wyjściowe. Wskazuje, kiedy ostatni raz został zmieniony |
remaining_waypoints_route_version |
Tylko dane wyjściowe. Wskazuje ostatnią zmianę atrybutów |
number_of_passengers |
Stała. Wskazuje liczbę pasażerów w ramach tej podróży (nie obejmuje kierowcy). Pojazd musi mieć dostępną pojemność, aby można było zwrócić go w odpowiedzi |
last_location |
Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie. |
last_location_snappable |
Tylko dane wyjściowe. Wskazuje, czy element |
view |
Podzbiór pól Podróż, które są wypełnione i jak powinny być interpretowane. |
Stan podróży
Stan podróży wskazujący jej postęp.
Wartości w polu enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Domyślny, używany w przypadku nieokreślonego lub nierozpoznanego stanu podróży. |
NEW |
Nowo utworzona podróż. |
ENROUTE_TO_PICKUP |
Kierowca jest w drodze do punktu odbioru. |
ARRIVED_AT_PICKUP |
Kierowca dotarł do punktu odbioru. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Kierowca dotarł do pośredniego miejsca docelowego i czeka na pasażera. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Kierowca jest w drodze do pośredniego miejsca docelowego (nie do miejsca docelowego). |
ENROUTE_TO_DROPOFF |
Kierowca odebrał pasażera i jedzie do następnego miejsca docelowego. |
COMPLETE |
Pasażer został wysadzony i podróż się zakończyła. |
CANCELED |
podróż została anulowana przed odebraniem przez kierowcę, pasażera lub firmę oferującą wspólne przejazdy. |
Typ podróży
Rodzaj podróży.
Wartości w polu enum | |
---|---|
UNKNOWN_TRIP_TYPE |
Domyślne używane w przypadku nieokreślonych lub nierozpoznanych typów podróży. |
SHARED |
W czasie podróży pojazd może być współużytkowany z innymi podróżami. |
EXCLUSIVE |
Podróż obejmuje tylko pojazd. |
Widok TripView
Selektor różnych zestawów pól Podróż w odpowiedzi GetTrip
. Kontekst znajdziesz na stronie AIP-157. Prawdopodobnie dodamy więcej widoków danych.
Wartości w polu enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie wyświetlać widok pakietu SDK. Aby zapewnić stabilność i wsparcie, zalecamy klientom wybranie atrybutu TripView innego niż SDK . |
SDK |
Obejmuje pola, których nie można interpretować lub obsługiwać przy użyciu publicznie dostępnych bibliotek. |
JOURNEY_SHARING_V1S |
Pola podróży są wypełniane na potrzeby funkcji udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami. |
Punkt na trasie TripWaypoint
Opisuje punkt zatrzymania na trasie pojazdu lub punkt końcowy na trasie pojazdu.
Pola | |
---|---|
location |
Lokalizacja tego punktu na trasie. |
trip_id |
Podróż powiązana z tym punktem pośrednim. |
waypoint_type |
Rola, jaką punkt pośredni odgrywa podczas podróży, np. odbiór lub przyjazd. |
path_to_waypoint[] |
Ścieżka od poprzedniego punktu do bieżącego. Nieokreślony dla pierwszego punktu pośredniego na liście. To pole jest wypełniane tylko na żądanie. |
encoded_path_to_waypoint |
Zakodowana ścieżka od poprzedniego punktu do bieżącego. Uwaga: to pole jest przeznaczone wyłącznie do użytku w pakietach Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane. |
traffic_to_waypoint |
Informacje o warunkach na drodze do tego punktu. Pamiętaj, że informacje o ruchu są dostępne tylko dla klientów korzystających z rozwiązania do obsługi Przejazdów i dostaw w Google Map Platform. |
distance_meters |
Odległość na ścieżce od poprzedniego punktu do bieżącego. Nieokreślony dla pierwszego punktu pośredniego na liście. |
eta |
Szacowana godzina dotarcia do tego punktu pośredniego. Nieokreślony dla pierwszego punktu pośredniego na liście. |
duration |
Czas podróży z poprzedniego punktu na trasie do tego punktu. Nieokreślony dla pierwszego punktu pośredniego na liście. |
Żądanie aktualizacjiTripRequest
Komunikat z prośbą o aktualizacjęTrip.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
trip |
Wymagany. Podróż powiązana z aktualizacją. Poniższe pola są obsługiwane przez Fleet Engine. Nie aktualizuj ich za pomocą Trip.update.
Gdy aktualizujesz Jeśli określisz właściwość Aby uniknąć spełnienia warunków wyścigu w przypadku podróży obejmujących wiele miejsc docelowych, podczas aktualizowania stanu podróży na |
update_mask |
Wymagany. Maska pola wskazująca pola do zaktualizowania w Podróżu. Pole |
Żądanie UpdateVehicleAttributesRequest
UpdateVehicleAttributes
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
attributes[] |
Wymagany. Atrybuty pojazdu do zaktualizowania. Niewymienione atrybuty nie są zmieniane ani usuwane. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
wiadomość z odpowiedzią.
Pola | |
---|---|
attributes[] |
Wymagany. Zaktualizowana pełna lista atrybutów pojazdu, w tym nowe, zmienione i nienaruszone. |
Żądanie aktualizacji lokalizacji pojazdu
UpdateVehicleLocation
wiadomość z prośbą.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
current_location |
Wymagany. Najnowsza lokalizacja pojazdu. Pola podrzędne |
current_state |
Ustaw stan pojazdu na |
Żądanie aktualizacji pojazdu
Komunikat żądania UpdateVehicle.
Pola | |
---|---|
header |
Standardowy nagłówek żądania Fleet Engine. |
name |
Wymagany. Musi mieć format |
vehicle |
Wymagany. Wartości encji
Jeśli pole Podobnie pole |
update_mask |
Wymagany. Maska pola wskazująca, które pola obiektu |
Pojazd
Metadane pojazdu.
Pola | |
---|---|
name |
Tylko dane wyjściowe. Unikalna nazwa 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 użytkowników |
last_location |
Ostatni raport o lokalizacji pojazdu. |
maximum_capacity |
Łączna liczba pasażerów tego pojazdu. 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 50 atrybutów, a każdy atrybut musi mieć unikalny kluczyk. |
vehicle_type |
Wymagany. Typ pojazdu. Pozwala filtrować pojazdy w |
license_plate |
Informacje o tablicach rejestracyjnych pojazdu. |
route[] |
Wycofane: użyj atrybutu |
current_route_segment |
Linia łamana wskazująca trasę, którą aplikacja kierowcy ma pojechać do następnego punktu na trasie. Ta lista jest też zwracana w Uwaga: to pole jest przeznaczone wyłącznie do użycia przez pakiet Driver SDK. Dekodowanie nie jest jeszcze obsługiwane. |
current_route_segment_traffic |
Tylko dane wejściowe. Fleet Engine wykorzystuje te informacje do ulepszania udostępniania podróży. Uwaga: to pole jest przeznaczone wyłącznie do użycia przez pakiet Driver SDK. |
current_route_segment_version |
Tylko dane wyjściowe. Czas ustawienia |
current_route_segment_end_point |
Punkt na trasie, w którym kończy się trasa |
remaining_distance_meters |
Pozostała odległość dojazdu samochodem z: |
eta_to_first_waypoint |
Szacowany czas dotarcia 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. Ostatnia aktualizacja pola |
back_to_back_enabled |
Wskazuje, czy kierowca akceptuje podróże z powrotem. Jeśli |
navigation_status |
Stan nawigacji pojazdu. |
device_settings |
Tylko dane wejściowe. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę. |
Typ pojazdu
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 |
Pojazdy obsługujące taksówki (zwykle licencjonowane lub podlegające regulacjom prawnym). |
TRUCK |
Zwykle jest to samochód o dużej pojemności. |
TWO_WHEELER |
Motocykl, motorower lub inny pojazd dwukołowy |
BICYCLE |
Transport obsługiwany przez ludzi |
PEDESTRIAN |
Pracownik transportu, zazwyczaj idący lub biegający, poruszający się po chodnikach. |
Atrybut pojazdu
Opisuje atrybut pojazdu jako para klucz-wartość. Długość ciągu znaków „klucz:wartość” nie może przekraczać 256 znaków.
Pola | |
---|---|
key |
Klucz atrybutu. Klucze nie mogą zawierać znaku dwukropka (:). |
value |
Wartość atrybutu. |
Pole Unii vehicle_attribute_value . Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. vehicle_attribute_value może mieć tylko jedną z tych wartości: |
|
string_value |
Wartość atrybutu podana jako ciąg znaków. Uwaga: to pole jest takie samo jak pole |
bool_value |
Wpisana wartość atrybutu logiczna. |
number_value |
Wpisano dwukrotnie wartość atrybutu. |
Lista atrybutów pojazdów
Typ danych listy dla atrybutów pojazdu.
Pola | |
---|---|
attributes[] |
Lista atrybutów w tej kolekcji. |
Lokalizacja pojazdu
Lokalizacja, prędkość i kierunek pojazdu w danym momencie.
Pola | |
---|---|
location |
Lokalizacja pojazdu. Gdy jest wysyłany do Fleet Engine, lokalizacja pojazdu jest określana na podstawie GPS-u. Gdy otrzymasz informacje o lokalizacji pojazdu, możesz podać lokalizację pojazdu, na przykład lokalizację GPS, uzupełniającą ją lub inną przybliżoną lokalizację. Źródło jest określone w polu |
horizontal_accuracy |
Wycofane: użyj atrybutu |
latlng_accuracy |
Dokładność |
heading |
Kierunek, w którym porusza się pojazd, 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 powyżej 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. Godzina, o której serwer odebrał informacje o lokalizacji. |
location_sensor |
Dostawca danych o lokalizacji (np. |
is_road_snapped |
Określa, czy element |
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 wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji ta wartość będzie wynosić 0. Jeśli godzina jest nieznana (na przykład po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do zera. |
num_stale_updates |
Tylko dane wejściowe. Wycofane: do określania, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały. |
raw_location |
Lokalizacja nieprzetworzonego pojazdu (nieprzetworzona przez snapper). |
raw_location_time |
Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją. |
raw_location_sensor |
Źródło nieprzetworzonej lokalizacji. |
raw_location_accuracy |
Dokładność |
supplemental_location |
Dodatkowa lokalizacja udostępniana przez aplikację integracyjną. |
supplemental_location_time |
Sygnatura czasowa związana z dodatkową lokalizacją. |
supplemental_location_sensor |
Źródło dodatkowej lokalizacji. |
supplemental_location_accuracy |
Dokładność |
road_snapped |
Wycofane: użyj atrybutu |
Dopasowanie pojazdów
Zawiera dane pojazdu i powiązane z nim dane szacunkowe dotyczące pojazdu, które pasują do punktów aktywnych przejazdów pojazdu SearchVehiclesRequest
.
Pola | |
---|---|
vehicle |
Wymagany. Pojazd pasujący do żądania. |
vehicle_pickup_eta |
Szacowany czas dotarcia pojazdem do punktu odbioru określonego w żądaniu. Pusta wartość oznacza błąd przy obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli |
vehicle_pickup_distance_meters |
Odległość od aktualnej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, z uwzględnieniem wszystkich pośrednich punktów odbioru i zwrotu w przypadku dotychczasowych podróży. Ta odległość obejmuje obliczoną odległość (trasę) oraz odległość linii prostej między punktem końcowym nawigacji a żądanym punktem odbioru. (Odległość między punktem końcowym nawigacji a żądanym punktem odbioru jest zwykle mała). Pusta wartość oznacza błąd w obliczaniu odległości. |
vehicle_pickup_straight_line_distance_meters |
Wymagany. Odległość w prostej linii między pojazdem a punktem odbioru określona w żądaniu. |
vehicle_dropoff_eta |
Szacowany czas dotarcia z pełnym pojazdem do punktu zwrotu wskazanego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje postój w dowolnym punkcie na drodze przed |
vehicle_pickup_to_dropoff_distance_meters |
Odległość pojazdu (w metrach) od punktu odbioru do punktu zwrotu określonego w żądaniu. Odległość między dwoma punktami nie obejmuje lokalizacji pojazdu ani żadnych innych miejsc, które trzeba odwiedzić przed przybyciem do punktu odbioru lub miejsca wysyłki. Ta wartość jest wypełniana tylko wtedy, gdy w żądaniu określisz parametr |
trip_type |
Wymagany. Typ podróży w odpowiedzi na żądanie, który został użyty do obliczenia szacowanego czasu dotarcia do punktu odbioru. |
vehicle_trips_waypoints[] |
Uporządkowana lista punktów pośrednich używanych do obliczenia szacowanego czasu dotarcia. Lista obejmuje lokalizację pojazdu, punkty odbioru aktywnych przejazdów pojazdem i punkty odbioru określone w prośbie. Pusta lista oznacza błąd przy obliczaniu szacowanego czasu dotarcia w przypadku pojazdu. |
vehicle_match_type |
Dopasowany typ pojazdu. |
requested_ordered_by |
Żądana kolejność sortowania pojazdów. |
ordered_by |
Rzeczywiste zamówienie użyte dla tego pojazdu. Zwykle ta wartość odpowiada polu „order_by” w żądaniu, ale w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, możesz użyć innej metody (np. |
Typ dopasowania pojazdu
Dopasowany typ pojazdu.
Wartości w polu enum | |
---|---|
UNKNOWN |
Nieznany typ dopasowania pojazdu |
EXCLUSIVE |
Pojazd nie ma obecnie przypisanej podróży i może zostać uwzględniony w punkcie odbioru. |
BACK_TO_BACK |
Pojazd jest obecnie przypisany do podróży, ale po jej zakończeniu można dotrzeć do punktu odbioru. W obliczeniach szacowanego czasu dotarcia i odległości bierze się pod uwagę istniejącą podróż. |
CARPOOL |
Pojazd ma wystarczającą pojemność na wspólne przejazdy. |
CARPOOL_BACK_TO_BACK |
Pojazd zakończy swoją bieżącą, aktywną podróż przed przejściem do punktu odbioru. W obliczeniach szacowanego czasu dotarcia i odległości bierze się pod uwagę istniejącą podróż. |
VehicleState,
Stan obiektu Vehicle
.
Wartości w polu enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
Domyślny używany w przypadku nieokreślonych lub nierozpoznanych stanów pojazdu. |
OFFLINE |
Pojazd nie przyjmuje nowych tras. Uwaga: pojazd może nadal działać w tym stanie podczas wykonywania przypisanej do niego podróży. |
ONLINE |
Pojazd przyjmuje nowe trasy. |
VisualTrafficReportPolylineRendering
Opisuje, jak klienci powinni pokolorować jedną część linii łamanej na trasie.
Pola | |
---|---|
road_stretch[] |
Opcjonalnie. Odcinki dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia mają pewność, że nie nakładają się na siebie i nie muszą obejmować całej trasy. Jeśli nie można dodać stylu do drogi, klient powinien zastosować dla trasy ustawienie domyślne. |
Rozciąganie
Jeden odcinek drogi do wyrenderowania.
Pola | |
---|---|
style |
Wymagany. Styl, który chcesz zastosować. |
offset_meters |
Wymagany. Styl powinien być stosowany w okresie |
length_meters |
Wymagany. Długość ścieżki, w której ma zostać zastosowany styl. |
Styl
Styl natężenia ruchu wskazujący prędkość ruchu.
Wartości w polu enum | |
---|---|
STYLE_UNSPECIFIED |
Nie wybrano stylu. |
SLOWER_TRAFFIC |
Ruch zwalnia. |
TRAFFIC_JAM |
Występuje korek. |
Punkt pośredni
Opisuje punkty pośrednie na trasie.
Pola | |
---|---|
lat_lng |
Lokalizacja tego punktu na trasie. |
eta |
Szacowany czas dotarcia pojazdu do tego punktu pośredniego. |
Typ punktu pośredniego
Typ punktu pośredniego.
Wartości w polu enum | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
Nieznany lub nieokreślony typ punktu pośredniego. |
PICKUP_WAYPOINT_TYPE |
Punkty pośrednie do odbioru pasażerów lub przedmiotów. |
DROP_OFF_WAYPOINT_TYPE |
Punkty pośrednie umożliwiające rezygnację z podróżujących lub przedmiotów. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
Punkty pośrednie pośrednie podczas podróży z wieloma miejscami docelowymi. |