Package google.maps.routes.v1

Indeks

RoutesPreferred

Routes Preferred API.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Na podstawie zestawu punktów końcowych i pośrednich oraz celu trasy oblicza najlepszą trasę pod kątem tego celu. Zwraca też 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ć za pomocą parametru adresu URL $fields lub fields albo za pomocą nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek do pól rozdzielonych przecinkami. Szczegółowe informacje o tworzeniu ścieżek pól znajdziesz w tej dokumentacji.

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do ręcznego sprawdzenia): X-Goog-FieldMask: *
  • Maska pola odległości, czasu trwania, tokena i informacji o opłatach za przejazd: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*) lub określanie maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność w zakresie opóźnienia. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym zwiększenie przepustowości sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu OAuth 2.0.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Przyjmuje listę miejsc początkowych i docelowych oraz zwraca strumień zawierający informacje o trasie dla każdej kombinacji miejsca początkowego i docelowego.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo za pomocą nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek do pól rozdzielonych przecinkami. Szczegółowe informacje o tworzeniu ścieżek pól znajdziesz w tej dokumentacji.

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do ręcznego sprawdzenia): X-Goog-FieldMask: *
  • Maska pola czasu trwania trasy, odległości, stanu elementu, warunku i indeksów elementów (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Koniecznie umieść w masce pola znak status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyglądać na prawidłowe. Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność w zakresie opóźnienia. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym zwiększenie przepustowości sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca trasę główną wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu punktów końcowych i pośrednich.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek do pól rozdzielonych przecinkami. Szczegółową dokumentację na temat tworzenia ścieżek pól znajdziesz tutaj.

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do ręcznego sprawdzenia): X-Goog-FieldMask: *
  • Maska pola czasu trwania, odległości i linii łamanej na poziomie trasy (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*) lub określanie maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność w zakresie opóźnienia. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym zwiększenie przepustowości sieci.
Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu OAuth 2.0.

ComputeCustomRoutesRequest

Komunikat żądania ComputeCustomRoutes.

Pola
origin

Waypoint

Wymagane. Punkt na trasie źródłowej.
destination

Waypoint

Wymagane. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie: Zbiór punktów pośrednich na trasie (z wyłączeniem punktów końcowych), w których można się zatrzymać lub przez które można przejechać. 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 obliczyć trasę, korzystając z wybranych preferencji dotyczących wyznaczania trasy. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy wartość parametru travel_mode to DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferencje dotyczące jakości linii łamanej.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie polilinii.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyty 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 muszą zostać spełnione i które wpływają na sposób obliczania tras.
route_objective

RouteObjective

Wymagane. Cel trasy, pod kątem którego ma być przeprowadzona optymalizacja.
language_code

string

Opcjonalnie: Kod języka w standardzie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator ustawień regionalnych 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 określony na podstawie lokalizacji żądania trasy.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlania. Obejmuje to pole instruction w NavigationInstruction. Jednostki miary używane w przypadku trasy, odcinka, odległości kroku i czasu trwania nie zależą od tej wartości. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną wywnioskowane na podstawie lokalizacji żądania.

ComputeCustomRoutesResponse

Wiadomość odpowiedzi ComputeCustomRoutes.

Pola
routes[]

CustomRoute

„Najlepsze” trasy dla celu trasy wejściowej.
fastest_route

CustomRoute

Najszybsza trasa referencyjna.
shortest_route

CustomRoute

Najkrótsza trasa referencyjna.
fallback_info

FallbackInfo

Informacje zapasowe dotyczące tras niestandardowych.

FallbackInfo

Zawiera informacje o wersji zastępczej dla ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 rodzaje zastępczych wyświetlanych ścieżek:

  1. Jeśli nie może obliczyć trasy przy użyciu routing_preference wybranego przez klienta, przełączy się na inny tryb wyznaczania trasy. W tym przypadku metody fallback_routing_mode i routing_mode_fallback_reason służą do przekazywania informacji o używanym trybie routingu awaryjnego oraz o przyczynie jego użycia.

  2. Jeśli nie może obliczyć „najlepszej” trasy dla celu trasy określonego przez klienta, może wrócić do innego celu. fallback_route_objective służy do przekazywania celu trasy zapasowej.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty w odpowiedzi. Jeśli nastąpiło przejście na tryb awaryjny, tryb może się różnić od preferencji dotyczących routingu ustawionych w oryginalnym żą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 uruchomiony tryb kreacji zastępczych i zostanie zwrócona odpowiedź kreacji zastępczej.
