Package maps.fleetengine.v1

Indeks

TripService

Usługa zarządzania podróżą.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Tworzy przejazd w silniku floty i zwraca nowy przejazd.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Uzyskaj informacje o pojedynczej podróży.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

zgłaszać korzystanie z płatnej podróży;

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Pobierz wszystkie podróże danego pojazdu.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualizuje dane dotyczące przejazdu.

VehicleService

Usługa zarządzania pojazdami.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

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

Podczas tworzenia Vehicle wymagane są te pola Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia Vehicle są ignorowane następujące pola Vehicle:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostaną podane.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Zwraca pojazd z Fleet Engine.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Zwraca ponumerowane na stronach listy pojazdów powiązanych z dostawcą, które pasują do opcji żądania.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Zapisuje zaktualizowane dane pojazdu w Fleet Engine.

Podczas aktualizowania Vehicle nie można zaktualizować tych pól, ponieważ są one zarządzane przez serwer:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Nie można też zaktualizować pojazdu name.

Jeśli pole attributes zostanie zaktualizowane, wszystkie atrybuty pojazdu zostaną zastąpione atrybutami podanymi w żądaniu. Jeśli chcesz zaktualizować tylko niektóre atrybuty, użyj metody UpdateVehicleAttributes. Podobnie pole waypoints może być aktualizowane, ale musi zawierać wszystkie punkty kontrolne znajdujące się obecnie w pojazdach, i żadne inne punkty kontrolne.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

częściowo aktualizuje atrybuty pojazdu; Zaktualizowane zostaną tylko atrybuty wymienione w żądaniu. Pozostałe atrybuty NIE zostaną zmienione. Uwaga: w przypadku UpdateVehicle jest to inne, ponieważ całe pole attributes zostanie zastąpione polem z UpdateVehicleRequest, a atrybuty, których nie ma w żądaniu, zostaną usunięte.

BatteryInfo

Informacje o baterii urządzenia.

Pola
battery_status

BatteryStatus

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

power_source

PowerSource

Stan źródła zasilania z baterii.

battery_percentage

float

Aktualny procent naładowania baterii [0–100].

BatteryStatus

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

Wartości w polu enum
UNKNOWN_BATTERY_STATUS Stan baterii jest nieznany.
BATTERY_STATUS_CHARGING Bateria jest ładowana.
BATTERY_STATUS_DISCHARGING Bateria się rozładowuje.
BATTERY_STATUS_FULL Bateria jest pełna.
BATTERY_STATUS_NOT_CHARGING Bateria się nie ładuje.
BATTERY_STATUS_POWER_LOW Bateria jest słaba.

BillingPlatformIdentifier

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

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

ConsumableTrafficPolyline

Gęstość ruchu na trasie pojazdu.

Pola
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

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

CreateTripRequest

wiadomość o prośbie o utworzenie podróży;

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

trip_id

string

Wymagane. Unikalny identyfikator przejazdu. z zastosowaniem tych ograniczeń:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • znormalizowany zgodnie z formą normalizacji C standardu Unicode.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
trip

Trip

Wymagane. Encja podróży do utworzenia.

Podczas tworzenia podróży wymagane są te pola:

  • trip_type
  • pickup_point

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

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

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

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

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

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

Używane są pola trip_id, waypoint_typelocation, a pozostałe pola TripWaypoint w vehicle_waypoints są ignorowane.

CreateVehicleRequest

CreateVehicle prośba o spotkanie.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Wymagane. Unikalny identyfikator pojazdu. z zastosowaniem tych ograniczeń:

  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • znormalizowany zgodnie z formą normalizacji C standardu Unicode.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
vehicle

Vehicle

Wymagane. Encja pojazdu do utworzenia. Podczas tworzenia pojazdu wymagane są te pola:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia pojazdu następujące pola są ignorowane:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostaną podane.

DeviceSettings

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

Pola
location_power_save_mode

LocationPowerSaveMode

Jak funkcje lokalizacji działają na urządzeniu, gdy włączone jest oszczędzanie baterii.

is_power_save_mode

bool

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

is_interactive

bool

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

battery_info

BatteryInfo

Informacje o stanie baterii.

GetTripRequest

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

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

view

TripView

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

current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia) dla danych Trip.route lub Trip.current_route_segment. Jeśli dane trasy nie zmieniły się od tego sygnatury czasowej, pole route nie jest ustawione w odpowiedzi. Jeśli nie określisz minimalnej wartości, dane trasy będą zawsze pobierane.

remaining_waypoints_version

Timestamp

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

route_format_type

PolylineFormatType

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

current_route_segment_traffic_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

GetVehicle prośba o spotkanie.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

current_route_segment_version

Timestamp

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

waypoints_version

Timestamp

Wskazuje minimalny znacznik czasu (wykluczający) dla którego pobierane są dane Vehicle.waypoints. Jeśli punkty pośrednie nie uległy zmianie od tego sygnatury czasowej, dane vehicle.waypoints nie są ustawione w odpowiedzi. Jeśli to pole nie zostanie określone, zawsze jest pobierana wartość vehicle.waypoints.

