Package maps.fleetengine.v1

Indeks

TripService

Usługa zarządzania podróżami.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Informacje o pojedynczej podróży.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Zgłoś płatne wykorzystanie podróży.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Znajdziesz tu wszystkie dane dotyczące podróży konkretnym pojazdem.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualizuje dane o podróży.

VehicleService

Zarządzanie pojazdami.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tworzony jest nowy pojazd powiązany z usługą wspólnych przejazdów na żądanie lub z dostawcą. Każdy element Vehicle musi mieć unikalny identyfikator pojazdu.

Podczas tworzenia Vehicle wymagane są te pola Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia Vehicle te pola Vehicle 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 zostały podane.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Zwraca pojazd z Fleet Engine.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Zwraca podzieloną na strony listę pojazdów powiązanych z dostawcą, które pasują do opcji żądania.

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 pojazdów we Fleet Engine.

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

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Nie można zaktualizować pojazdu name.

Jeśli pole attributes zostanie zaktualizowane, wszystkie atrybuty pojazdu zostaną zastąpione atrybutami podanymi w prośbie. Jeśli chcesz zaktualizować tylko niektóre atrybuty, zapoznaj się z metodą UpdateVehicleAttributes. Pole waypoints również można zaktualizować, ale musi zawierać wszystkie punkty pośrednie znajdujące się obecnie w pojeździe i nie może zawierać żadnych innych punktów.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Częściowo aktualizuje atrybuty pojazdu. Zaktualizowane zostaną tylko atrybuty wymienione w żądaniu. Pozostałe atrybuty NIE ulegną zmianie. Uwaga: różni się to w przypadku UpdateVehicle, gdzie całe pole attributes zostanie zastąpione wartością z UpdateVehicleRequest. Atrybuty, których nie ma w żądaniu, zostaną usunięte.

BatteryInfo

Informacje o baterii urządzenia.

Pola
battery_status

BatteryStatus

Stan baterii, stan naładowania, stan naładowania itd.

power_source

PowerSource

Stan źródła zasilania baterii.

battery_percentage

float

Bieżąca wartość procentowa baterii [0–100].

BatteryStatus

Stan baterii, stan naładowania, stan naładowania itd.

Wartości w polu enum
UNKNOWN_BATTERY_STATUS Nieznany stan baterii.
BATTERY_STATUS_CHARGING Trwa ładowanie baterii.
BATTERY_STATUS_DISCHARGING Bateria się rozładowuje.
BATTERY_STATUS_FULL Bateria jest naładowana.
BATTERY_STATUS_NOT_CHARGING Bateria się nie ładuje.
BATTERY_STATUS_POWER_LOW Bateria jest słaba.

BillingPlatformIdentifier

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

Wartości w polu enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Domyślny: Używane w przypadku nieokreślonych platform.
SERVER Platforma jest serwerem klienta.
WEB Platforma jest przeglądarką.
ANDROID Platforma to urządzenie mobilne z Androidem.
IOS Platforma to urządzenie mobilne z iOS.
OTHERS Inne platformy, które nie są wymienione w tym wyliczeniu.

ConsumableTrafficPolyline

Natężenie ruchu na trasie dla pojazdów.

Pola
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

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

CreateTripRequest

Wiadomość z żądaniem CreateTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

trip_id

string

Wymagane. Unikalny identyfikator podróży. Obowiązują następujące ograniczenia:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
trip

Trip

Wymagane. Element podróży do utworzenia.

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

  • trip_type
  • pickup_point

Te pola będą używane, jeśli je podasz:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Wszystkie pozostałe pola Podróż są ignorowane. Na przykład wszystkie podróże zaczynają się od trip_status o wartości NEW, nawet jeśli w prośbie o utworzenie zdasz trip_status o wartości CANCELED.

Tylko podróże (EXCLUSIVE) obsługują usługę intermediate_destinations.

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

Jeśli podasz Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie podróży pojazdu, bez dodatkowych punktów pośrednich. Punkty pośrednie musisz zamówić w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscem docelowym pośrednim, a wszystkie miejsca docelowe pośrednie znajdowały się przed punktem nadania. Punkty na trasie EXCLUSIVE nie mogą przeplatać się z żadnymi innymi podróżami.

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

CreateVehicleRequest

Wiadomość z prośbą: CreateVehicle.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Wymagane. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
vehicle

Vehicle

Wymagane. Podmiot Pojazd do utworzenia. Podczas tworzenia pojazdu musisz wypełnić te pola:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia pojazdu ignorowane są te pola:

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

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

DeviceSettings

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

Pola
location_power_save_mode

LocationPowerSaveMode

Jak funkcje lokalizacji działają na urządzeniu po włączeniu oszczędzania baterii.

is_power_save_mode

bool

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

is_interactive

bool

Wskazuje, czy urządzenie jest w trybie interaktywnym.

battery_info

BatteryInfo

Informacje o stanie baterii.

GetTripRequest

Wiadomość z żądaniem GetTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

view

TripView

Podzbiór pól Podróży, które powinny zostać zwrócone, i ich interpretacji.

current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane z kategorii Trip.route lub Trip.current_route_segment. Jeśli dane o trasie nie zmieniają się od tej sygnatury czasowej, pole trasy nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane o trasie są zawsze pobierane.

remaining_waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są Trip.remaining_waypoints. Jeśli nie zmieniają się od tej sygnatury czasowej, w odpowiedzi nie są ustawione parametry remaining_waypoints. Jeśli to pole nie jest określone, pole remaining_waypoints jest zawsze pobierane.

route_format_type

PolylineFormatType

Zwracany bieżący format trasy: LAT_LNG_LIST_TYPE (w Trip.route) lub ENCODED_POLYLINE_TYPE (w Trip.current_route_segment). Wartość domyślna to LAT_LNG_LIST_TYPE.

current_route_segment_traffic_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniają się od tej sygnatury czasowej, pole current_route_segment_traffic nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane dotyczące ruchu są zawsze pobierane. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usług przejazdów na żądanie i usług dostawy.

remaining_waypoints_route_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane z kategorii Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli dane nie zmieniają się od tej sygnatury czasowej, powyższe pola nie są ustawione w odpowiedzi. Jeśli pole remaining_waypoints_route_version nie jest określone, ruch i ścieżka są zawsze pobierane.

GetVehicleRequest

Wiadomość z prośbą: GetVehicle.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