route_objective

FallbackRouteObjective

Cel trasy użyty w odpowiedzi. Jeśli nastąpiło przejście na tryb awaryjny, cel może być inny niż cel trasy podany w oryginalnym żądaniu klienta.

FallbackRouteObjective

Cel trasy użyty 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 wyśle żądanie RateCard i ustawi wartość include_tolls na true, a Google nie będzie mieć danych o opłatach za przejazd na danej trasie, interfejs API przełączy się na RateCard bez uwzględniania opłat za przejazd.

ComputeRouteMatrixRequest

Wiadomość z prośbą ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

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

  • Liczba elementów (źródła × miejsca docelowe) w żadnym przypadku nie może przekraczać 625.
  • Jeśli parametr routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL, liczba elementów (źródła × miejsca docelowe) nie może być większa niż 100.
  • Liczba punktów pośrednich (miejsc początkowych i docelowych) określonych jako place_id nie może być większa niż 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 obliczyć trasę, korzystając z wybranych preferencji dotyczących wyznaczania trasy. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy wartość parametru travel_mode to DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
departure_time

Timestamp

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

ComputeRoutesRequest

ComputeRoutes wiadomość z prośbą.

Pola
origin

Waypoint

Wymagane. Punkt na trasie źródłowej.
destination

Waypoint

Wymagane. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie: Zbiór punktów pośrednich na trasie (z wyłączeniem punktów końcowych), w których można się zatrzymać lub przez które można przejechać. 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 obliczyć trasę, korzystając z wybranych preferencji dotyczących wyznaczania trasy. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy wartość parametru travel_mode to DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferencje dotyczące jakości linii łamanej.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie polilinii.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyty 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 trasy alternatywne. W przypadku żądań z pośrednimi punktami na trasie nie są zwracane alternatywne trasy.
route_modifiers

RouteModifiers

Opcjonalnie: Zestaw warunków, które muszą zostać spełnione i które wpływają na sposób obliczania tras.
language_code

string

Opcjonalnie: Kod języka w standardzie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator ustawień regionalnych 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 określony na podstawie lokalizacji żądania trasy.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlania. Obejmuje to pole instruction w NavigationInstruction. Jednostki miary używane w przypadku trasy, odcinka, odległości kroku i czasu trwania nie zależą od tej wartości. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną wywnioskowane na podstawie lokalizacji żądania.
optimize_waypoint_order

bool

Jeśli parametr optimizeWaypointOrder ma wartość true, podejmowana jest próba zmiany kolejności określonych pośrednich punktów trasy w celu zminimalizowania całkowitego kosztu trasy. Jeśli którykolwiek z punktów pośrednich jest punktem pośrednim, żądanie się nie powiedzie. Użyj kodu ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku X-Goog-FieldMask nie ma żądania routes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli zasada optimize_waypoint_order ma wartość fałsz, zasada ComputeRoutesResponse.optimized_intermediate_waypoint_index jest pusta.

ComputeRoutesResponse

ComputeRoutes.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), jeśli podasz wartość compute_alternatives_routes, a tylko jedną trasę, jeśli tego nie zrobisz. Jeśli ta tablica zawiera wiele wpisów, pierwszy z nich jest najbardziej zalecaną 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 jest w stanie obliczyć wyników trasy przy użyciu wszystkich preferencji wejściowych, może zastosować inny sposób obliczania. Gdy używany jest tryb rezerwowy, to pole zawiera szczegółowe informacje o odpowiedzi rezerwowej. W przeciwnym razie to pole nie jest ustawione.

CustomRoute

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

Pola
route

Route

Trasa uznana za „najlepszą” w przypadku celu trasy wejściowej.
token

string

