Package google.maps.routes.v1

Indeks

RoutesPreferred

Preferowany interfejs API tras.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Na podstawie zestawu punktów docelowych i punktów pośrednich oraz celu trasy oblicza najlepszą trasę dla tego celu. Zwraca również najszybszą i najkrótszą trasę jako trasy referencyjne.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maską pola odpowiedzi możesz podać, używając parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL. Wartość ma postać listy rozdzielonych przecinkami ścieżek pól. Zapoznaj się z szczegółową dokumentacją dotyczącą tworzenia ścieżek pól.

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do sprawdzenia ręcznego): X-Goog-FieldMask: *
  • Maska pola z odległościami i czasem trwania trasy oraz informacjami o tokenach i opłatach: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Nie zalecamy używania maski pola odpowiedzi z symbolem wieloznacznym (*) ani określania maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wynik z mniejszym opóźnieniem.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a to może wydłużyć czas obliczeń. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się zmniejszyć, ponieważ nowe pola, które dodamy, będą automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje mniejszy rozmiar odpowiedzi, a co za tym idzie, większą przepustowość sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Odbiera listę miejsc nadania i miejsc docelowych, a następnie zwraca strumień zawierający informacje o trasach dla każdej kombinacji miejsca nadania i miejsca docelowego.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maską pola odpowiedzi możesz podać, używając parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL. Wartość to lista ścieżek pól rozdzielonych przecinkami. Zapoznaj się ze szczegółową dokumentacją tworzenia ścieżek pól.