current_route_segment_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik Vehicle.current_route_segment. Jeśli trasa nie uległa zmianie od tej sygnatury czasowej, pole current_route_segment nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, wartość current_route_segment jest zawsze pobierana.

waypoints_version

Timestamp

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane funkcji Vehicle.waypoints. Jeśli punkty pośrednie nie zmieniają się od tej sygnatury czasowej, dane vehicle.waypoints nie są ustawione w odpowiedzi. Jeśli to pole nie jest określone, pole vehicle.waypoints jest zawsze pobierane.

LicensePlate

Informacje o tablicach rejestracyjnych Pojazdu. Aby uniknąć przechowywania informacji umożliwiających identyfikację osób, w ramach danego podmiotu przechowywana jest tylko minimalna ilość informacji na temat tablicy rejestracyjnej.

Pola
country_code

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 tablicy rejestracyjnej lub „-1” oznacza brak wartości liczbowej na tablicy rejestracyjnej.

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

ListVehiclesRequest

Wiadomość z prośbą: ListVehicles.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

page_size

int32

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

page_token

string

Wartość pola next_page_token podana w poprzednim wywołaniu funkcji ListVehicles, która umożliwia podział na strony w grupach pojazdów. Wartość jest nieokreślona, jeśli kryteria filtrowania w żądaniu nie są takie same jak kryteria filtrowania poprzedniego wywołania funkcji ListVehicles.

minimum_capacity

Int32Value

Określa wymaganą minimalną pojemność pojazdu. W przypadku wszystkich zwróconych pojazdów wartość maximum_capacity będzie większa lub równa tej wartości. Jeśli jest ustawiona, musi być równa 0 lub większa.

trip_types[]

TripType

Ogranicza odpowiedź do pojazdów, które obsługują co najmniej jeden z podanych typów podróży.

maximum_staleness

Duration

Ogranicza odpowiedź do pojazdów, które w określonym czasie wysłały aktualizacje lokalizacji do Fleet Engine. Stacjonarne pojazdy, które nadal przesyłają swoje lokalizacje, nie są uznawane za nieaktualne. Jeśli występuje, musi mieć prawidłową wartość dodatnią.

vehicle_type_categories[]

Category

Wymagane. Ogranicza odpowiedź do pojazdów z jedną z określonych kategorii typów. UNKNOWN – to jest niedozwolone.

required_attributes[]

string

Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól required_attributes, required_one_of_attributes i required_one_of_attribute_sets.

required_attributes jest listą; required_one_of_attributes używa wiadomości, która zezwala na listę list. Te 2 pola umożliwiają kompozycję 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 spójnikiem/operacją ORAZ. Maksymalna dozwolona liczba atrybutów wymaganych to 50. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe. Każdy powtarzany ciąg znaków powinien mieć format „klucz:wartość”.

required_one_of_attributes[]

string

Ogranicza odpowiedź do pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym elemencie VehicleAttributeList. Pojazd musi pasować do co najmniej jednego atrybutu na każdej liście. To pole zawiera operator rozdzielający/LUB w każdym elemencie VehicleAttributeList oraz operacja spójności/ORAZ w zbiorze funkcji VehicleAttributeList. Każdy powtórzony ciąg powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets udostępnia dodatkowe funkcje.

Podobnie jak w zasadzie required_one_of_attributes, required_one_of_attribute_sets używa komunikatu, który umożliwia listę list, umożliwiając użycie takich wyrażeń:

(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 pasujących do wszystkich atrybutów w atrybucie VehicleAttributeList. Pojazd musi spełniać warunki wszystkich atrybutów na każdej liście. To pole stanowi operację spójności/I w każdym elemencie VehicleAttributeList oraz operacji obejmującej funkcję rozdzielenia/LUB w zbiorze VehicleAttributeList. Każdy powtórzony ciąg powinien mieć format „klucz1:wartość1|klucz2:wartość2|klucz3:wartość3”.

vehicle_state

VehicleState

Ogranicza odpowiedź do pojazdów w tym stanie.

on_trip_only

bool

Zwracaj tylko te pojazdy, które są obecnie dostępne.

filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyświetlaniu listy pojazdów. Przykłady składni filtrów znajdziesz na stronie http://aip.dev/160.

To pole zastępuje pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podasz tu wartość, która nie jest pusta, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak vehicle_state lub on_trip_only.

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

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

viewport

Viewport

Opcjonalnie: Filtr ograniczający liczbę pojazdów zwracanych do tych, których ostatnia znana lokalizacja znajdowała się w prostokątnym obszarze zdefiniowanym w widocznym obszarze.

ListVehiclesResponse

ListVehicles odpowiedź.

Pola
vehicles[]

Vehicle

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

next_page_token

string

Token umożliwiający pobranie następnej strony pojazdów lub pusty, jeśli nie ma więcej pojazdów spełniających kryteria żądania.

total_size

int64

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

LocationPowerSaveMode

Jak są skonfigurowane funkcje lokalizacji do działania na urządzeniu mobilnym po włączeniu trybu „Oszczędzanie baterii” jest włączona. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Wartości w polu enum
UNKNOWN_LOCATION_POWER_SAVE_MODE Niezdefiniowany tryb oszczędzania lokalizacji
LOCATION_MODE_NO_CHANGE Oszczędzanie baterii nie powinno mieć wpływu na dostawców usług lokalizacyjnych lub w przypadku tej funkcji jest ona wyłączona.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Dostawca lokalizacji wykorzystujący GPS powinien być wyłączony, gdy jest włączone oszczędzanie baterii, a urządzenie nie jest interaktywne.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Wyłącz wszystkich dostawców usług lokalizacji, gdy urządzenie nie jest interaktywne, a tryb oszczędzania baterii jest włączony.
LOCATION_MODE_FOREGROUND_ONLY Wszyscy dostawcy lokalizacji będą dostępni, ale poprawki lokalizacji należy udostępniać tylko w przypadku aplikacji działających na pierwszym planie.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokalizacja nie zostanie wyłączona, ale LocationManager będzie ograniczać wszystkie żądania do dostawców, gdy urządzenie nie będzie interaktywne.

LocationSensor

Czujnik lub metodologia używana do określenia lokalizacji.

Wartości w polu enum
UNKNOWN_SENSOR Czujnik jest nieokreślony lub nieznany.
GPS GPS lub Wspomagany GPS.
NETWORK Wspomagany GPS, identyfikator stacji bazowej sieci komórkowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej sieci komórkowej lub punkt dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobna lokalizacja drogi.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji podanej ze źródeł innych niż urządzenie mobilne z pakietem Driver SDK. Jeśli oryginalne źródło jest opisane za pomocą jednej z pozostałych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle udostępniane przez last_location.supplemental_location_sensor pojazdu.
FLEET_ENGINE_LOCATION Lokalizacja obliczana przez Fleet Engine na podstawie dostępnych dla niej sygnałów. Tylko dane wyjściowe. Ta wartość zostanie odrzucona, jeśli otrzyma ją w żądaniu.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji na Androidzie.
CORE_LOCATION Dostawca lokalizacji w systemach operacyjnych Apple.

Stan nawigacji pojazdu.

Wartości w polu enum
UNKNOWN_NAVIGATION_STATUS Nieokreślony stan nawigacji.
NO_GUIDANCE Nawigacja w aplikacji Kierowca jest w trybie FREE_NAV.
ENROUTE_TO_DESTINATION Dostępna jest szczegółowa nawigacja, a nawigacja w aplikacji Kierowca została przełączona w tryb GUIDED_NAV.
OFF_ROUTE Pojazd zjechał z sugerowanej trasy.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.

PolylineFormatType

Typ formatu linii łamanej.

Wartości w polu enum
UNKNOWN_FORMAT_TYPE Format jest nieokreślony lub nieznany.
LAT_LNG_LIST_TYPE Lista: google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia łamana zakodowana za pomocą algorytmu kompresji linii łamanej. Dekodowanie nie jest jeszcze obsługiwane.

PowerSource

Typ ładowarki używanej do ładowania baterii.

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

ReportBillableTripRequest

Wiadomość z żądaniem ReportBillableTrip.

Pola
name

string

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

country_code

string

Wymagane. Dwuliterowy kod kraju, w którym odbywa się podróż. Cena jest określona na podstawie kodu kraju.

platform

BillingPlatformIdentifier

Platforma, na której przesłano żądanie.

related_ids[]

string

Identyfikatory, które są bezpośrednio związane ze zgłaszaną podróżą. Są to zwykle identyfikatory (np. identyfikatory sesji) operacji wstępnej rezerwacji wykonanych przed udostępnieniem identyfikatora podróży. Liczba related_ids jest ograniczona do 50.

solution_type

SolutionType

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

SolutionType

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

Wartości w polu enum
SOLUTION_TYPE_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie używać atrybutu ON_DEMAND_RIDESHARING_AND_DELIVERIES, który jest pierwszym obsługiwanym typem rozwiązania.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Rozwiązaniem jest funkcja wspólnych przejazdów i podróży z dostawą dostępna na żądanie.

RequestHeader

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

Pola
language_code

string

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

region_code

string

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

sdk_version

string

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

os_version

string

Wersja systemu operacyjnego, w którym działa pakiet SDK wywołujący. Przykłady wartości pól: 4.4.1, 12.1.

device_model

string

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

sdk_type

SdkType

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

maps_sdk_version

string

Wersja pakietu SDK MapSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. 5.2.1.

nav_sdk_version

string

Wersja pakietu NavSDK, od której zależy wywoływany pakiet SDK (w stosownych przypadkach). Format wersji to „major.minor.patch”, np. 2.1.0.

platform

Platform

Platforma pakietu SDK wywołującego.

manufacturer

string

Producent urządzenia z Androidem z pakietu SDK wywołującego. Dotyczy tylko pakietów Android SDK. Przykład wartości pola: Samsung.

android_api_level

int32

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

trace_id

string

Opcjonalny identyfikator, który można podać do celów logowania i zidentyfikować żądanie.

Platforma

Platforma wywołującego pakietu SDK.

Wartości w polu enum
PLATFORM_UNSPECIFIED Wartość domyślna. Ta wartość jest używana w przypadku pominięcia platformy.
ANDROID Prośba pochodzi z Androida.
IOS Prośba pochodzi z iOS.
WEB Żądanie pochodzi z internetu.

SdkType

Możliwe typy pakietu SDK.

Wartości w polu enum
SDK_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość jest używana, jeśli pominiesz właściwość sdk_type.
CONSUMER Pakiet SDK wywołujący to wersja konsumenta.
DRIVER Wywołujący pakiet SDK to sterownik.
JAVASCRIPT Wywoływanie SDK to JavaScript.

SearchTripsRequest

Komunikat żądania SearchTrips.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

vehicle_id

string

Pojazd związany z podróżami, których dotyczy prośba. Jeśli te informacje nie są określone, zwrócone podróże nie zawierają:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Jeśli ma wartość Prawda, odpowiedź będzie obejmować Podróże, które mają wpływ na trasę kierowcy.

page_size

int32

Jeśli jej nie skonfigurujesz, serwer decyduje o liczbie wyników do zwrócenia.

page_token

string

Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwrócona w polu SearchTripsResponse.

minimum_staleness

Duration

Jeśli został podany, zwraca podróże, które nie zostały zaktualizowane po czasie (current - minimum_staleness).

SearchTripsResponse

Komunikat odpowiedzi SearchTrips.

Pola
trips[]

Trip

Lista przejazdów żądanym pojazdem.

next_page_token

string

Przekaż ten token w SearchTripsRequest, aby przeglądać wyniki z listy. Interfejs API zwraca listę przejazdów przy każdym wywołaniu, a gdy nie ma już żadnych wyników, lista przejazdów jest pusta.

SearchVehiclesRequest

Wiadomość z prośbą: SearchVehicles.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

parent

string

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

pickup_point

TerminalLocation

Wymagane. Punkt odbioru w pobliżu.

dropoff_point

TerminalLocation

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

pickup_radius_meters

int32

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

count

int32

Wymagane. Określa maksymalną liczbę pojazdów do zwrotu. Wartość musi znajdować się w zakresie od 1 do 50 (włącznie).

minimum_capacity

int32

Wymagane. Określa liczbę pasażerów uwzględnianych w podróży. Wartość nie może być mniejsza niż 1. Kierowca nie jest uwzględniany w wartości pojemności.

trip_types[]

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 w określonym czasie wysłały aktualizacje lokalizacji do Fleet Engine. Stacjonarne pojazdy, które nadal przesyłają swoje lokalizacje, nie są uznawane za nieaktualne. Jeśli to pole nie jest skonfigurowane, serwer ustawia domyślną wartość z pięciu minut.

vehicle_types[]

VehicleType

Wymagane. Ogranicza wyszukiwanie do pojazdów jednego z określonych typów. Należy określić co najmniej jeden typ pojazdu. Typy pojazdów o kategorii UNKNOWN są niedozwolone.

required_attributes[]

VehicleAttribute

Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól required_attributes, required_one_of_attributes i required_one_of_attribute_sets.

required_attributes jest listą; required_one_of_attributes używa wiadomości, która zezwala na listę list. Te 2 pola umożliwiają kompozycję 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 wyszukiwanie do pojazdów o określonych atrybutach. To pole jest spójnikiem/operacją ORAZ. Maksymalna dozwolona liczba atrybutów wymaganych to 50. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe.

required_one_of_attributes[]

VehicleAttributeList

Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym VehicleAttributeList. Pojazd musi pasować do co najmniej jednego atrybutu na każdej liście. To pole zawiera operator rozdzielający/LUB w każdym elemencie VehicleAttributeList oraz operacja spójności/ORAZ w zbiorze funkcji VehicleAttributeList.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets udostępnia dodatkowe funkcje.

Podobnie jak w zasadzie required_one_of_attributes, required_one_of_attribute_sets używa komunikatu, który umożliwia listę list, umożliwiając użycie takich wyrażeń:

(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 pojazdów mających wszystkie atrybuty w atrybucie VehicleAttributeList. Pojazd musi spełniać warunki wszystkich atrybutów na każdej liście. To pole stanowi operację spójności/I w każdym elemencie VehicleAttributeList oraz operacji obejmującej funkcję rozdzielenia/LUB w zbiorze VehicleAttributeList.

order_by

VehicleMatchOrder

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

include_back_to_back

bool

Wskazuje, czy do tego wyszukiwania kwalifikują się pojazdy z pojedynczą aktywną podróżą. To pole jest używane tylko wtedy, gdy pole current_trips_present nie jest określone. Jeśli pole current_trips_present nie jest określone, a to pole ma wartość false, pojazdy z przypisanymi podróżami są wykluczane z wyników wyszukiwania. Jeśli pole current_trips_present nie jest określone, a to pole ma wartość true, wyniki wyszukiwania mogą obejmować pojazdy z 1 aktywną podróżą o stanie ENROUTE_TO_DROPOFF. Jeśli jest określona wartość current_trips_present, w tym polu nie można ustawić wartości prawda.

Wartością domyślną jest false.

trip_id

string

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

current_trips_present

CurrentTripsPresent

Wskazuje, czy do tego wyszukiwania kwalifikują się pojazdy, które aktywnie podróżują. Jeśli parametr trip_type zawiera parametr SHARED, wartość tego pola musi być inna niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.

filter

string

Opcjonalnie: Zapytanie filtra, które ma być stosowane przy wyszukiwaniu pojazdów. Przykłady składni filtrów znajdziesz na stronie http://aip.dev/160.

To pole zastępuje pola required_attributes, required_one_of_attributes i required_one_of_attributes_sets. Jeśli podasz tu wartość, która nie jest pusta, te pola muszą być puste: required_attributes, required_one_of_attributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak minimum_capacity lub vehicle_types.

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

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

CurrentTripsPresent

Określa rodzaje ograniczeń dotyczących bieżącej trasy pojazdu.

Wartości w polu enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Dostępność pojazdów z możliwością podróży jest określana w polu include_back_to_back.
NONE Pojazdy, które nie będą przejazdami, mogą pojawiać się w wynikach wyszukiwania. W przypadku użycia tej wartości dyrektywa include_back_to_back nie może być ustawiona jako true.
ANY W wynikach wyszukiwania uwzględniane są pojazdy, z którymi aktualnie pokonuje się maks. 5 tras i 10 punktów pośrednich. W przypadku użycia tej wartości dyrektywa include_back_to_back nie może być ustawiona jako true.

VehicleMatchOrder

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

Wartości w polu enum
UNKNOWN_VEHICLE_MATCH_ORDER Domyślnie używana w przypadku nieokreślonego lub nierozpoznanego dopasowania pojazdu.
PICKUP_POINT_ETA Rosnąco według czasu przejazdu pojazdu do punktu odbioru.
PICKUP_POINT_DISTANCE Rosnąco według odległości pojazdu do punktu odbioru.
DROPOFF_POINT_ETA Kolejność rosnąca według czasu przejazdu pojazdu do punktu nadania. Tego zamówienia można użyć tylko wtedy, gdy punkt zwrotu jest określony w żądaniu.
PICKUP_POINT_STRAIGHT_DISTANCE Kolejność rosnąca według bezpośredniej odległości od ostatniej zgłoszonej lokalizacji pojazdu do punktu odbioru.
COST Kolejność rosnąca według skonfigurowanego kosztu dopasowania. Koszt dopasowania to obliczenie ważone między długością linii prostej a szacowanym czasem dotarcia na miejsce. Wagi są ustawiane na wartości domyślne i można je modyfikować dla poszczególnych klientów. Jeśli musisz zmodyfikować te wagi na potrzeby projektu, skontaktuj się z zespołem pomocy Google.

SearchVehiclesResponse

SearchVehicles odpowiedź.

Pola
matches[]

VehicleMatch

Lista pojazdów spełniających kryteria SearchVehiclesRequest, uporządkowanych według pola SearchVehiclesRequest.order_by.

SpeedReadingInterval

Wskaźnik natężenia ruchu na sąsiadującym odcinku ścieżki. Biorąc pod uwagę ścieżkę z punktami P_0, P_1, ... , P_N (indeks liczony od zera), SpeedReadingInterval definiuje interwał i opisuje ruch przy użyciu następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego interwału w ścieżce. Jeśli indeks w pliku JSON wynosi 0, pole będzie puste.

end_polyline_point_index

int32

Indeks końcowy tego przedziału w ścieżce. Jeśli indeks w pliku JSON wynosi 0, pole będzie puste.

speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja prędkości linii łamanej na podstawie danych o natężeniu ruchu.

Wartości w polu enum
SPEED_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NORMAL Normalna prędkość, nie wykryto spowolnienia.
SLOW Wykryto korek, ale nie było żadnych korków.
TRAFFIC_JAM Wykryto korek.

StopLocation

Rzeczywista lokalizacja, w której miała miejsce przystanek (odbiór/zwrot).

Pola
point

LatLng

Wymagane. Wskazuje rzeczywistą lokalizację.

timestamp

Timestamp

Wskazuje, kiedy doszło do postoju.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Opisuje lokalizację punktu pośredniego.

Pola
point

LatLng

Wymagane. Wskazuje lokalizację punktu pośredniego podróży.

terminal_point_id
(deprecated)

TerminalPointId

Wycofano: zamiast tego podaj pole point.

access_point_id
(deprecated)

string

Wycofano: zamiast tego podaj pole point.

trip_id
(deprecated)

string

Rola wycofana.

terminal_location_type
(deprecated)

WaypointType

Wycofano: te dane będą dostępne dla: Vehicle.waypoint.

TerminalPointId

Wycofano: Fleet Engine nie obsługuje już punktów TerminalPoint. Użyj w zamian zasady TerminalLocation.point.

Pola
value
(deprecated)

string

Rola wycofana.

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

string

Rola wycofana.

generated_id
(deprecated)

string

Rola wycofana.

TrafficPolylineData

Warunki na drodze do oczekiwanej trasy pojazdu.

Pola
traffic_rendering

VisualTrafficReportPolylineRendering

Renderowanie łamane pokazujące prędkość ruchu we wszystkich regionach na jednym odcinku przejazdu klienta.

Podróż

Metadane podróży.

Pola
name

string

Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}”

vehicle_id

string

Identyfikator pojazdu, który pokonuje tę 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 zostanie odebrany.

actual_pickup_point

StopLocation

Tylko dane wejściowe. Rzeczywista lokalizacja i miejsce odbioru klienta. To pole jest przeznaczone dla usługodawcy do przekazywania opinii na temat rzeczywistych informacji o odbiorze.

actual_pickup_arrival_point

StopLocation

Tylko dane wejściowe. Rzeczywista godzina przyjazdu kierowcy do punktu odbioru i lokalizacja kierowcy. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.

pickup_time

Timestamp

Tylko dane wyjściowe. Szacowana godzina przyjazdu pasażerów lub faktyczna godzina ich odebrania w przyszłości.

intermediate_destinations[]

TerminalLocation

Pośrednie przystanki na potrzeby podróży (oprócz prośby o odbiór i powrót). Początkowo nie będzie to obsługiwane w przypadku wspólnych podróży.

intermediate_destinations_version

Timestamp

Wskazuje, kiedy po raz ostatni zmodyfikowano intermediate_destinations. Aby zapewnić, że intermediate_destinations nie została zmieniona, serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w UpdateTripRequest po aktualizacji intermediate_destination_index.

intermediate_destination_index

int32

Jeśli TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazuje pośredni miejsce docelowe, przez które pojazd będzie następny. Jeśli TripStatus to ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca pośrednie miejsce docelowe, na którym znajduje się pojazd. Dostawca ustawia tę wartość. W przypadku braku wartości intermediate_destinations to pole jest ignorowane.

actual_intermediate_destination_arrival_points[]

StopLocation

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja dotarcia kierowcy do pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do miejsc pośrednich.

actual_intermediate_destinations[]

StopLocation

Tylko dane wejściowe. Rzeczywisty czas i miejsce odbioru klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania informacji o rzeczywistych informacjach o odbiorze w miejscach docelowych pośrednich.

dropoff_point

TerminalLocation

Lokalizacja, w której klient wskazuje, że zostanie odesłany.

actual_dropoff_point

StopLocation

Tylko dane wejściowe. Rzeczywiste miejsce i godzinę odejścia klienta. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o rezygnacji.

dropoff_time

Timestamp

Tylko dane wyjściowe. Szacowana godzina, o której pasażerowie wysiądą w przyszłości, albo godzina, o której pasażerowie wysiądzie.

remaining_waypoints[]

TripWaypoint

Tylko dane wyjściowe. Pełna ścieżka z bieżącej lokalizacji do punktu zwrotu (włącznie). Ta ścieżka może obejmować punkty na trasie innych podróży.

vehicle_waypoints[]

TripWaypoint

To pole umożliwia ręczne porządkowanie punktów na trasie dla podróży. Zawiera wszystkie pozostałe punkty na trasie dla przypisanego pojazdu, a także punkty odbioru i zakończenia podróży dla tej podróży. Jeśli podróż nie została przypisana do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane przez serwer tylko w przypadku wywołań UpdateTrip i CreateTrip, a NIE w przypadku wywołań GetTrip.

route[]

LatLng

Tylko dane wyjściowe. Przewidywana trasa do pierwszego wejścia w pozostałe punkty pośrednie. Pamiętaj, że pierwszy punkt pośredni może należeć do innej podróży.

current_route_segment

string

Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu pośredniego.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

current_route_segment_version

Timestamp

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

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

current_route_segment_traffic

ConsumableTrafficPolyline

Tylko dane wyjściowe. Wskazuje natężenie ruchu na drodze current_route_segment, jeśli są dostępne.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

current_route_segment_traffic_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy po raz ostatni zmodyfikowano current_route_segment_traffic.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

Tylko dane wyjściowe. Pozostała odległość samochodem podana w polu current_route_segment. Wartość nie jest określona, jeśli podróż nie jest przypisana do pojazdu albo została zakończona lub anulowana.

eta_to_first_waypoint

Timestamp

Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu remaining_waypoints). Wartość jest nieokreślona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