Token trasy zakodowany w formacie base64 bezpiecznym dla internetu, który można przekazać do pakietu SDK Navigation. Umożliwia to pakietowi SDK Navigation odtworzenie trasy podczas nawigacji, a w przypadku zmiany trasy zachowanie pierwotnego zamiaru, gdy wywoływana jest funkcja RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczystą strukturę danych.

FallbackInfo

Informacje o tym, jak i dlaczego użyto wyniku rezerwowego. Jeśli to pole jest ustawione, oznacza to, że serwer użył innego trybu routingu niż preferowany przez Ciebie tryb jako trybu rezerwowego.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty w odpowiedzi. Jeśli nastąpiło przejście na tryb awaryjny, tryb może się różnić od preferencji dotyczących routingu ustawionych w oryginalnym żądaniu klienta.
reason

FallbackReason

Powód, dla którego zamiast pierwotnej odpowiedzi użyto odpowiedzi zastępczej. To pole jest wypełniane tylko wtedy, gdy zostanie uruchomiony tryb kreacji zastępczych i zostanie zwrócona odpowiedź kreacji zastępczej.

FallbackReason

Przyczyny użycia odpowiedzi rezerwowej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano przyczyny kreacji zastępczej.
SERVER_ERROR Podczas obliczania tras w wybranym trybie 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 zakończyć obliczeń z użyciem preferowanego trybu wyznaczania trasy, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym.

FallbackRoutingMode

Rzeczywisty tryb wyznaczania trasy użyty w odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Nie używane.
FALLBACK_TRAFFIC_UNAWARE Wskazuje, że do obliczenia odpowiedzi użyto TRAFFIC_UNAWARE trybu routingu.
FALLBACK_TRAFFIC_AWARE Wskazuje, że do obliczenia odpowiedzi użyto TRAFFIC_AWARE trybu routingu.

Lokalizacja

Zawiera lokalizację (punkt geograficzny i opcjonalny kierunek).

Pola
lat_lng

LatLng

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

Int32Value

Kierunek kompasu powiązany z kierunkiem ruchu. Ta wartość określa stronę drogi, z której ma nastąpić odbiór lub na której ma nastąpić wysadzenie. Wartości kierunku mogą wynosić od 0 do 360, gdzie 0 oznacza kierunek północny, 90 – wschodni itd. Możesz używać tego pola tylko w przypadku trybów podróży DRIVE i TWO_WHEELER.

Maneuver

Zestaw wartości określających działanie nawigacyjne, które należy wykonać w bieżącym kroku (np. skręć w lewo, wjedź na pas lub jedź prosto).

Wartości w polu enum
MANEUVER_UNSPECIFIED Nie używane.
TURN_SLIGHT_LEFT Skręć 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 Jedź prosto.
RAMP_LEFT Skieruj się na wjazd po lewej stronie.
RAMP_RIGHT Skieruj się na wjazd po prawej stronie.
MERGE Włącz się do ruchu.
FORK_LEFT Skręć w lewo.
FORK_RIGHT Skręć w prawo.
FERRY Popłyń promem.
FERRY_TRAIN Wsiądź do pociągu, który wjeżdża na prom.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
DEPART Początkowy manewr.
NAME_CHANGE Służy do wskazywania zmiany nazwy ulicy.
DESTINATION Służy do wskazywania przybycia do miejsca docelowego.
Pola
maneuver

Maneuver

Zawiera instrukcje nawigacyjne dotyczące bieżącego kroku (np. skręć w lewo, wjedź na pas lub jedź prosto). To pole określa, która ikona ma być wyświetlana.
instructions

string

Instrukcje dotyczące tego kroku.

Linia łamana

Zawiera zakodowaną linię łamaną.

Pola
Pole zbiorcze polyline_type. Zawiera typ linii łamanej. Domyślna wartość to encoded_polyline. polyline_type może mieć tylko jedną z tych wartości:
encoded_polyline

string

Ciąg znaków reprezentujący linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
geo_json_linestring

Struct

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

PolylineEncoding

Określa preferowany typ linii łamanej, który ma zostać zwrócony.

Wartości w polu enum
POLYLINE_ENCODING_UNSPECIFIED Nie określono preferencji dotyczących typu linii łamanej. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE Określa linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
GEO_JSON_LINESTRING Określa linię łamaną w formacie GeoJSON LineString.