Na przykład w tej metodzie:

  • Maska pól wszystkich dostępnych pól (do ręcznej kontroli): X-Goog-FieldMask: *
  • Maska pola z czasami trwania trasy, odległościami, stanem elementu, stanem i indeksami elementów (przykładowa konfiguracja wersji produkcyjnej): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Ważne jest, aby w masce pola uwzględnić status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyświetlane jako OK. Google nie zaleca używania maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wynik z mniejszym opóźnieniem.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a to może wydłużyć czas obliczeń. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się zmniejszyć, ponieważ nowe pola, które dodamy, będą automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje mniejszy rozmiar odpowiedzi, a co za tym idzie, większą przepustowość sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi ze względu na zbiór terminali i pośrednich punktów pośrednich.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maską pola odpowiedzi możesz podać, używając parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL. Wartość ma postać listy rozdzielonych przecinkami ścieżek pól. Zapoznaj się ze szczegółową dokumentacją tworzenia ścieżek pól.

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do sprawdzenia ręcznego): X-Goog-FieldMask: *
  • Maska pól Czas trwania na poziomie trasy, Odległość i Wielokąt (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Nie zalecamy używania symbolu wieloznacznego (*) w masie odpowiedzi ani określania maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wynik z mniejszym opóźnieniem.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a to może wydłużyć czas obliczeń. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się zmniejszyć, ponieważ nowe pola, które dodamy, będą automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje mniejszy rozmiar odpowiedzi, a co za tym idzie, większą przepustowość sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.

ComputeCustomRoutesRequest

Komunikat z prośbą o obliczenie tras niestandardowych.

Pola
origin

Waypoint

Wymagane. Punkt początkowy.
destination

Waypoint

Wymagane. Docelowy punkt na trasie.
intermediates[]

Waypoint

Opcjonalnie: zestaw punktów pośrednich na trasie (z wyłączeniem punktów końcowych) do zatrzymania się lub przejazdu obok; Obsługiwanych jest maksymalnie 25 punktów pośrednich.
travel_mode

RouteTravelMode

Opcjonalnie: Określa środek transportu. Obsługiwane są tylko wartości DRIVE i „TWO_WHEELER”.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranych preferencji routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferowaną jakość polilinii.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie wieloboku.
departure_time

Timestamp

Opcjonalnie: Godzina wyjazdu. Jeśli nie ustawisz tej wartości, zostanie ona domyślnie ustawiona na czas wysłania żądania. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.
route_modifiers

RouteModifiers

Opcjonalnie: Zestaw warunków, które wpływają na sposób obliczania tras.
route_objective

RouteObjective

Wymagane. Trasa, pod kątem której chcesz prowadzić optymalizację.
language_code

string

Opcjonalnie: Kod języka BCP-47, np. „pl-PL” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator języka w standardzie Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie wywnioskowany na podstawie lokalizacji żądania trasy.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole instruction w NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary stosowane dla trasy, odcinka, dystansu ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki są ustalane na podstawie lokalizacji żądania.

ComputeCustomRoutesResponse

Odpowiedź na ComputeCustomRoutes.

Pola
routes[]

CustomRoute

„najlepsze” trasy dla docelowej trasy wejściowej.
fastest_route

CustomRoute

Najszybsza trasa referencyjna.
shortest_route

CustomRoute

Najkrótsza trasa referencyjna.
fallback_info

FallbackInfo

Informacje zastępcze o trasach niestandardowych.

FallbackInfo

Obejmuje informacje o kreacji zastępczej dla funkcji ComputeCustomRoutes. Funkcja ComputeCustomRoutes wykonuje 2 typy kreacji zastępczych:

  1. Jeśli nie uda się obliczyć trasy za pomocą routing_preference określonej przez klienta, system użyje innego trybu routingu. W takim przypadku do przekazania informacji o używanym trybie routingu awaryjnego oraz informacji o przyczynie działania awaryjnego są używane parametry fallback_routing_mode i routing_mode_fallback_reason.

  2. Jeśli nie może obliczyć „najlepszej” trasy dla celu trasy określonego przez klienta, może użyć innego celu. fallback_route_objective służy do komunikacji celu ścieżki awaryjnej.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty do odpowiedzi. Jeśli został uruchomiony tryb awaryjny, może on być inny niż preferencja routingu ustawiona w pierwotnym żądaniu klienta.
routing_mode_reason

FallbackReason

powód, dla którego zamiast pierwotnej odpowiedzi użyto odpowiedzi zastępczej. To pole jest wypełniane tylko wtedy, gdy zostanie wywołany tryb zastępczy i zwrócona zostanie odpowiedź zastępcza.
route_objective

FallbackRouteObjective

Cel trasy użyty w odpowiedzi. Jeśli aktywowano reklamę zastępczą, cel może się różnić od celu trasy podanego w pierwotnym żądaniu klienta.

FallbackRouteObjective

Wartość RouteObjective użyta w odpowiedzi.

Wartości w polu enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Nieokreślony cel trasy zapasowej.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Jeśli klient wysyła żądanie RateCard i ustawia wartość include_tolls na true, a Google nie ma danych o cenach opłat drogowych na trasie, interfejs API powraca do interfejsu RateCard i nie uwzględnia wysokości opłaty drogowej.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

Wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. Moc zbioru źródeł i miejsc docelowych podlega kilku ograniczeniom rozmiaru:

  • Liczba elementów (początki × miejsca docelowe) nie może przekraczać 625 w żadnym przypadku.
  • Liczba elementów (origins × miejsca docelowe) nie może być większa niż 100, jeśli parametr routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL.
  • Liczba punktów pośrednich (miejsc wylotu + miejsc docelowych) podanych jako place_id nie może przekraczać 50.
destinations[]

RouteMatrixDestination

Wymagane. Tablica miejsc docelowych, która określa kolumny macierzy odpowiedzi.
travel_mode

RouteTravelMode

Opcjonalnie: Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie podasz tej wartości, zostanie użyta domyślna wartość czasu, w którym wysłano żądanie. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.

ComputeRoutesRequest

Wiadomość z prośbą: ComputeRoutes.

Pola
origin

Waypoint

Wymagane. Punkt początkowy.
destination

Waypoint

Wymagane. Docelowy punkt na trasie.
intermediates[]

Waypoint

Opcjonalnie: zestaw punktów pośrednich na trasie (z wyłączeniem punktów końcowych) do zatrzymania się lub przejazdu obok; Obsługiwanych jest maksymalnie 25 punktów pośrednich.
travel_mode

RouteTravelMode

Opcjonalnie: Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferowaną jakość polilinii.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie wieloboku.
departure_time

Timestamp

Opcjonalnie: Godzina wyjazdu. Jeśli nie ustawisz tej wartości, zostanie ona domyślnie ustawiona na czas wysłania żądania. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.
compute_alternative_routes

bool

Opcjonalnie: Określa, czy oprócz trasy mają być obliczane alternatywne trasy. W przypadku żądań z punktami pośrednimi nie są zwracane żadne alternatywne trasy.
route_modifiers

RouteModifiers

Opcjonalnie: Zestaw warunków, które należy spełnić, a które wpływają na sposób obliczania tras.
language_code

string

Opcjonalnie: Kod języka BCP-47, np. „pl-PL” lub „sr-Latn”. Więcej informacji znajdziesz w sekcji Identyfikator języka Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie wywnioskowany na podstawie lokalizacji żądania trasy.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole instruction w NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary stosowane dla trasy, odcinka, dystansu ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki są ustalane na podstawie lokalizacji żądania.
optimize_waypoint_order

bool

Jeśli parametr optimizeWaypointOrder ma wartość Prawda, podejmowane są próby zmiany kolejności podanych pośrednich punktów kontrolnych, aby zminimalizować całkowity koszt trasy. Jeśli dowolny z pośrednich punktów pośrednich jest punkt pośredni, żądanie nie powiedzie się. Aby znaleźć nową kolejność, użyj ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index. Jeśli w nagłówku X-Goog-FieldMask nie ma informacji o routes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli optimize_waypoint_order ma wartość Fałsz, ComputeRoutesResponse.optimized_intermediate_waypoint_index jest pusta.

ComputeRoutesResponse

ComputeRoute zarządza komunikatem z odpowiedzią.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), jeśli została określona jako compute_alternatives_routes, oraz zawiera tylko jedną trasę, jeśli nie jest. Jeśli tablica zawiera wiele wpisów, pierwszy z nich jest najlepszą trasą. Jeśli tablica jest pusta, oznacza to, że nie udało się znaleźć trasy.
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie może obliczyć trasy z uwzględnieniem wszystkich preferencji, może użyć innego sposobu obliczeń. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiednich odpowiedziach. W przeciwnym razie to pole nie jest skonfigurowane.