remaining_time_to_first_waypoint

Duration

Tylko dane wyjściowe. Czas od zwrócenia danych o podróży do momentu w polu Trip.eta_to_first_waypoint. Wartość jest nieokreślona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

remaining_waypoints_version

Timestamp

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono element remaining_waypoints (dodano, usunięto lub zmieniono punkt pośredni).

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 kliencka powinna być w pamięci podręcznej i przekazywać ją w narzędziu GetTripRequest, aby ścieżki i ruch związane z parametrem remaining_waypoints były zwracane tylko po zaktualizowaniu.

number_of_passengers

int32

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

last_location

VehicleLocation

Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie.

last_location_snappable

bool

Tylko dane wyjściowe. Wskazuje, czy atrybut last_location pojazdu można przyciągnąć do bieżącego_segmentu_trasy. Fałsz, jeśli atrybut last_location lub current_route_segment nie istnieje. Obliczane przez Fleet Engine. Wszelkie aktualizacje od klientów zostaną zignorowane.

view

TripView

Podzbiór pól Podróże, które zostały wypełnione i sposób ich interpretacji.

TripStatus

Stan podróży wskazujący jej postęp.

Wartości w polu enum
UNKNOWN_TRIP_STATUS Domyślna używana w przypadku nieokreślonego lub nierozpoznanego stanu podróży.
NEW Nowo utworzona podróż.
ENROUTE_TO_PICKUP Kierowca jest w drodze do punktu odbioru.
ARRIVED_AT_PICKUP Kierowca dotarł do punktu odbioru.
ARRIVED_AT_INTERMEDIATE_DESTINATION Kierowca dotarł do pośredniego miejsca docelowego i czeka na pasażera.
ENROUTE_TO_INTERMEDIATE_DESTINATION Kierowca jest w drodze do pośredniego miejsca docelowego (nie do punktu nadania).
ENROUTE_TO_DROPOFF Kierowca zabierze pasażera i jest w drodze do następnego miejsca docelowego.
COMPLETE Pasażer wysiądzie i podróż się zakończyła.
CANCELED Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub dostawcę wspólnych przejazdów.