LicensePlate

Informacje o tablicy rejestracyjnej pojazdu. Aby uniknąć przechowywania informacji umożliwiających identyfikację, w ramach elementu są przechowywane tylko minimalne informacje o tablicy rejestracyjnej.

Pola
country_code

string

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

last_character

string

Ostatnia cyfra numeru rejestracyjnego lub „-1”, aby wskazać, że numer rejestracyjny nie zawiera wartości liczbowej.

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

ListVehiclesRequest

ListVehicles prośba o spotkanie.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

page_size

int32

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

page_token

string

Wartość next_page_token z poprzedniego wywołania funkcji ListVehicles, która umożliwia przewijanie grup pojazdów. Wartość jest niezdefiniowana, jeśli kryteria filtra żądania są inne niż kryteria filtra w poprzednim wywołaniu funkcji ListVehicles.

minimum_capacity

Int32Value

Określa minimalną wymaganą pojemność pojazdu. Wszystkie zwrócone pojazdy będą miały wartość maximum_capacity większą lub równą tej wartości. Jeśli jest ustawiona, musi być większa od lub równa 0.

trip_types[]

TripType

Ogranicza odpowiedź do pojazdów obsługujących co najmniej jeden z wybranych typów przejazdu.

maximum_staleness

Duration

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

vehicle_type_categories[]

Category

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

required_attributes[]

string

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

required_attributes to lista; required_one_of_attributes używa wiadomości, która umożliwia utworzenie listy list. Te 2 pola umożliwiają sformułowanie tego wyrażenia:

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

Ogranicza odpowiedź do pojazdów o określonych atrybutach. To pole jest operacją konjunkcji (AND). Maksymalna dozwolona liczba atrybutów required_attributes to 50. Jest to zgodne z maksymalną liczbą atrybutów dozwolonych w przypadku pojazdu. Każdy powtarzany ciąg znaków powinien mieć format „klucz:wartość”.

required_one_of_attributes[]

string

Ogranicza odpowiedź do pojazdów z co najmniej 1 z określonych atrybutów w każdym elemencie VehicleAttributeList. W każdej z tych list pojazd musi pasować do co najmniej jednego atrybutu. To pole jest operacją łącznie z wykluczeniem OR w każdym VehicleAttributeList i operacją z wykluczeniem AND w zbiorze VehicleAttributeList. Każdy powtarzany ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets zapewnia dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, usługa required_one_of_attribute_sets używa wiadomości, która umożliwia tworzenie listy list, co pozwala na tworzenie wyrażeń takich jak:

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

Ogranicza odpowiedź do pojazdów, które pasują do wszystkich atrybutów w pliku VehicleAttributeList. W każdej z list pojazd musi odpowiadać wszystkim atrybutom. To pole jest operacją konjunkcji (I) w przypadku każdego VehicleAttributeList i operacją z wykluczeniem (LUB) w przypadku zbioru VehicleAttributeList. Każdy powtarzany ciąg znaków powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

vehicle_state

VehicleState

Ogranicza odpowiedź do pojazdów, które mają ten stan pojazdu.

on_trip_only

bool

zwracać tylko pojazdy z obecnymi podróżami;

filter

string

Opcjonalnie: Zapytanie filtra stosowane podczas wyświetlania pojazdów. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160.

To pole ma zastąpić pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli tutaj zostanie określona niepusta wartość, pola required_attributes, required_one_of_attributesrequired_one_of_attributes_sets muszą być puste.

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

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

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

viewport

Viewport

Opcjonalnie: Filtr, który ogranicza zwracane pojazdy do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym przez widoczny obszar.

ListVehiclesResponse

ListVehicles wiadomość z odpowiedzią.

Pola
vehicles[]

Vehicle

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

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

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

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

LocationSensor

Czujnik lub metodologia służąca 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. Zwykle ta wartość jest używana do lokalizacji pochodzącej ze źródeł innych niż urządzenie mobilne z pakietem Driver SDK. Jeśli pierwotne źródło jest opisane za pomocą innej wartości z enumeracji, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle podawane za pomocą last_location.supplemental_location_sensor pojazdu.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli zostanie otrzymana w żądaniu.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji na Androidzie.
CORE_LOCATION Dostawca danych o lokalizacji w systemach operacyjnych Apple.

Stan nawigacji pojazdu.

Wartości w polu enum
UNKNOWN_NAVIGATION_STATUS Nieokreślony stan nawigacji.
NO_GUIDANCE Nawigacja w aplikacji Kierowca jest w trybie FREE_NAV.
ENROUTE_TO_DESTINATION Dostępna jest nawigacja zakręt po zakrętem, a nawigacja w aplikacji Kierowca przeszła w tryb GUIDED_NAV.
OFF_ROUTE Pojazd zjechał z zalecanej trasy.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.