CustomRoute

Obejmuje trasę niestandardową obliczoną na podstawie celu trasy określonego przez klienta. CustomRoute zawiera trasę i token trasy, które można przekazać do NavSDK w celu odtworzenia trasy niestandardowej na potrzeby nawigacji krok po kroku.

Pola
route

Route

Droga uznana za „najlepszą” na potrzeby wejściowej trasy.
token

string

Zoptymalizowany pod kątem internetu i zakodowywano w standardzie base64 token trasy, który można przekazać do NavSDK. Pozwala on NavSDK na odtworzenie trasy podczas nawigacji, a w przypadku zmiany trasy zachowuje pierwotny zamiar, gdy wywoływana jest funkcja RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczysty blok danych.

FallbackInfo

Informacje o tym, jak i dlaczego został użyty wynik kreacji zastępczej. Jeśli to pole jest ustawione, oznacza to, że serwer jako awaryjnego użył innego trybu routingu niż preferowany.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty do odpowiedzi. Jeśli został uruchomiony tryb awaryjny, może on być inny niż preferencja routingu ustawiona w pierwotnym żądaniu klienta.
reason

FallbackReason

powód, dla którego zamiast pierwotnej odpowiedzi użyto odpowiedzi zastępczej. To pole jest wypełniane tylko po uruchomieniu trybu kreacji zastępczej i zwrocie odpowiedzi zastępczej.

FallbackReason

Powody stosowania odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano powodu korzystania z alternatywy.
SERVER_ERROR Podczas obliczania trasy w preferowanym trybie nawigacji wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym.
LATENCY_EXCEEDED Nie udało nam się na czas ukończyć obliczeń przy użyciu preferowanego trybu routingu, ale udało nam się zwrócić wynik obliczony w innym trybie.

FallbackRoutingMode

Rzeczywisty tryb kierowania użyty do zwróconej odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Nieużywane.
FALLBACK_TRAFFIC_UNAWARE Wskazuje, że do obliczenia odpowiedzi użyto trybu kierowania TRAFFIC_UNAWARE.
FALLBACK_TRAFFIC_AWARE Wskazuje, że do obliczenia odpowiedzi został użyty tryb routingu TRAFFIC_AWARE.

Lokalizacja

Obejmuje lokalizację (punkt geograficzny i opcjonalny nagłówek).

Pola
lat_lng

LatLng

Współrzędne geograficzne punktu pośredniego.
heading

Int32Value

Nagłówek kompasu powiązany z kierunkiem ruchu. Ta wartość określa po stronie drogi, po której na miejscu będą czekać przejazdy i odjazd. Nagłówek może przyjmować wartości z zakresu od 0 do 360, gdzie 0 wskazuje kierunek kierunku północnego, 90 określa kierunek kierunku wschódzkiego itd. Tego pola możesz użyć tylko w przypadku środków transportu DRIVE i TWO_WHEELER.

Manewr

Zbiór wartości, które określają działanie nawigacji do wykonania w bieżącym kroku (np. skręć w lewo, scal lub prosto).

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywane.
TURN_SLIGHT_LEFT Obróć się lekko w lewo.
TURN_SHARP_LEFT Skręć ostro w lewo.
UTURN_LEFT Zawróć w lewo.
TURN_LEFT Skręć w lewo.
TURN_SLIGHT_RIGHT Skręć lekko w prawo.
TURN_SHARP_RIGHT Skręć ostro w prawo.
UTURN_RIGHT Zawróć w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Idź prosto.
RAMP_LEFT Wejdź na lewą rampę.
RAMP_RIGHT Skręć w w prawo.
MERGE Scalanie w ruch.
FORK_LEFT Skręć w lewo.
FORK_RIGHT Skręć w prawo.
FERRY Promem.
FERRY_TRAIN Weź pociąg na prom.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
DEPART Manewr początkowy.
NAME_CHANGE Służy do wskazania zmiany nazwy ulicy.
Pola
maneuver

Maneuver

Obejmuje instrukcje nawigacji dotyczące bieżącego kroku (np. skręć w lewo, scal lub prosto). To pole określa, która ikona ma być wyświetlana.
instructions