TripType

Typ podróży.

Wartości w polu enum
UNKNOWN_TRIP_TYPE Domyślna używana w przypadku nieokreślonych lub nierozpoznanych typów podróży.
SHARED W ramach tej podróży pojazdem może podróżować inne osoby.
EXCLUSIVE Przejażdżka jest dostępna wyłącznie dla pojazdu.

TripView

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

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API domyślnie użyje widoku pakietu SDK. Aby zapewnić stabilność i wsparcie, klienci powinni wybrać TripView inne niż SDK.
SDK Obejmuje pola, których interpretacja lub działanie może być niemożliwe przy użyciu publicznie dostępnych bibliotek.
JOURNEY_SHARING_V1S Pola dotyczące podróży są wypełniane w przypadku zastosowania funkcji udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

TripWaypoint

Opisuje punkt postoju na trasie pojazdu lub punkt końcowy na trasie przejazdu.

Pola
location

TerminalLocation

Lokalizacja tego punktu na trasie.

trip_id

string

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

waypoint_type

WaypointType

Rola, jaką ten punkt pośredni odgrywa w danej podróży, np. w przypadku odbioru lub zwrotu.

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

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

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

traffic_to_waypoint

ConsumableTrafficPolyline

Informacje o natężeniu ruchu na trasie do tego punktu pośredniego. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usługi przejazdy i dostawy w ramach Google Map Platform.