PolylineFormatType

Typ formatu wielokąta.

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

PowerSource

Typ ładowarki używanej do ładowania baterii.

Wartości w polu enum
UNKNOWN_POWER_SOURCE Źródło zasilania nieznane.
POWER_SOURCE_AC Źródło zasilania to ładowarka sieciowa.
POWER_SOURCE_USB Źródło zasilania to port USB.
POWER_SOURCE_WIRELESS Źródło zasilania jest bezprzewodowe.
POWER_SOURCE_UNPLUGGED Bateria jest odłączona.

ReportBillableTripRequest

Wiadomość z prośbą o zgłoszenie nieodpłatnej przelotu.

Pola
name

string

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

country_code

string

Wymagane. Dwuliterowy kod kraju, w którym odbywa się podróż. Cena jest określana zgodnie z kodem kraju.

platform

BillingPlatformIdentifier

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

related_ids[]

string

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

solution_type

SolutionType

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

SolutionType

Selektor różnych typów rozwiązań zgłoszonej podróży.

Wartości w polu enum
SOLUTION_TYPE_UNSPECIFIED Wartość domyślna. Ze względu na zgodność wsteczną interfejs API domyślnie używa rozwiązania ON_DEMAND_RIDESHARING_AND_DELIVERIES, które jest pierwszym obsługiwanym typem rozwiązania.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Rozwiązaniem jest przejazd i dostawy na żądanie.

RequestHeader

RequestHeader zawiera pola wspólne dla wszystkich żądań RPC Fleet Engine.

Pola
language_code

string

Kod języka BCP-47, np. pl-PL lub sr-Latn. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli nie zostanie określony żaden język, odpowiedź może być w dowolnym języku, przy czym preferowany jest angielski, jeśli taka nazwa istnieje. Przykład wartości pola: en-US.

region_code

string

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

sdk_version

string

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

os_version

string

Wersja systemu operacyjnego, w którym działa wywoływane SDK. Przykłady wartości pola: 4.4.1, 12.1.

device_model

string

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

sdk_type

SdkType

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

maps_sdk_version

string

Wersja MapSDK, z której korzysta wywoływany pakiet SDK (w odpowiednich przypadkach). Format wersji to „duża.mała.łatka”, np. 5.2.1.

nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywoływany pakiet SDK (w odpowiednich przypadkach). Format wersji to „duża.mała.łatka”, np. 2.1.0.

platform

Platform

Platforma wywołującego pakietu SDK.

manufacturer

string

Producent urządzenia z Androidem wywołującego pakiet SDK (dotyczy tylko pakietów SDK na Androida). Przykład wartości pola: Samsung.

android_api_level

int32

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

trace_id

string

Opcjonalny identyfikator, który można podać w celu rejestrowania, aby zidentyfikować żądanie.

Platforma

Platforma wywołującego pakietu SDK.

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

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 element sdk_type jest pominięty.
CONSUMER Pakiet SDK wywołujący to Consumer.
DRIVER Pakiet SDK wywołujący to Driver.
JAVASCRIPT Pakiet SDK wywołujący to JavaScript.

SearchTripsRequest

wiadomość z prośbą o wyszukiwanie podróży,

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Pojazd powiązany z podróżami w żądaniu. Jeśli nie podano tego argumentu, zwracane przejazdy nie zawierają:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Jeśli ustawisz tę opcję na PRAWDA, odpowiedź będzie zawierać Przejazdy, które wpływają na trasę kierowcy.

page_size

int32

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

page_token

string

Aby kontynuować z poprzednich wyników, ustaw tę wartość na wartość zwróconą wcześniej w SearchTripsResponse.

minimum_staleness

Duration

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

SearchTripsResponse

wiadomość z odpowiedzią od SearchTrips.

Pola
trips[]

Trip

Lista przejazdów dla wybranego pojazdu.

next_page_token

string

Przekaz ten token w SearchTripsRequest, aby wyświetlić wyniki wyszukiwania. Interfejs API zwraca listę przejazdów przy każdym wywołaniu, a gdy nie ma już wyników, lista przejazdów jest pusta.

SearchVehiclesRequest

SearchVehicles prośba o spotkanie.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

pickup_point

TerminalLocation

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

dropoff_point

TerminalLocation

Miejsce docelowe dostawy wskazane przez klienta. To pole jest wymagane, jeśli trip_types zawiera TripType.SHARED.

pickup_radius_meters

int32

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

count

int32

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

minimum_capacity

int32

Wymagane. Określa liczbę pasażerów, którzy mogą wziąć udział w podróży. Wartość musi być większa lub równa 1. Kierowca nie jest uwzględniany w wartości pojemności.

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_types[]

VehicleType

Wymagane. Ogranicza wyszukiwanie do pojazdów jednego z wybranych typów. Musisz określić co najmniej 1 typ pojazdu. Typy pojazdów z kategorią UNKNOWN są niedozwolone.