PolylineQuality

Zestaw wartości określających jakość polilinii.

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości polilinii. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa linię łamaną wysokiej jakości, która składa się z większej liczby punktów niż OVERVIEW, co zwiększa rozmiar 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, gdy wyświetlasz podsumowanie trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie niż w przypadku opcji HIGH_QUALITY.

Trasa

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

Pola
legs[]

RouteLeg

Zbiór odcinków (segmentów ścieżki między punktami pośrednimi), które tworzą trasę. Każdy etap odpowiada podróży między 2 punktami via. Na przykład trasa bez punktów pośrednich ma tylko 1 odcinek. Trasa, która zawiera 1 punkt pośredni inny niż via, ma 2 odcinki. Trasa, która zawiera 1 punkt pośredni via, ma 1 odcinek. Kolejność odcinków odpowiada kolejności punktów pośrednich od origin do intermediates do destination.
distance_meters

int32

Długość trasy w metrach.
duration

Duration

czas potrzebny na pokonanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak static_duration. Jeśli ustawisz atrybut routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków na drodze.
static_duration

Duration

Czas podróży na trasie bez uwzględnienia warunków na drodze.
polyline

Polyline

Ogólna linia łamana trasy. Ta linia łamana jest połączoną linią łamaną wszystkich legs.
description

string

Opis trasy.
warnings[]

string

Tablica ostrzeżeń, które mają się wyświetlać podczas wyświetlania trasy.
viewport

Viewport

Ramka ograniczająca widoczny obszar linii łamanej.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.
optimized_intermediate_waypoint_index[]

int32

Jeśli parametr ComputeRoutesRequest.optimize_waypoint_order ma wartość true, to pole zawiera zoptymalizowaną kolejność pośrednich punktów trasy. W przeciwnym razie to pole jest puste. Załóżmy na przykład, że dane wejściowe to: Miejsce początkowe: Los Angeles; Miejsca pośrednie: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork, a zoptymalizowana kolejność pośrednich punktów trasy to: Phoenix, Dallas, Bangor. W takim przypadku to pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego pośredniego punktu trasy.

RouteLeg

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

Pola
distance_meters

int32

Odległość do pokonania na danym odcinku trasy w metrach.
duration

Duration

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

Duration

Czas trwania podróży na danym odcinku, obliczony bez uwzględnienia warunków na drodze.
polyline

Polyline

Ogólna linia łamana tego etapu. Obejmuje to linię łamaną każdego step.
start_location

Location

Lokalizacja początkowa tego odcinka. Może się on różnić od podanego origin. Jeśli na przykład podany 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 destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.
steps[]

RouteLegStep

Tablica kroków oznaczających segmenty w tym etapie. Każdy krok to jedna instrukcja nawigacji.
travel_advisory

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien być poinformowany, np. o możliwych ograniczeniach w strefie ruchu na odcinku trasy.

RouteLegStep

Zawiera segment RouteLeg. Krok odpowiada pojedynczej instrukcji nawigacyjnej. Trasa składa się z etapów.

Pola
distance_meters

int32

Odległość pokonana w tym kroku w metrach. W niektórych przypadkach to pole może nie mieć wartości.
static_duration

Duration

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

Polyline

Linia łamana 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 wiedzieć, np. o możliwym ograniczeniu strefy ruchu na etapie trasy.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien wiedzieć, np. o możliwym ograniczeniu strefy ruchu na etapie trasy.

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole nie jest obecnie wypełnione.

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien być poinformowany, np. o możliwych ograniczeniach w strefie ruchu na odcinku trasy.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na konkretnej RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się, że na trasie RouteLeg będą pobierane opłaty. Jeśli to pole jest ustawione, ale pole podrzędne estimated_price nie jest wypełnione, oczekujemy, że droga zawiera opłaty, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, na RouteLeg nie ma opłaty.
speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkiego czytania z informacjami o gęstości ruchu. Dotyczy preferencji dotyczących wyznaczania tras dla TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną RouteLeg bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedział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. Punkt docelowy

RouteMatrixElement