distance_meters

Int32Value

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

eta

Timestamp

Szacowany czas dotarcia do tego punktu na trasie. Nieokreślony dla pierwszego punktu na liście.

duration

Duration

Czas podróży od poprzedniego punktu pośredniego do tego punktu. Nieokreślony dla pierwszego punktu na liście.

UpdateTripRequest

Wiadomość z prośbą UpdateTrip.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

trip

Trip

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

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

Kiedy aktualizujesz Trip.vehicle_id dla udostępnionej podróży, musisz podać listę Trip.vehicle_waypoints, aby określić kolejność pozostałych punktów na trasie, w przeciwnym razie kolejność nie będzie ustalona.

Jeśli podasz Trip.vehicle_waypoints, lista musi zawierać wszystkie pozostałe punkty na trasie podróży pojazdu, bez dodatkowych punktów pośrednich. Punkty pośrednie musisz zamówić w taki sposób, aby w przypadku danej podróży punkt odbioru znajdował się przed miejscem docelowym pośrednim, a wszystkie miejsca docelowe pośrednie znajdowały się przed punktem nadania. Punkty na trasie EXCLUSIVE nie mogą przeplatać się z żadnymi innymi podróżami. Pola trip_id, waypoint_type i location są używane, a pozostałe pola TripWaypoint w polu vehicle_waypoints są ignorowane.

Aby uniknąć warunku wyścigu w przypadku podróży obejmujących wiele miejsc docelowych, podczas aktualizowania stanu podróży na ENROUTE_TO_INTERMEDIATE_DESTINATION podaj atrybut Trip.intermediate_destinations_version. Przekazana wartość Trip.intermediate_destinations_version musi być zgodna z wersją Fleet Engine. W przeciwnym razie żądanie nie zostanie zrealizowane.

update_mask

FieldMask

Wymagane. Maska pola wskazująca, które pola w Podróży mają zostać zaktualizowane. update_mask musi zawierać co najmniej 1 pole.

UpdateVehicleAttributesRequest

Wiadomość z prośbą: UpdateVehicleAttributes.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

attributes[]

VehicleAttribute

Wymagane. Atrybuty pojazdu do zaktualizowania. Atrybuty, które nie są wymienione, nie są zmieniane ani usuwane.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes odpowiedź.

Pola
attributes[]

VehicleAttribute

Wymagane. Zaktualizowana pełna lista atrybutów pojazdów, w tym nowych, zmienionych i niezmienionych atrybutów.

UpdateVehicleRequest

„Zaktualizuj wiadomość z prośbą o pojazd.

Pola
header

RequestHeader

Standardowy nagłówek żądania Fleet Engine.

name

string

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

vehicle

Vehicle

Wymagane. Wartości elementu Vehicle do zastosowania. Podczas aktualizowania elementu Vehicle poniższe 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 prośbie. Jeśli chcesz zaktualizować tylko niektóre atrybuty, zapoznaj się z metodą UpdateVehicleAttributes.

Pole waypoints również można zaktualizować, ale musi zawierać wszystkie punkty pośrednie znajdujące się obecnie w pojeździe i nie może zawierać żadnych innych punktów.

update_mask

FieldMask

Wymagane. Maska pola wskazująca, które pola obiektu Vehicle mają zostać zaktualizowane. Musisz podać co najmniej 1 nazwę pola.

Pojazd

Metadane pojazdu.

Pola
name

string

Tylko dane wyjściowe. Niepowtarzalna 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 na potrzeby podróży aktualnie przypisanych do tego pojazdu.

last_location

VehicleLocation

Ostatnio zgłoszona lokalizacja pojazdu.

maximum_capacity

int32

Łączna liczba osób, które może przewieźć ten pojazd. Kierowca nie jest uwzględniany w tej wartości. Ta wartość nie może być mniejsza niż 1.

attributes[]

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 tego pojazdu. Może służyć do filtrowania pojazdów w wynikach wyszukiwania w usłudze SearchVehicles. Wpływa też na szacowany czas dotarcia na miejsce i obliczanie trasy.

license_plate

LicensePlate

Informacje o tablicach rejestracyjnych pojazdu.

route[]
(deprecated)

TerminalLocation

Wycofane: użyj atrybutu Vehicle.waypoints.

current_route_segment

string