string

Instrukcje dotyczące poruszania się po tym kroku.

Linia łamana

Oznacza zakodowaną linię łamaną.

Pola
Pole unii polyline_type. Obejmuje typ linii łamanej. Wartość domyślna to encoded_polyline. polyline_type może być tylko jednym z tych elementów:
encoded_polyline

string

Kodowanie ciągu znaków linii łamanej za pomocą algorytmu kodowania linii łamanej.
geo_json_linestring

Struct

Określa linię łamaną w formacie wiersza GeoJSON.

PolylineEncoding

Określa preferowany typ linii łamanej do zwrócenia.

Wartości w polu enum
POLYLINE_ENCODING_UNSPECIFIED Nie określono preferowanego typu łańcucha wielokątów. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE Określa linię łamaną zakodowaną przy użyciu algorytmu kodowania linii łamanej.
GEO_JSON_LINESTRING Określa linię łamaną w formacie wiersza GeoJSON.

PolylineQuality

Zbiór wartości określających jakość linii łamanej.

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji jakości linii łamanej. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa wielobok wysokiej jakości, który jest tworzony z większą liczbą punktów niż OVERVIEW, co powoduje zwiększenie rozmiaru odpowiedzi. Użyj tej wartości, gdy potrzebujesz większej precyzji.
OVERVIEW Określa linię łamaną przeglądu, która składa się z niewielkiej liczby punktów. Użyj tej wartości, aby wyświetlić ogólny widok trasy. Ta opcja wiąże się z krótszym czasem oczekiwania na żądanie w porównaniu z opcją HIGH_QUALITY.

Trasa

Zawiera trasę, która składa się z szeregu połączonych odcinków dróg łączących punkty początkowe, końcowe i pośrednie.

Pola
legs[]

RouteLeg

zbiór odcinków (segmentów ścieżki między punktami orientacyjnymi), które tworzą trasę; Każdy odcinek odpowiada podróży między dwoma punktami pośrednimi niebędącymi via. Na przykład trasa bez pośrednich punktów kontrolnych ma tylko 1 etap. Trasa obejmująca jeden punkt pośredni inny niż via ma dwie nogi. Trasa zawierająca 1 punkt pośredni via ma 1 etap. Kolejność etapów odpowiada kolejności punktów Waypoint od origin do intermediates do destination.
distance_meters

int32

Odległość do przebycia na trasie w metrach.
duration

Duration

Czas potrzebny na przejechanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, będzie ona taka sama jak wartość static_duration. Jeśli ustawisz parametr routing_preference na wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków ruchu.
static_duration

Duration

Długość trasy bez uwzględnienia warunków drogowych.
polyline

Polyline

Linia łamana całej trasy. Ta linia łamana to połączona linia łamana ze wszystkich elementów typu legs.
description

string

Opis trasy.
warnings[]

string

Tablica ostrzeżeń wyświetlanych przy wyświetlaniu trasy.
viewport

Viewport

Ramka ograniczająca widoczny obszar linii łamanej.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.
optimized_intermediate_waypoint_index[]

int32

Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość true (prawda), to pole zawiera zoptymalizowaną kolejność punktów pośrednich pośrednich. W przeciwnym razie to pole jest puste. Załóżmy na przykład, że dane wejściowe to Pochodzenie: LA; dla średnio zaawansowanych: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork, a zoptymalizowana kolejność pośrednich punktów pośrednich: Phoenix, Dallas, Bangor. W tym przypadku pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego punktu pośredniego.

RouteLeg

Zawiera segment między punktami pośrednimi innymi niż via.

Pola
distance_meters

int32

Odległość do przebycia na etapie trasy w metrach.
duration

Duration

Czas potrzebny na przebycie odcinka. Jeśli route_preference ma wartość TRAFFIC_UNAWARE, ta wartość jest taka sama jak static_duration. Jeśli route_preference to TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków na drodze.
static_duration

Duration

Czas przejazdu na danej trasie, obliczony bez uwzględnienia warunków ruchu.
polyline

Polyline

Całkowity wielokąt dla tego etapu. Obejmuje to również linię łamaną każdej step.
start_location

Location

Lokalizacja początkowa tego etapu. Może się on różnić od podanego origin. Jeśli na przykład podany punkt origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.
end_location

Location

Lokalizacja końcowa tego odcinka. Może się on różnić od podanego destination. Jeśli na przykład podany obiekt destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.
steps[]

RouteLegStep

Tablica kroków oznaczających segmenty w danym etapie. Każdy krok odpowiada jednej instrukcji nawigacji.
travel_advisory

RouteLegTravelAdvisory

Obejmuje dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak ewentualne ograniczenia dotyczące strefy ruchu itp. na danym etapie trasy.

RouteLegStep