Zawiera informacje o trasie obliczonej dla pary punktów początkowego i końcowego w interfejsie ComputeRouteMatrix API. Ten protokół może być przesyłany strumieniowo do klienta.

Pola
origin_index

int32

Indeks źródła w żądaniu liczony od zera.
destination_index

int32

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

Status

Kod stanu błędu dla tego elementu.
condition

RouteMatrixElementCondition

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

int32

Długość trasy w metrach.
duration

Duration

czas potrzebny na pokonanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak static_duration. Jeśli ustawisz atrybut routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków na drodze.
static_duration

Duration

Czas podróży po trasie bez uwzględnienia warunków na drodze.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie. Na przykład informacje o ograniczeniach i opłatach za przejazd
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy z uwzględnieniem podanych preferencji dla danej pary punktów początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używany jest tryb rezerwowy, to pole zawiera szczegółowe informacje o odpowiedzi rezerwowej. W przeciwnym razie to pole nie jest ustawione.

RouteMatrixElementCondition

Stan zwracanej trasy.

Wartości w polu enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Używany tylko wtedy, gdy status elementu nie jest prawidłowy.
ROUTE_EXISTS Znaleziono trasę i w elemencie uzupełniono odpowiednie informacje.
ROUTE_NOT_FOUND Nie udało się znaleźć trasy. Pola zawierające informacje o trasie, takie jak distance_meters lub duration, nie zostaną wypełnione w elemencie.

RouteMatrixOrigin

Pojedynczy punkt początkowy w przypadku ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

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

RouteModifiers

Zawiera zestaw opcjonalnych warunków, które należy spełnić podczas obliczania tras.

Pola
avoid_tolls

bool

Jeśli ta wartość jest ustawiona na „true”, usługa unika dróg płatnych, gdy jest to uzasadnione, i preferuje trasy, które nie zawierają dróg płatnych. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_highways

bool

Jeśli ustawisz wartość „true”, usługa będzie unikać autostrad, gdy będzie to uzasadnione, i będzie preferować trasy bez autostrad. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_ferries

bool

Jeśli ustawisz wartość „true”, usługa będzie w miarę możliwości unikać promów, preferując trasy, które ich nie obejmują. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_indoor

bool

Jeśli ta opcja jest ustawiona na wartość „true”, nawigacja w pomieszczeniach jest unikana, gdy jest to możliwe. Preferowane są trasy, które nie zawierają nawigacji w pomieszczeniach. Dotyczy tylko trybu podróży WALK.
vehicle_info

VehicleInfo

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

TollPass

Zawiera informacje o winietach. Jeśli podano winiety, interfejs API spróbuje zwrócić cenę winiety. Jeśli nie podasz winiet, API uzna je za nieznane i spróbuje zwrócić cenę za przejazd bez winiety. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.

RouteObjective

Zawiera cel optymalizacji według ComputeCustomRoutes.

Pola
Pole zbiorcze objective. cel trasy. objective może mieć tylko jedną z tych wartości:
rate_card

RateCard

Cel RateCard.

RateCard

Zawiera RateCard cel trasy.

Pola
cost_per_minute

MonetaryCost

Opcjonalnie: Koszt za minutę.
cost_per_km

MonetaryCost

Opcjonalnie: Koszt za kilometr.
include_tolls

bool

Opcjonalnie: Określa, czy koszt opłat za przejazd autostradą ma być uwzględniony w koszcie całkowitym.

MonetaryCost

Zawiera koszt użyty w cenniku.

Pola
value

double

Wymagane. Wartość kosztu w walucie lokalnej wywnioskowana z żądania.

RouteTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien wiedzieć, np. o możliwych ograniczeniach strefy ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy spodziewamy się, że na trasie będą opłaty. Jeśli to pole jest ustawione, ale pole podrzędne estimated_price nie jest wypełnione, oczekujemy, że droga zawiera opłaty, ale nie znamy szacunkowej ceny. Jeśli to pole nie jest ustawione, oznacza to, że na trasie nie ma opłat.
speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkiego czytania z informacjami o gęstości ruchu. Dotyczy preferencji dotyczących wyznaczania tras dla TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną trasy bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:

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