required_attributes[]

VehicleAttribute

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

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

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

Ogranicza wyszukiwanie tylko do pojazdów z określonymi atrybutami. To pole jest operacją konjunkcji (AND). Maksymalna dozwolona liczba atrybutów required_attributes to 50. Jest to zgodne z maksymalną liczbą atrybutów dozwolonych dla pojazdu.

required_one_of_attributes[]

VehicleAttributeList

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

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets zapewnia dodatkowe funkcje.

Podobnie jak w przypadku required_one_of_attributes, usługa required_one_of_attribute_sets używa wiadomości, która umożliwia tworzenie listy list, co pozwala na tworzenie wyrażeń takich jak to:

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

Ogranicza wyszukiwanie tylko do tych pojazdów, które mają wszystkie atrybuty w VehicleAttributeList. W każdej z list pojazd musi odpowiadać wszystkim atrybutom. To pole jest operacją konjunkcji (I) w przypadku każdego VehicleAttributeList i operacją z wykluczeniem (LUB) w przypadku zbioru VehicleAttributeList.

order_by

VehicleMatchOrder

Wymagane. Określa żądane kryterium sortowania wyników.

include_back_to_back

bool

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

Wartością domyślną jest false.

trip_id

string

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

current_trips_present

CurrentTripsPresent

Wskazuje, czy pojazdy z aktywnymi przejazdami kwalifikują się do tego wyszukiwania. Jeśli trip_type zawiera SHARED, musi mieć wartość inną niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.

filter

string

Opcjonalnie: Filtr do stosowania podczas wyszukiwania pojazdów. Przykłady składni filtra znajdziesz na stronie http://aip.dev/160.

To pole ma zastąpić pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli tutaj zostanie określona niepusta wartość, pola required_attributes, required_one_of_attributesrequired_one_of_attributes_sets muszą być puste.

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

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

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

CurrentTripsPresent

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

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

VehicleMatchOrder

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

Wartości w polu enum
UNKNOWN_VEHICLE_MATCH_ORDER Domyślna, używana w przypadku nieokreślonego lub nierozpoznanego pojazdu dopasowującego zamówienie.
PICKUP_POINT_ETA rosnąco według czasu przejazdu pojazdu do punktu odbioru;
PICKUP_POINT_DISTANCE rosnąco według odległości przebytej przez pojazd do miejsca odbioru;
DROPOFF_POINT_ETA rosnąco według czasu przejazdu pojazdu do miejsca dostawy; Z tego zamówienia można korzystać tylko wtedy, gdy w prośbie podano punkt dostawy.
PICKUP_POINT_STRAIGHT_DISTANCE rosnąco według odległości w linii prostej od ostatniej zgłoszonej lokalizacji pojazdu do punktu odbioru;
COST rosnąco według skonfigurowanego kosztu dopasowania; Koszt dopasowania jest zdefiniowany jako ważona kombinacja odległości w linii prostej i czasu dojazdu. Wagi są ustawiane z wartościami domyślnymi i można je modyfikować w przypadku poszczególnych klientów. Jeśli te wagi trzeba zmodyfikować w przypadku Twojego projektu, skontaktuj się z zespołem pomocy Google.

SearchVehiclesResponse

SearchVehicles wiadomość z odpowiedzią.

Pola
matches[]

VehicleMatch

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

SpeedReadingInterval

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

Pola
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja szybkości ścieżki na podstawie danych o ruchu.

Wartości w polu enum
SPEED_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NORMAL Normalna prędkość, nie wykryto spowolnienia.
SLOW Wykryto spowolnienie, ale nie utworzyła się korka.
TRAFFIC_JAM Wykryto korek uliczny.

StopLocation

Rzeczywista lokalizacja przystanku (odbiór/zwrot).

Pola
point

LatLng

Wymagane. Oznacza rzeczywistą lokalizację.

timestamp

Timestamp

Wskazuje, kiedy nastąpiło zatrzymanie.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Określa lokalizację punktu kontrolnego.

Pola
point

LatLng

Wymagane. Wskazuje lokalizację punktu kontrolnego podróży.

terminal_point_id
(deprecated)

TerminalPointId

Wycofane: zamiast tego użyj pola point.

access_point_id
(deprecated)

string

Wycofane: zamiast tego użyj pola point.

trip_id
(deprecated)

string

Rola wycofana.

terminal_location_type
(deprecated)

WaypointType

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

TerminalPointId

Wycofane: punkty terminalowe nie są już obsługiwane w Fleet Engine. Zamiast tego użyj pola TerminalLocation.point.

Pola
value
(deprecated)

string

Rola wycofana.

Pole unii Id. Rola wycofana. Id może być tylko jednym z tych elementów:
place_id
(deprecated)

string

Rola wycofana.

generated_id
(deprecated)

string

Rola wycofana.

TrafficPolylineData

warunki na drodze na przewidywanej trasie pojazdu;