Zawiera segment RouteLeg. Etap odpowiada pojedynczej instrukcji dotyczącej nawigacji. Etapy trasy składają się ze stopni.

Pola
distance_meters

int32

Długość tego kroku w metrach. W niektórych przypadkach to pole może nie mieć wartości.
static_duration

Duration

Czas przejazdu na tym etapie bez uwzględniania warunków na drodze. W niektórych przypadkach to pole może nie mieć wartości.
polyline

Polyline

Polilinia powiązana z tym krokiem.
start_location

Location

Lokalizacja początkowa tego kroku.
end_location

Location

Lokalizacja końcowa tego kroku.
navigation_instruction

NavigationInstruction

Instrukcje nawigacji.
travel_advisory

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. o możliwym ograniczeniu ruchu na danym etapie.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak możliwe ograniczenie strefy ruchu na etapie etapu.

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole jest obecnie puste.

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. o możliwych ograniczeniach w strefach ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach za przejazd na określonym RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd RouteLeg. Jeśli to pole jest skonfigurowane, ale pole podrzędne estimated_price nie jest wypełnione, można oczekiwać, że na tej drodze znajdują się drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, oznacza to, że na RouteLeg nie ma opłat.
speed_reading_intervals[]

SpeedReadingInterval

Interwały szybkości czytania określające gęstość ruchu. Dotyczy preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną RouteLeg bez nakładania się. Punkt początkowy określonego interwału jest taki sam jak punkt końcowy poprzedniego interwału.

Przykład:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Jedno miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Docelowy punkt na trasie

RouteMatrixElement

Zawiera informacje o trasie obliczonej dla pary miejsc docelowych/miejsc wylotu w interfejsie ComputeRouteMatrix API. To proto może być przesyłane strumieniowo do klienta.

Pola
origin_index

int32

Indeks liczony od zera dla punktu początkowego w żądaniu.
destination_index

int32

Indeks liczony od zera dla miejsca docelowego w żądaniu.
status

Status

Kod stanu błędu tego elementu.
condition

RouteMatrixElementCondition

Wskazuje, czy trasa została znaleziona. Niezależny od stanu.
distance_meters

int32

Odległość do przebycia na trasie w metrach.
duration

Duration

Czas potrzebny na przejechanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, będzie ona taka sama jak wartość static_duration. Jeśli ustawisz parametr routing_preference na wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków ruchu.
static_duration

Duration

Czas przejazdu trasy bez uwzględnienia warunków na drodze.
travel_advisory

RouteTravelAdvisory

dodatkowe informacje o trasie. Na przykład: informacje o ograniczeniach i informacje o opłatach
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy przy określonych preferencjach dla danej pary punktu początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używany jest tryb zapasowy, to pole zawiera szczegółowe informacje o odpowiednich odpowiedziach. W przeciwnym razie to pole jest nieskonfigurowane.

RouteMatrixElementCondition

Stan zwracanej trasy.

Wartości w polu enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Używany tylko wtedy, gdy status elementu nie jest OK.
ROUTE_EXISTS Znaleziono trasę i uzupełniono odpowiednie informacje dla elementu.
ROUTE_NOT_FOUND Nie znaleziono trasy. Pola zawierające informacje o trasie, takie jak distance_meters lub duration, nie będą wypełniane w elemencie.

RouteMatrixOrigin

Pojedyncze źródło dla żądania ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

Opcjonalnie: Modyfikatory każdej trasy, która jako punkt początkowy

RouteModifiers

Obejmuje zestaw opcjonalnych warunków, które muszą zostać spełnione przy obliczaniu tras.

Pola
avoid_tolls

bool

Gdy ta opcja jest ustawiona na wartość true (prawda), aplikacja omija drogi płatne, jeśli to możliwe, preferując trasy nieobejmujące dróg płatnych. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_highways

bool

Jeśli zasada ma wartość Prawda, w miarę możliwości omija autostrady i ma pierwszeństwo przed trasami, które nie zawierają autostrad. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_ferries

bool

Jeśli zasada ma wartość Prawda, w miarę możliwości omija przeprawy promowe, traktując priorytetowo trasy niezawierające promów. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_indoor

bool

Jeśli zasada ma wartość Prawda, w miarę możliwości pomijane jest poruszanie się po wnętrzach, lecz preferowane są trasy, które nie zawierają nawigacji wewnątrz budynków. Dotyczy tylko trybu podróży WALK.
vehicle_info

VehicleInfo

Określa informacje o pojeździe.
toll_passes[]

TollPass

Obejmuje informacje o winietach. Jeśli podane są winiety, interfejs API próbuje zwrócić ich cenę. Jeśli nie podasz karty, API uzna ją za nieznaną i spróbuje zwrócić cenę gotówkową. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.

RouteObjective