RouteTravelMode

Zestaw wartości służący do określania ś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óżowanie rowerem.
WALK podróżować pieszo;
TWO_WHEELER Dwukołowy pojazd silnikowy. Na przykład motocykl. Pamiętaj, że różni się on od BICYCLE środka transportu, który obejmuje środki transportu napędzane siłą ludzkich mięśni.
TAXI

Podróż licencjonowaną taksówką, która w niektórych obszarach może korzystać z wyznaczonych pasów dla taksówek.

Tryb TAXI to funkcja eksperymentalna. Jeśli klient poprosi o trasę TAXI w mieście, w którym nie są dostępne dane o pasach dla taksówek, zostanie zwrócona trasa DRIVE.

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ędniania aktualnych warunków drogowych. Odpowiednie, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości zapewnia najmniejsze opóźnienie. Uwaga: w przypadku trybów RouteTravelMode DRIVE i TWO_WHEELER wybrana trasa i czas podróży są oparte na sieci dróg i średnich warunkach ruchu niezależnych od czasu, a nie na bieżących warunkach na drodze. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki danego żądania mogą się zmieniać z czasem ze względu na zmiany w sieci dróg, zaktualizowane średnie warunki na drodze i rozproszony charakter usługi. Wyniki mogą się też różnić w przypadku niemal identycznych tras w dowolnym momencie lub z dowolną częstotliwością.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem warunków na drogach. W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje są stosowane w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy z uwzględnieniem warunków na drodze, ale 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 ciągłym odcinku linii łamanej lub ścieżki. W przypadku ścieżki z punktami P_0, P_1, ..., P_N (indeksowanie od zera) SpeedReadingInterval definiuje przedział i opisuje ruch w nim za pomocą tych kategorii:

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału w linii łamanej. W pliku JSON, gdy indeks wynosi 0, pole wydaje się być nieuzupełnione.
end_polyline_point_index

int32

Indeks końcowy tego przedziału w linii łamanej. W JSON-ie, gdy indeks wynosi 0, pole wydaje się nie być wypełnione.
speed

Speed

Prędkość ruchu w tym przedziale.

Szybkość

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

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

TollInfo

Zawiera informacje o opłatach na urządzeniu Route lub RouteLeg.

Pola
estimated_price[]

Money

Wartość pieniężna opłat za przejazd dla odpowiedniego Route lub RouteLeg. Ta lista zawiera kwotę w każdej walucie, która ma być pobierana przez punkty poboru opłat. Zwykle ta lista zawiera tylko 1 element w przypadku tras z opłatami w jednej walucie. W przypadku podróży międzynarodowych lista może zawierać kilka pozycji, aby odzwierciedlać opłaty w różnych walutach.

TollPass

Lista obsługiwanych przez nas winiet z całego świata.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nie używane. Jeśli ta wartość zostanie użyta, żądanie się nie powiedzie.
AU_ETOLL_TAG Jeden z wielu dostawców winiet w Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Jeden z wielu dostawców winiet w Sydney. https://www.tollpay.com.au/
AU_LINKT Winieta obowiązująca 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 winiety w Brazylii, Więcej informacji znajdziesz na stronie https://www.autoexpreso.com
BR_CONECTCAR winiety w Brazylii, Więcej informacji znajdziesz na stronie https://conectcar.com.
BR_MOVE_MAIS winiety w Brazylii, Więcej informacji znajdziesz na stronie https://movemais.com.
BR_PASSA_RAPIDO winiety w Brazylii, Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/
BR_SEM_PARAR winiety w Brazylii, Więcej informacji znajdziesz na stronie https://www.semparar.com.br.
BR_TAGGY winiety w Brazylii, Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE winiety w Brazylii, Dodatkowe informacje znajdziesz na stronie https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD przejście graniczne między Kanadą a 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 między prowincją Ontario w Kanadzie a stanem Michigan w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne między prowincją Ontario w Kanadzie a stanem Michigan w Stanach Zjednoczonych.
CA_US_NEXUS_CARD przejście graniczne między Kanadą a Stanami Zjednoczonymi.
ID_E_TOLL Indonezja. E-karta wydawana przez wiele banków, która służy do płacenia za przejazdy autostradą. Wszystkie karty elektroniczne wydawane przez banki są obciążane w ten sam sposób, więc potrzebna jest tylko jedna wartość wyliczeniowa. np.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 obowiązku rejestracji w stanie HP.
JP_ETC Japonia ETC. Elektroniczny system bezprzewodowy do pobierania opłat za przejazd. https://www.go-etc.jp/
JP_ETC2 ETC2.0 w Japonii. Nowa wersja ETC z dodatkowym rabatem i dwukierunkową komunikacją 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 Firma zajmująca się winietami w Meksyku. Jedna z wielu działających w Meksyku. Więcej informacji znajdziesz na stronie https://www.televia.com.mx.
MX_TELEVIA Firma zajmująca się winietami w Meksyku. Jedna z wielu firm działających 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 AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że kierowca ma dowolny karnet FasTrak oprócz naklejki Clean Air Vehicle (CAV) wydanej przez DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Wycofano, ponieważ ten typ karty już nie istnieje.
US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS NY, USA.
US_NY_EZPASSNY NY, USA.
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