Pola
traffic_rendering

VisualTrafficReportPolylineRendering

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

Podróż

Metadane dotyczące podróży.

Pola
name

string

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

vehicle_id

string

Identyfikator pojazdu, który odbywa podróż.

trip_status

TripStatus

Bieżący stan podróży.

trip_type

TripType

Typ podróży.

pickup_point

TerminalLocation

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

actual_pickup_point

StopLocation

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

actual_pickup_arrival_point

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do punktu odbioru. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o faktycznym przybyciu do punktu odbioru.

pickup_time

Timestamp

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

intermediate_destinations[]

TerminalLocation

Przerwy na trasie (oprócz miejsca odbioru i celu podróży). Początkowo nie będzie to możliwe w przypadku udostępnionych przejazdów.

intermediate_destinations_version

Timestamp

Wskazuje, kiedy intermediate_destinations został ostatnio zmodyfikowany. Twój serwer powinien przechowywać tę wartość w pamięci podręcznej i przekazywać ją w UpdateTripRequest podczas aktualizacji intermediate_destination_index, aby zapewnić, że wartość intermediate_destinations się nie zmieni.

intermediate_destination_index

int32

Jeśli TripStatus = ENROUTE_TO_INTERMEDIATE_DESTINATION, to liczba z zakresu [0..N-1], która wskazuje, który pośredni punkt docelowy pojazd przejdzie jako następny. Gdy TripStatus = ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1], która wskazuje, w jakiej lokalizacji pośredniej znajduje się pojazd. Wartość tę ustawia dostawca. Jeśli nie ma wartości intermediate_destinations, to pole jest ignorowane.

actual_intermediate_destination_arrival_points[]

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do miejsca docelowego pośredniego. To pole jest przeznaczone dla dostawcy, który może podać informacje o rzeczywistym czasie przybycia do pośrednich miejsc docelowych.

actual_intermediate_destinations[]

StopLocation

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

dropoff_point

TerminalLocation

Miejsce, w którym klient chce zostać odebrany.

actual_dropoff_point

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce, w którym klient został odwieziony. To pole jest przeznaczone dla dostawcy, który może podać informacje o rzeczywistym czasie i miejscu odwiezienia.

dropoff_time

Timestamp

Tylko dane wyjściowe. Przewidywany czas, w którym pasażerowie zostaną wysadzeni w miejscu docelowym, lub rzeczywisty czas ich wysadzenia.

remaining_waypoints[]

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka z bieżącej lokalizacji do punktu docelowego. Ta ścieżka może zawierać punkty pośrednie z innych podróży.

vehicle_waypoints[]

TripWaypoint

To pole umożliwia ręczne sortowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty pośrednie dla przypisanego pojazdu, a także punkty odbioru i rozładunku w ramach tej podróży. Jeśli podróż nie została przypisana do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane przez serwer tylko w przypadku wywołań UpdateTripCreateTrip, a nie GetTrip.

route[]

LatLng

Tylko dane wyjściowe. Przewidywana trasa dla tej podróży do pierwszego wpisu w pliku remaining_waypoints. Pamiętaj, że pierwszy punkt kontrolny może należeć do innej podróży.

current_route_segment

string

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

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

current_route_segment_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy trasa została ostatnio zmodyfikowana.

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK kierowcy i pakiet SDK dla konsumentów.

current_route_segment_traffic

ConsumableTrafficPolyline

Tylko dane wyjściowe. Wskazuje warunki natężenia ruchu na trasie current_route_segment (jeśli są dostępne).

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK kierowcy i pakiet SDK klienta.

current_route_segment_traffic_version

Timestamp

Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji current_route_segment_traffic.

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK kierowcy i pakiet SDK klienta.

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

Tylko dane wyjściowe. Pozostała odległość do przejechania w polu current_route_segment. Jeśli przejazd nie jest przypisany do pojazdu lub został już zrealizowany lub anulowany, wartość jest nieokreślona.

eta_to_first_waypoint

Timestamp

Tylko dane wyjściowe. Przewidywany czas dotarcia do następnego punktu orientacyjnego (pierwszy wpis w polu remaining_waypoints). Wartość jest nieokreślona, jeśli przejazd nie jest przypisany do pojazdu lub jest nieaktywny (ukończony lub anulowany).

remaining_time_to_first_waypoint

Duration

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

remaining_waypoints_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano remaining_waypoints.path_to_waypoint i remaining_waypoints.traffic_to_waypoint. Aplikacja klienta powinna przechowywać tę wartość w pamięci podręcznej i przekazywać ją w wartości GetTripRequest, aby zapewnić, że ścieżki i ruchy dla remaining_waypoints są zwracane tylko wtedy, gdy są zaktualizowane.

number_of_passengers

int32

Niezmienna. Wskazuje liczbę pasażerów w danej podróży, nie uwzględniając kierowcy. Samochód musi mieć dostępne miejsce, aby można było zwrócić odpowiedź SearchVehicles.