Obejmuje cel optymalizacji pod kątem ComputeCustomRoutes.

Pola
Pole unii objective. Cel trasy. objective może być tylko jednym z tych elementów:
rate_card

RateCard

Cel arkusza stawek.

RateCard

Zawiera cel RateCard trasy.

Pola
cost_per_minute

MonetaryCost

Opcjonalnie: Koszt na minutę.
cost_per_km

MonetaryCost

Opcjonalnie: Koszt za kilometr.
include_tolls

bool

Opcjonalnie: Czy uwzględnić koszt opłat drogowych w łącznym koszcie.

MonetaryCost

Zawiera koszt użyty w arkuszu stawek.

Pola
value

double

Wymagane. Wartość kosztu w walucie lokalnej określona na podstawie żądania.

RouteTravelAdvisory

Obejmuje dodatkowe informacje, o których należy poinformować użytkownika, takie jak możliwe ograniczenia w strefie ruchu itp.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na trasie. To pole jest wypełnione tylko wtedy, gdy przewidujemy, że na trasie będą naliczane opłaty. Jeśli to pole jest skonfigurowane, ale pole podrzędne estimated_price nie jest wypełnione, można oczekiwać, że na tej drodze znajdują się drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie jest ustawione, zakładamy, że na trasie nie ma opłat.
speed_reading_intervals[]

SpeedReadingInterval

Interwały odczytu dotyczące szybkości z informacją o gęstości ruchu. Dotyczy preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Interwały obejmują cały poligon trasy bez nakładania się. Punkt początkowy określonego interwału jest taki sam jak punkt końcowy poprzedniego interwału.

Przykład:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

Zbiór wartości używanych do określenia środka transportu.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu. Domyślna wartość to DRIVE.
DRIVE podróż samochodem osobowym,
BICYCLE Podróż rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Dwukołowy pojazd mechaniczny. Na przykład motocykl. Pamiętaj, że BICYCLE to tryb podróży, który obejmuje tryb obsługiwany przez człowieka.
TAXI

Podróżuj licencjonowaną taksówką, która na niektórych obszarach może pozwolić pojazdom poruszać się wyznaczonymi pasami dla taksówek.

Tryb TAXI to funkcja eksperymentalna. Jeśli klient poprosi o trasę taksówką w mieście, w którym nie ma informacji o pasach dla taksówek, zostanie zwrócona trasa STORAGE.

RoutingPreference

Zestaw wartości określających czynniki, które należy wziąć pod uwagę podczas obliczania trasy.

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślna wartość to TRAFFIC_AWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględnienia aktualnych warunków drogowych. Przydatne, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości pozwala zminimalizować opóźnienie. Uwaga: w przypadku RouteTravelMode DRIVE i TWO_WHEELER wybrana trasa i czas trwania są określane na podstawie sieci drogowej i średnich warunków na drodze niezależnie od pory dnia. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki dla danego żądania mogą się zmieniać w czasie z powodu zmian w sieci drogowej, zaktualizowanych średnich warunków ruchu i rozproszonej natury usługi. Mogą się też różnić w przypadku zbliżonych tras w dowolnym momencie i z jednakową częstotliwością.
TRAFFIC_AWARE oblicza trasy, biorąc pod uwagę warunki na drogach. W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL, niektóre optymalizacje są stosowane w celu znacznego skrócenia opóźnień.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę warunki na drodze, bez stosowania większości optymalizacji wydajności. Użycie tej wartości powoduje największe opóźnienie.

SpeedReadingInterval

Wskaźnik natężenia ruchu na przyległym odcinku linii łamanej lub ścieżki. W przypadku ścieżki z punktami P_0, P_1,…, P_N (indeks od 0) SpeedReadingInterval definiuje przedział i opisuje ruch za pomocą tych kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału w wielokącie. Jeśli indeks w pliku JSON wynosi 0, pole wydaje się niepełne.
end_polyline_point_index

int32

Indeks końcowy tego przedziału na linii łamanej. W pliku JSON, gdy indeks ma wartość 0, pole wydaje się być puste.
speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja szybkości linii łamanej na podstawie danych o ruchu.

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

TollInfo

Zawiera informacje o opłatach w dokumentach Route lub RouteLeg.

Pola
estimated_price[]

Money

Kwota opłat za przejazd dla odpowiedniego Route lub RouteLeg. Ta lista zawiera kwoty w poszczególnych walutach, które mają być pobierane na stacjach opłat drogowych. Zwykle ta lista zawiera tylko jeden element w przypadku tras z opłatami za przejazd w jednej walucie. W przypadku podróży międzynarodowych lista może zawierać wiele pozycji, które odzwierciedlają opłaty w różnych walutach.

TollPass