Jednostki

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

Wartości w polu enum
UNITS_UNSPECIFIED Nie określono jednostek miary. Domyślnie jest to jednostka miary wywnioskowana z żądania.
METRIC Jednostki miary w systemie metrycznym.
IMPERIAL Jednostki miary w systemie imperialnym (angielskim).

VehicleEmissionType

Zestaw wartości opisujących typ emisji pojazdu. Dotyczy tylko trybu podróży SAMOCHODEM.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Domyślna wartość to GASOLINE.
GASOLINE Pojazd zasilany benzyną.
ELECTRIC Pojazd zasilany energią elektryczną.
HYBRID Pojazd hybrydowy (np. benzynowy i elektryczny).

VehicleInfo

Zawiera informacje o pojeździe, np. typ emisji.

Pola
emission_type

VehicleEmissionType

Opisuje typ emisji pojazdu. Dotyczy tylko DRIVE RouteTravelMode.

Punkt pośredni

Zawiera punkt na trasie. Punkty pośrednie wyznaczają początek i koniec trasy oraz obejmują przystanki pośrednie na trasie.

Pola
via

bool

Oznacza ten punkt na trasie jako kamień milowy, a nie miejsce docelowe. W przypadku każdego punktu pośredniego w żądaniu, który nie jest punktem przelotowym, odpowiedź dodaje wpis do tablicy legs, aby podać szczegóły postojów na danym etapie podróży. Ustaw tę wartość na „true”, jeśli chcesz, aby trasa przebiegała przez ten punkt pośredni bez zatrzymywania się. Punkty pośrednie nie powodują dodania wpisu do tablicy legs, ale kierują podróż przez ten punkt. Tę wartość można ustawić tylko w przypadku pośrednich punktów trasy. Jeśli ustawisz to pole w przypadku punktów końcowych, żądanie zakończy się niepowodzeniem. Jeśli zasada ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, tego pola nie można ustawić na wartość Prawda. W przeciwnym razie żądanie zakończy się niepowodzeniem.
vehicle_stopover

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, które mają się w nim zatrzymać w celu odbioru lub wysadzenia pasażerów. Jeśli ustawisz tę wartość, obliczona trasa nie będzie obejmować punktów pośrednich innych niż via na drogach, które nie nadają się do odbioru i wysadzania pasażerów. Ta opcja działa tylko w przypadku trybów podróży DRIVE i TWO_WHEELER oraz gdy location_type ma wartość location.
side_of_road

bool

Wskazuje, że lokalizacja tego punktu na trasie ma preferencję, aby pojazd zatrzymał się po określonej stronie drogi. Gdy ustawisz tę wartość, trasa będzie przebiegać przez daną lokalizację, aby pojazd mógł zatrzymać się po stronie drogi, w kierunku której jest ona przesunięta od środka drogi. Ta opcja działa tylko w przypadku trybów podróży „DRIVE” i „TWO_WHEELER”.
Pole zbiorcze 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 opcjonalnego kierunku.
place_id

string

Identyfikator miejsca POI powiązany z punktem pośrednim.