last_location

VehicleLocation

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

last_location_snappable

bool

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

view

TripView

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

TripStatus

Stan przejazdu wskazujący jego 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 miejsca odbioru.
ARRIVED_AT_PICKUP Kierowca dotarł do punktu 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 (a nie do miejsca wysadzania).
ENROUTE_TO_DROPOFF Kierowca odebrał pasażera i jedzie do następnego miejsca docelowego.
COMPLETE Pasażer został już odwieziony, a przejazd został zakończony.
CANCELED Przejazd został anulowany przed odbiorem przez kierowcę, pasażera lub dostawcę usług przewozu.

TripType

Typ podróży.

Wartości w polu enum
UNKNOWN_TRIP_TYPE Domyślna, używana w przypadku nieokreślonych lub nierozpoznanych typów podróży.
SHARED Podróż może być realizowana tym samym pojazdem co inne.
EXCLUSIVE Podróż jest związana z jednym pojazdem.

TripView

Selektor różnych zestawów pól Podróż w odpowiedzi GetTrip. Więcej informacji znajdziesz w AIP-157. Prawdopodobnie zostaną dodane dodatkowe widoki.

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Ze względu na zgodność wsteczną interfejs API domyślnie wyświetla widok pakietu SDK. Aby zapewnić stabilność i obsługę, zalecamy klientom wybranie TripView innego niż SDK.
SDK Obejmuje pola, które mogą nie być interpretowane lub obsługiwane za pomocą publicznie dostępnych bibliotek.
JOURNEY_SHARING_V1S Pola dotyczące podróży są wypełniane w przypadku udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

TripWaypoint

Opisuje punkt postoju na trasie pojazdu lub punkt końcowy podróży pojazdu.

Pola
location

TerminalLocation

Lokalizacja tego punktu kontrolnego.

trip_id

string

Podróż powiązana z tym punktem orientacyjnym.

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

Ścieżka od poprzedniego punktu do bieżącego punktu. Niezdefiniowane dla pierwszego punktu na liście. To pole jest wypełniane tylko na żądanie.

encoded_path_to_waypoint

string

Zakodowana ścieżka od poprzedniego punktu do bieżącego.

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

traffic_to_waypoint

ConsumableTrafficPolyline

Warunki na drodze do tego punktu kontrolnego. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z rozwiązania Przejazdy i dostawy w ramach platformy Map Google.

distance_meters

Int32Value

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

eta

Timestamp

Szacowany czas dotarcia do tego punktu orientacyjnego. Niezdefiniowane dla pierwszego punktu na liście.

duration

Duration

Czas przejazdu od poprzedniego punktu do tego punktu. Nieokreślony dla pierwszego punktu na liście.

UpdateTripRequest

wiadomość z prośbą o zmianę rezerwacji,

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

trip

Trip

Wymagane. Podróż powiązana z aktualizacją.

Te pola są obsługiwane przez mechanizm floty. Nie aktualizuj ich za pomocą funkcji Trip.update.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

Podczas aktualizowania Trip.vehicle_id w przypadku wspólnej podróży musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów pośrednich. W przeciwnym razie kolejność będzie nieznana.

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

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

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

UpdateVehicleAttributes prośba o spotkanie.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

attributes[]

VehicleAttribute

Wymagane. Atrybuty pojazdu do zaktualizowania. Niewymienione atrybuty nie są zmieniane ani usuwane.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes wiadomość z odpowiedzią.

Pola
attributes[]

VehicleAttribute

Wymagane. Zaktualizowana pełna lista atrybutów pojazdu, w tym atrybuty nowe, zmienione i niezmienione.

UpdateVehicleRequest