Lista obsługiwanych przez nas kart do opłat drogowych na całym świecie.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywane. Jeśli zostanie użyta ta wartość, żądanie zakończy się niepowodzeniem.
AU_ETOLL_TAG Jeden z wielu dostawców karty opłat drogowych w Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Jeden z wielu dostawców karty opłat drogowych w Sydney. https://www.tollpay.com.au/
AU_LINKT Winieta w całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Winieta w Argentynie. Więcej informacji znajdziesz na stronie https://telepase.com.ar.
BR_AUTO_EXPRESO Winieta brazylijska. Więcej informacji znajdziesz na stronie https://www.autoexpreso.com.
BR_CONECTCAR winieta w Brazylii. Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS Winieta brazylijska. Więcej informacji znajdziesz na stronie https://movemais.com.
BR_PASSA_RAPIDO Winieta brazylijska. Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR Winieta brazylijska. Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY winieta w Brazylii. Więcej informacji znajdziesz na https://taggy.com.br.
BR_VELOE winieta w Brazylii. Więcej informacji znajdziesz na https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Przejście graniczne między Kanadą a Stanami Zjednoczonymi.
CA_US_BLUE_WATER_EDGE_PASS Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_NEXUS_CARD Przejście graniczne między Kanadą a Stanami Zjednoczonymi.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez wiele banków używanych do płacenia opłat. Wszystkie karty elektroniczne w bankach są rozliczane w taki sam sposób, więc potrzebna jest tylko jedna wartość wyliczeniowa. Przykład: Bank Mandiri https://www.bankmandiri.co.id/e-money, BCA https://www.bca.co.id/flazz, BNI https://www.bni.co.id/id-id/ebanking/tapcash.
IN_FASTAG Indie.
IN_LOCAL_HP_PLATE_EXEMPT Indie, zwolnienie z numeru rejestracyjnego HP.
JP_ETC Japonia ETC. Bezprzewodowy system elektroniczny do pobierania opłat za przejazd autostradą. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Nowa wersja ETC z dodatkowym rabatem i komunikacją dwukierunkową między urządzeniami w pojazdach a antenami na drodze. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksyk https://iave.capufe.gob.mx/#/
MX_PASE Meksyk https://www.pase.com.mx
MX_QUICKPASS Meksyk https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA Meksyk http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Meksyk
MX_TAG_TELEVIA Meksykański wystawca winiet. Jeden z wielu w Meksyku. Więcej informacji znajdziesz na stronie https://www.televia.com.mx.
MX_TELEVIA Meksykański wystawca winiet. Jedna z wielu placówek w Meksyku. https://www.televia.com.mx
MX_VIAPASS winieta w Meksyku. Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że oprócz naklejki na pojazd czystego powietrza (CAV) wydanej przez DMV kierowca ma dowolny bilet FasTrak. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Kolorado, Stany Zjednoczone
US_CO_GO_PASS Kolorado, Stany Zjednoczone
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floryda, Stany Zjednoczone.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floryda, Stany Zjednoczone.
US_FL_EPASS Floryda, Stany Zjednoczone.
US_FL_GIBA_TOLL_PASS Floryda, Stany Zjednoczone.
US_FL_LEEWAY Floryda, Stany Zjednoczone.
US_FL_SUNPASS Floryda, Stany Zjednoczone.
US_FL_SUNPASS_PRO Floryda, Stany Zjednoczone.
US_IL_EZPASSIL IL, Stany Zjednoczone.
US_IL_IPASS IL, Stany Zjednoczone.
US_IN_EZPASSIN IN, Stany Zjednoczone.
US_KS_BESTPASS_HORIZON Kansas, Stany Zjednoczone.
US_KS_KTAG Kansas, Stany Zjednoczone.
US_KS_NATIONALPASS Kansas, Stany Zjednoczone.
US_KS_PREPASS_ELITEPASS KS, Stany Zjednoczone
US_LA_GEAUXPASS Los Angeles, Stany Zjednoczone.
US_LA_TOLL_TAG Los Angeles, Stany Zjednoczone.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD Maryland, Stany Zjednoczone.
US_ME_EZPASSME ME, Stany Zjednoczone.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, Stany Zjednoczone.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Stany Zjednoczone.
US_MI_IQ_PROX_CARD