Linia łamana określająca trasę, którą aplikacja kierowcy zamierza podążać do następnego punktu pośredniego. Ta lista jest też zwracana w języku Trip.current_route_segment w przypadku wszystkich aktywnych podróży przypisanych do pojazdu.

Uwaga: to pole jest przeznaczone tylko do użytku 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 do ulepszania udostępniania przejazdów. Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK.

current_route_segment_version

Timestamp

Tylko dane wyjściowe. Czas ustawienia parametru current_route_segment. Może być przechowywany przez klienta i przekazywana w przyszłych żądaniach GetVehicle, aby zapobiec zwrotowi tras, które nie uległy zmianie.

current_route_segment_end_point

TripWaypoint

Punkt na trasie, w którym kończy się current_route_segment. Mogą je przekazać kierowcy podczas połączeń UpdateVehicle jako punkt na trasie obejmującej całą podróż, jako punkt pośredni LatLng lub jako ostatni element LatLng pojazdu current_route_segment. Jeśli nie zostanie w pełni określony, Fleet Engine podejmie wtedy wszelkie możliwe działania, aby interpolować do rzeczywistego punktu pośredniego. To pole jest ignorowane w wywołaniach UpdateVehicle, chyba że określono też pole current_route_segment.

remaining_distance_meters

Int32Value

Pozostały dystans jazdy samochodem przez current_route_segment. Ta wartość jest też zwracana w polu Trip.remaining_distance_meters w przypadku wszystkich aktywnych podróży przypisanych do pojazdu. Wartość jest nieokreślona, jeśli pole current_route_segment jest puste.

eta_to_first_waypoint

Timestamp

Szacowany czas dotarcia na miejsce do pierwszego wpisu w polu waypoints. Wartość jest nieokreślona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste.

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

remaining_time_seconds

Int32Value

Tylko dane wejściowe. Pozostały czas jazdy samochodem current_route_segment. Wartość jest nieokreślona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste. Ta wartość powinna pasować do zakresu od eta_to_first_waypoint do current_time, jeśli wszystkie strony używają tego samego zegara.

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

waypoints[]

TripWaypoint

Pozostałe punkty na trasie przypisane do tego pojazdu.

waypoints_version

Timestamp

Tylko dane wyjściowe. Data ostatniej aktualizacji pola waypoints. Klienty powinny buforować tę wartość i przekazywać ją w narzędziu GetVehicleRequest, aby mieć pewność, że pole waypoints będzie zwracane tylko wtedy, gdy zostanie zaktualizowane.

back_to_back_enabled

bool

Wskazuje, czy kierowca akceptuje połączenia w obie strony. Jeśli zasada true, SearchVehicles może uwzględniać pojazd, nawet jeśli jest 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 typów pojazdów

Wartości w polu enum
UNKNOWN Domyślnie używana w przypadku nieokreślonych lub nierozpoznanych kategorii pojazdów.
AUTO Samochód.
TAXI Wszelkie pojazdy służące jako taksówka (zwykle licencjonowane lub objęte regulacjami).
TRUCK Zazwyczaj są to samochody o dużej pojemności pamięci masowej.
TWO_WHEELER Motocykl, motorower lub inny pojazd dwukołowy
BICYCLE Transport napędzany przez człowieka.
PEDESTRIAN Osobisty środek transportu, zwykle pieszo lub biegnący po ścieżkach.

VehicleAttribute

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

Pola
key

string

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

value

string

Wartość atrybutu.

Pole sumy vehicle_attribute_value. Wartość atrybutu może być ciągiem znaków, wartością logiczną lub liczbą zmiennoprzecinkową. vehicle_attribute_value może mieć tylko jedną z tych wartości:
string_value

string

Wartość atrybutu z ciągiem znaków.

Uwaga: działa tak samo jak pole value, które z czasem zostanie wycofane. Do tworzenia i aktualizacji danych możesz użyć dowolnego z tych pól, ale zdecydowanie zalecamy użycie string_value. Jeśli ustawione są zarówno wartości string_value, jak i value, muszą one być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

bool_value

bool

Wartość atrybutu wpisanego z użyciem wartości logicznej.

number_value

double

Wartość atrybutu została wpisana dwukrotnie.

VehicleAttributeList

Typ danych listy list dla atrybutów pojazdów.

Pola
attributes[]

VehicleAttribute

Lista atrybutów w tej kolekcji.

VehicleLocation

lokalizacja, prędkość i kierunek pojazdu w określonym czasie;

Pola
location

LatLng

Lokalizacja pojazdu. Gdy jest on wysyłany do Fleet Engine, lokalizacją pojazdu jest lokalizacja GPS. Po otrzymaniu odpowiedzi możesz określić lokalizację pojazdu na podstawie GPS-u, dodatkową lokalizację lub inną orientacyjną lokalizację. Źródło jest określone w polu location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu latlng_accuracy.

latlng_accuracy

DoubleValue

Dokładność promienia location w metrach.

heading

Int32Value

Kierunek, w którym pojazd porusza się w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).

bearing_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu heading_accuracy.

heading_accuracy

DoubleValue

Dokładność: heading w stopniach.

altitude

DoubleValue

Wysokość w metrach nad WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Wycofane: użyj atrybutu altitude_accuracy.

altitude_accuracy

DoubleValue

Dokładność: altitude w metrach.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Prędkość pojazdu w metrach/s

speed_accuracy

DoubleValue

Dokładność speed w metrach/s.

update_time

Timestamp

Godzina, o której czujnik (location) został zgłoszony przez czujnik, zgodnie z jego zegarem.

server_time

Timestamp

Tylko dane wyjściowe. Czas otrzymania przez serwer informacji o lokalizacji.

location_sensor

LocationSensor

Dostawca danych o lokalizacji (np. GPS).

is_road_snapped

BoolValue

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

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