`UpdateVehicle request message.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

vehicle

Vehicle

Wymagane. Wartości elementów Vehicle, które mają być stosowane. Podczas aktualizowania Vehicle te pola mogą nie zostać zaktualizowane, ponieważ są zarządzane przez serwer.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

Jeśli pole attributes zostanie zaktualizowane, wszystkie atrybuty pojazdu zostaną zastąpione atrybutami podanymi w żądaniu. Jeśli chcesz zaktualizować tylko niektóre atrybuty, użyj metody UpdateVehicleAttributes.

Podobnie pole waypoints może być aktualizowane, ale musi zawierać wszystkie punkty kontrolne znajdujące się obecnie w pojazdach, i żadne inne punkty kontrolne.

update_mask

FieldMask

Wymagane. Maska pól określająca, które pola w Vehicle mają zostać zaktualizowane. Musisz podać co najmniej 1 nazwę pola.

Pojazd

Metadane pojazdu.

Pola
name

string

Tylko dane wyjściowe. Unikalna nazwa tego pojazdu. Format to providers/{provider}/vehicles/{vehicle}.

vehicle_state

VehicleState

stan pojazdu;

supported_trip_types[]

TripType

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

current_trips[]

string

Tylko dane wyjściowe. Lista trip_id dla podróży obecnie przypisanych do tego pojazdu.

last_location

VehicleLocation

Ostatnia zgłoszona lokalizacja pojazdu.

maximum_capacity

int32

Łączna liczba pasażerów, których może przewieźć pojazd. W tej wartości nie uwzględnia się kierowcy. Ta wartość musi być większa niż lub równa 1.

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

Wymagane. Typ pojazdu. Można go użyć do filtrowania pojazdów w wynikach SearchVehicles. Ma też wpływ na obliczenia czasu dojazdu i trasy.

license_plate

LicensePlate

Informacje o tablicy rejestracyjnej pojazdu.

route[]
(deprecated)

TerminalLocation

Wycofane: użyj w zastępstwie tego Vehicle.waypoints.

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

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

current_route_segment_version

Timestamp

Tylko dane wyjściowe. Czas ustawienia current_route_segment. Może być przechowywany przez klienta i przekazywany w przyszłych żądaniach GetVehicle, aby zapobiec zwracaniu tras, które się nie zmieniły.

current_route_segment_end_point

TripWaypoint

Punkt orientacyjny, w którym kończy się current_route_segment. Kierowcy mogą podać te informacje podczas wywołania UpdateVehicle jako punkt na całej trasie, punkt na LatLng lub ostatni LatLng na current_route_segment. Jeśli punkt kontrolny nie jest w pełni określony, Fleet Engine zrobi, co w jego przypadku możliwe, aby go interpolować. To pole jest ignorowane w wywołaniach UpdateVehicle, chyba że podano też parametr current_route_segment.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Przewidywany czas dotarcia do pierwszego elementu w polu waypoints. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona.

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

remaining_time_seconds

Int32Value

Tylko dane wejściowe. Pozostały czas jazdy w przypadku current_route_segment. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona. Ta wartość powinna być równa eta_to_first_waypoint - current_time, jeśli wszystkie strony używają tego samego zegara.

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

waypoints[]

TripWaypoint

Pozostałe punkty drogi przypisane do tego pojazdu.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

Wskazuje, czy kierowca akceptuje przejazdy z kolei. Jeśli true, SearchVehicles może obejmować pojazd, nawet jeśli jest on obecnie przypisany do podróży. Wartością domyślną jest false.

navigation_status

NavigationStatus

Stan nawigacji pojazdu.

device_settings

DeviceSettings

Tylko dane wejściowe. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę.

VehicleType

Typ pojazdu.

Pola
category

Category

Kategoria typu pojazdu

Kategoria

Kategorie typu pojazdu

Wartości w polu enum
UNKNOWN Domyślna, używana w przypadku nieokreślonych lub nierozpoznanych kategorii pojazdów.
AUTO Samochód.
TAXI Każdy pojazd, który pełni funkcję taksówki (zazwyczaj jest licencjonowany lub regulowany).
TRUCK Zazwyczaj pojazd o dużej pojemności.
TWO_WHEELER motocykl, skuter lub inny pojazd dwukołowy;
BICYCLE Transport napędzany siłą ludzkich mięśni.
PEDESTRIAN Osoba poruszająca się pieszo lub biegnąca po chodniku.

VehicleAttribute

Opisuje atrybut pojazdu jako parę klucz-wartość. Długość ciągu znaków „klucz:wartość” nie może przekraczać 256 znaków.

Pola
key

string

Klucz atrybutu. Klucze nie mogą zawierać dwukropka (:).

value

string

Wartość atrybutu.

Pole unii vehicle_attribute_value. Wartość atrybutu może być typu string, bool lub double. vehicle_attribute_value może być tylko jednym z tych elementów:
string_value

string

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

Uwaga: to pole jest identyczne z polem value, które zostanie wycofane. W przypadku metod tworzenia lub aktualizowania możesz użyć dowolnego pola, ale zdecydowanie zalecamy użycie pola string_value. Jeśli opcje string_valuevalue są ustawione, muszą być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

bool_value

bool

Wartość atrybutu typu logicznego.

number_value

double

Wartość atrybutu typu podwójnego.

VehicleAttributeList

Typ danych lista-z-list dla atrybutów pojazdu.

Pola
attributes[]

VehicleAttribute

Lista atrybutów w tej kolekcji.

VehicleLocation

Lokalizacja, prędkość i kierunek pojazdu w danym momencie.

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest wysyłany do Fleet Engine, lokalizacja pojazdu to lokalizacja GPS. Gdy otrzymasz odpowiedź, lokalizacja pojazdu może być lokalizacja GPS, dodatkowa lub inna przybliżona lokalizacja. Źródło jest określone w pliku location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj w zastępstwie tego latlng_accuracy.

latlng_accuracy

DoubleValue

Dokładność: location m w promieniach.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

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

heading_accuracy

DoubleValue

Dokładność heading w stopniach.

altitude

DoubleValue

Wysokość w metrach nad WGS84.

vertical_accuracy
(deprecated)

DoubleValue

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

altitude_accuracy

DoubleValue

Dokładność altitude metrów.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Prędkość pojazdu w metrach na sekundę

speed_accuracy

DoubleValue

Dokładność speed w metrach na sekundę.

update_time

Timestamp

Czas, w którym czujnik location został zgłoszony przez czujnik zgodnie z zegarem czujnika.

server_time

Timestamp

Tylko dane wyjściowe. Czas, w którym serwer otrzymał informacje o lokalizacji.

location_sensor

LocationSensor

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

is_road_snapped

BoolValue

Określa, czy location jest dopasowane do drogi.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Surowa lokalizacja pojazdu (nieprzetworzona przez road-snapper).

raw_location_time

Timestamp

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

raw_location_sensor

LocationSensor

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

raw_location_accuracy

DoubleValue

Dokładność raw_location w metrach jako promień.

supplemental_location

LatLng

Dodatkowa lokalizacja dostarczona przez aplikację integrującą.

supplemental_location_time

Timestamp

Sygnatura czasowa powiązana z dodatkową lokalizacją.

supplemental_location_sensor

LocationSensor

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

supplemental_location_accuracy

DoubleValue

Dokładność supplemental_location jako promień w metrach.

road_snapped
(deprecated)

bool

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

VehicleMatch

Zawiera dane pojazdu i powiązane z nim szacunki, które pasują do punktów aktywnych podróży dla pojazdu SearchVehiclesRequest.

Pola
vehicle

Vehicle

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

vehicle_pickup_eta

Timestamp

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

vehicle_pickup_distance_meters

Int32Value

Odległość od bieżącej lokalizacji pojazdu do miejsca odbioru określonego w żądaniu, w tym odległość do wszystkich pośrednich miejsc odbioru lub wysadzania pasażerów w przypadku istniejących przejazdów. Odległość ta obejmuje obliczoną odległość dojazdu (trasy) oraz odległość w linii prostej między punktem końcowym nawigacji a żądanym miejscem odbioru. (odległość między punktem docelowym nawigacji a żądanym punktem odbioru jest zwykle niewielka). Pustą wartość oznacza błąd obliczania odległości.

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

Przewidywany czas dojazdu do miejsca docelowego wskazanego w żądaniu. Przewidywany czas przybycia uwzględnia postoje w dowolnych punktach pośrednich przed dropoff_point określonym w żądaniu. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie określony punkt odbioru. Pustą wartość oznacza błąd obliczania czasu przybycia.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Odległość (w metrach) od miejsca odbioru do miejsca docelowego określonego w żądaniu. Odległość jest obliczana tylko między 2 punktami i nie obejmuje lokalizacji pojazdu ani innych punktów, które muszą zostać odwiedzone przed dotarciem do punktu odbioru lub do punktu docelowego. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie podana wartość dropoff_point. Pustą wartość oznacza błąd obliczania odległości od punktu odbioru do punktu docelowego określonego w żądaniu.

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

Posortowana lista punktów pośrednich służących do obliczenia przewidywanego czasu dotarcia. Lista zawiera lokalizację pojazdu, punkty odbioru w przypadku aktywnych przejazdów oraz punkty odbioru podane w prośbie. Pusty wykaz oznacza, że nie udało się obliczyć czasu dotarcia pojazdu.

vehicle_match_type

VehicleMatchType

Typ dopasowania pojazdu.

requested_ordered_by

VehicleMatchOrder

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

ordered_by

VehicleMatchOrder

żądany porządek sortowania dopasowań pojazdów. Odpowiednik: requested_ordered_by.

VehicleMatchType

Typ dopasowania pojazdu.

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

VehicleState

Stan 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 rezerwacji. Uwaga: pojazd może nadal działać w tym stanie podczas wykonywania przypisanej mu podróży.
ONLINE Pojazd przyjmuje nowe rezerwacje.

VisualTrafficReportPolylineRendering

Opisuje, jak klienci powinni pokolorować jeden fragment ścieżki wielopunktowej.

Pola
road_stretch[]

RoadStretch

Opcjonalnie: Odcinki drogi, które powinny być renderowane wzdłuż linii łamanej. Odcinki nie mogą się nakładać i nie muszą obejmować całej trasy.

Jeśli nie ma odcinka drogi do stylizacji, klient powinien zastosować domyślny styl dla trasy.

RoadStretch

Jeden odcinek drogi, który powinien zostać wyświetlony.

Pola
style

Style

Wymagane. Styl, który chcesz zastosować.

offset_meters

int32

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

length_meters

int32

Wymagane. Długość ścieżki, na której ma być zastosowany styl.

Styl

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

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

Punkt pośredni

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

Pola
lat_lng

LatLng

Lokalizacja tego punktu kontrolnego.

eta

Timestamp

Szacowany czas dotarcia pojazdu do tego punktu orientacyjnego.

WaypointType

Typ punktu orientacyjnego.

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