MI, USA. Wycofany, ponieważ ten typ dokumentu nie istnieje.
US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Stany Zjednoczone.
US_MI_NEXPRESS_TOLL MI, Stany Zjednoczone.
US_MN_EZPASSMN MN, Stany Zjednoczone.
US_NC_EZPASSNC NC, Stany Zjednoczone
US_NC_PEACH_PASS Karolina Północna, USA.
US_NC_QUICK_PASS Karolina Północna, USA.
US_NH_EZPASSNH NH, Stany Zjednoczone.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stany Zjednoczone.
US_NJ_EZPASSNJ NJ, Stany Zjednoczone.
US_NY_EXPRESSPASS Nowy Jork, Stany Zjednoczone.
US_NY_EZPASSNY Nowy Jork, Stany Zjednoczone.
US_OH_EZPASSOH Ohio, Stany Zjednoczone.
US_PA_EZPASSPA Stany Zjednoczone, Pensylwania.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG Teksas, Stany Zjednoczone.
US_TX_BANCPASS Teksas, Stany Zjednoczone.
US_TX_DEL_RIO_PASS Teksas, Stany Zjednoczone.
US_TX_EFAST_PASS Teksas, Stany Zjednoczone.
US_TX_EAGLE_PASS_EXPRESS_CARD Teksas, Stany Zjednoczone.
US_TX_EPTOLL Teksas, Stany Zjednoczone.
US_TX_EZ_CROSS Teksas, Stany Zjednoczone.
US_TX_EZTAG Teksas, Stany Zjednoczone.
US_TX_FUEGO_TAG Teksas, Stany Zjednoczone.
US_TX_LAREDO_TRADE_TAG Teksas, Stany Zjednoczone.
US_TX_PLUSPASS Teksas, Stany Zjednoczone.
US_TX_TOLLTAG Teksas, Stany Zjednoczone.
US_TX_TXTAG Teksas, Stany Zjednoczone.
US_TX_XPRESS_CARD Teksas, Stany Zjednoczone.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Utah, Stany Zjednoczone.
US_VA_EZPASSVA VA, Stany Zjednoczone.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO Stany Zjednoczone, stan Waszyngton.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS Wirginia Zachodnia, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

Jednostki

Zestaw wartości określających jednostkę miary używaną w wyświetlaniu.

Wartości w polu enum
UNITS_UNSPECIFIED Nie określono jednostek miary. Przyjmuje wartość domyślną jednostki miary ustalonej na podstawie żądania.
METRIC Jednostki metryczne.
IMPERIAL jednostki miary imperialne (angielskie).

VehicleEmissionType

Zestaw wartości opisujących typ emisji pojazdu. Dotyczy tylko środka transportu DIRECT.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie wybrano typu emisji. Domyślnie: GASOLINE.
GASOLINE Pojazd napędzany benzyną.
ELECTRIC Pojazd elektryczny.
HYBRID Pojazd na paliwo hybrydowe (np. benzynowy i elektryczny).

VehicleInfo

Zawiera informacje o pojeździe, takie jak typ emisji dwutlenku węgla.

Pola
emission_type

VehicleEmissionType

Opisuje rodzaj emisji pojazdu. Dotyczy tylko DRIVE RouteTravelMode.

Punkt pośredni

Obejmuje punkt pośredni. Punkty pośrednie oznaczają zarówno początek, jak i koniec trasy, a także przystanki pośrednie na trasie.

Pola
via

bool

Oznacza ten punkt kontrolny jako etap, a nie punkt postoju. W przypadku każdego punktu pośredniego innego w żądaniu odpowiedź dołącza wpis do tablicy legs ze szczegółowymi informacjami o przystankach na danym etapie podróży. Ustaw tę wartość na „PRAWDA”, jeśli chcesz, aby trasa przebiegała przez ten punkt orientacyjny bez zatrzymywania się. Punkty pośrednie nie powodują dodania wpisu do tablicy legs, ale prowadzą trasę przez punkt pośredni. Tę wartość możesz ustawić tylko w przypadku punktów kontrolnych, które są pośrednimi. Żądanie nie powiedzie się, jeśli ustawisz to pole na punktach pośrednich terminala. Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość true (prawda), to pole nie może mieć wartości true (prawda). W przeciwnym razie żądanie kończy się niepowodzeniem.
vehicle_stopover

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, na których chcą się zatrzymać, a celem jest wsiądź do niego lub wysiąść. Gdy ustawisz tę wartość, obliczona trasa nie będzie uwzględniała punktów na trasie innych niż via na drogach, które nie nadają się do wstrzymywania i wyjazdu. Ta opcja działa tylko w przypadku środków transportu DRIVE i TWO_WHEELER, a location_type ma wartość location.
side_of_road

bool

Wskazuje, że umiejscowienie tego punktu pośredniego powinno umożliwiać zatrzymanie pojazdu po określonej stronie drogi. Po ustawieniu tej wartości trasa będzie przebiegać przez lokalizację, tak aby pojazd mógł się zatrzymać na poboczu drogi, w kierunku której lokalizacja jest przekierowana od środka drogi. Ta opcja działa tylko w przypadku trybów podróży „DRIVE” i „TWO_WHEELER”.
Pole sumy location_type. Różne sposoby przedstawiania lokalizacji. location_type może mieć tylko jedną z tych wartości:
location

Location

Punkt określony za pomocą współrzędnych geograficznych, w tym opcjonalny nagłówek.
place_id

string

Identyfikator miejsca docelowego powiązany z punktem drogi.