Tylko dane wejściowe. Czas (w sekundach) od momentu wysłania tej lokalizacji do serwera po raz pierwszy. Przy pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (na przykład po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do 0.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Nieprzetworzona lokalizacja pojazdu (nieprzetworzona przez narzędzie do wykrywania dróg).

raw_location_time

Timestamp

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

raw_location_sensor

LocationSensor

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

raw_location_accuracy

DoubleValue

Dokładność raw_location w postaci promienia w metrach.

supplemental_location

LatLng

Dodatkowa lokalizacja udostępniana przez aplikację integracyjną.

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 w postaci promienia w metrach.

road_snapped
(deprecated)

bool

Wycofane: użyj atrybutu is_road_snapped.

VehicleMatch

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

Pola
vehicle

Vehicle

Wymagane. Pojazd zgodny z żądaniem.

vehicle_pickup_eta

Timestamp

Szacowany czas dotarcia pojazdu na miejsce do punktu odbioru określonego w żądaniu. Pusta wartość oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce. Jeśli SearchVehiclesRequest.include_back_to_back to true, a ten pojazd jest powiązany z aktywną podróżą, vehicle_pickup_eta uwzględnia czas potrzebny na ukończenie bieżącej aktywnej podróży.

vehicle_pickup_distance_meters

Int32Value

Odległość od bieżącej lokalizacji pojazdu do punktu odbioru określonego w żądaniu, z uwzględnieniem wszelkich pośrednich punktów odbioru i zwrotu w przypadku dotychczasowych podróży. Na tę odległość składają się obliczona odległość dojazdu (trasa) oraz odległość w linii prostej między punktem końcowym nawigacji a żądanym punktem odbioru. (Odległość między punktem końcowym nawigacji a żądanym punktem odbioru jest zwykle niewielka). Pusta wartość oznacza błąd podczas obliczania odległości.

vehicle_pickup_straight_line_distance_meters

Int32Value

Wymagane. Długość linii prostej między pojazdem a punktem odbioru określonego w żądaniu.

vehicle_dropoff_eta

Timestamp

Szacowany czas dotarcia na miejsce z całego pojazdu do punktu postoju wskazanego w żądaniu. Szacowany czas dotarcia na miejsce obejmuje zatrzymanie w dowolnym punkcie pośrednim przed dropoff_point określonym w żądaniu. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu zostanie określony punkt zwrotu. Pusta wartość oznacza błąd podczas obliczania szacowanego czasu dotarcia na miejsce.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Odległość pojazdu (w metrach) od punktu odbioru do miejsca nadania określonego w żądaniu. Odległość jest ograniczona tylko do tych 2 punktów i nie obejmuje lokalizacji pojazdu ani innych punktów, które należy odwiedzić, zanim pojazd dotrze do punktu odbioru lub punktu nadania. Wartość zostanie wypełniona tylko wtedy, gdy w żądaniu określisz atrybut dropoff_point. Pusta wartość oznacza błąd w obliczeniu odległości od punktu odbioru do punktu odbioru określonego w żądaniu.

trip_type

TripType

Wymagane. Rodzaj podróży użyty w żądaniu, który został użyty do obliczenia szacowanego czasu dotarcia do punktu odbioru.

vehicle_trips_waypoints[]

Waypoint

Uporządkowana lista punktów na trasie używanych do obliczania szacowanego czasu dotarcia na miejsce. Lista zawiera lokalizację pojazdu, punkty odbioru aktywnych podróży i punkty odbioru podane w prośbie. Pusta lista oznacza błąd w obliczaniu szacowanego czasu dotarcia na miejsce.

vehicle_match_type

VehicleMatchType

Typ dopasowania pojazdu.

requested_ordered_by

VehicleMatchOrder

Zażądano kolejności sortowania zgodnych pojazdów.

ordered_by

VehicleMatchOrder

Rzeczywiste zamówienie użyte w przypadku tego pojazdu. Normalnie wartość będzie pasować do parametru „order_by” z żądania; jednak w pewnych okolicznościach, takich jak wewnętrzny błąd serwera, można użyć innej metody (takiej jak PICKUP_POINT_STRAIGHT_DISTANCE).

VehicleMatchType

Typ dopasowania pojazdu.

Wartości w polu enum
UNKNOWN Nieznany typ dopasowania pojazdu
EXCLUSIVE Pojazd nie ma obecnie przypisanej podróży i może dotrzeć do punktu odbioru.
BACK_TO_BACK Pojazd jest obecnie przypisany do podróży, ale po zakończeniu trwającej podróży może przejść do punktu odbioru. Przy obliczaniu szacowanego czasu dotarcia na miejsce i dystansu brana jest pod uwagę dotychczasowa podróż.
CARPOOL Pojazd ma wystarczającą pojemność do wspólnego przejazdu.
CARPOOL_BACK_TO_BACK Pojazd zakończy bieżącą, aktywną podróż, zanim dotrze do punktu odbioru. Przy obliczaniu szacowanego czasu dotarcia na miejsce i dystansu brana jest pod uwagę dotychczasowa podróż.

VehicleState

Stan elementu Vehicle.

Wartości w polu enum
UNKNOWN_VEHICLE_STATE Domyślna używana w przypadku nieokreślonych lub nierozpoznanych stanów pojazdu.
OFFLINE Pojazd nie przyjmuje nowych przejazdów. Uwaga: pojazd może nadal działać w tym stanie podczas przypisanej do niego podróży.
ONLINE Pojazd przyjmuje nowe podróże.

VisualTrafficReportPolylineRendering

Opisuje, jak klienci powinni kolorować jedną część linii łamanej na trasie.

Pola
road_stretch[]

RoadStretch

Opcjonalnie: Odcinki dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia nie nakładają się na siebie i nie muszą obejmować całej trasy.

Jeśli nie ma rozciągania drogi do stylu, klient powinien zastosować do trasy domyślną wartość.

RoadStretch

Jeden odcinek drogi do wyrenderowania.

Pola
style

Style

Wymagane. Styl, który ma zostać zastosowany.

offset_meters

int32

Wymagane. Styl powinien być stosowany między [offset_meters, offset_meters + length_meters).

length_meters

int32

Wymagane. Długość ścieżki, w której chcesz zastosować styl.

Styl

Styl ruchu wskazujący prędkość ruchu.

Wartości w polu enum
STYLE_UNSPECIFIED Nie wybrano stylu.
SLOWER_TRAFFIC Ruch jest zwalniany.
TRAFFIC_JAM Występuje korek.

Punkt pośredni

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

Pola
lat_lng

LatLng

Lokalizacja tego punktu na trasie.

eta

Timestamp

Szacowana godzina, o której pojazd dotrze do tego punktu pośredniego.

WaypointType

Typ punktu na trasie.

Wartości w polu enum
UNKNOWN_WAYPOINT_TYPE Nieznany lub nieokreślony typ punktu pośredniego.
PICKUP_WAYPOINT_TYPE Punkty pośrednie, za pomocą których można odebrać pasażerów lub przedmioty.
DROP_OFF_WAYPOINT_TYPE Punkty pośrednie, w których można wywieźć pasażerów lub przedmioty.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie w przypadku podróży z kilkoma miejscami docelowymi.