Package google.maps.routes.v1

Indeks

RoutesPreferred

Interfejs Routes Preferred API.

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. Możesz podać maskę pola odpowiedzi, używając parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (patrz 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 pól wszystkich dostępnych pól (do ręcznej kontroli): 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.
  • Wybranie tylko tych pól, których potrzebujesz w produkcyjnym zadaniu, zapewnia stabilną wartość opóźnienia. 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, może to spowodować pogorszenie wydajności, ponieważ każde nowe pole, które dodamy, będzie 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.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Przeszukuje listę miejsc wylotu i przylotu, a następnie zwraca strumień zawierający informacje o trasie dla każdej kombinacji miejsca wyjazdu i celu podróży.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Możesz podać maskę pola odpowiedzi, używając parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (patrz 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 pola wszystkich dostępnych pól (do sprawdzenia ręcznego): X-Goog-FieldMask: *
  • Maska pola z czasami trwania trasy, odległościami, stanem i warunkami elementu oraz indeksami elementów (przykładowa konfiguracja produkcyjna): 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.
  • Wybranie tylko tych pól, których potrzebujesz w produkcyjnym zadaniu, zapewnia stabilną wartość opóźnienia. 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, może to spowodować pogorszenie wydajności, ponieważ każde nowe pole, które dodamy, będzie 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.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca główną trasę wraz z opcjonalnymi trasami alternatywnymi, biorąc pod uwagę zestaw punktów docelowych i 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ść to lista ścieżek pól rozdzielonych przecinkami. Zapoznaj się ze szczegółową dokumentacją dotyczącą 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 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 wyniki z krótszym czasem oczekiwania.
  • Wybranie tylko tych pól, których potrzebujesz w produkcyjnym zadaniu, zapewnia stabilną wartość opóźnienia. 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, może to spowodować pogorszenie wydajności, ponieważ każde nowe pole, które dodamy, będzie 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.

ComputeCustomRoutesRequest

Komunikat z prośbą o obliczenie tras niestandardowych.

Pola
origin

Waypoint

Wymagane. Punkt początkowy.
destination

Waypoint

Wymagane. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie: Zestaw punktów na trasie (z wyłączeniem punktów końcowych) do zatrzymania się na lub przejechania. 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ć wybranego ustawienia routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
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. Cel dotyczący trasy, pod kątem którego ma zostać przeprowadzona optymalizacja.
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ługiwane języki. 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świetlania. Obejmuje to pole instruction w NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary używane w przypadku trasy, etapu, odległości kroku i czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki są ustalane na podstawie lokalizacji żądania.

ComputeCustomRoutesResponse

Komunikat odpowiedzi ComputeCustomRoutes.

Pola
routes[]

CustomRoute

„Najlepsze” trasy dla podanego celu trasy.
fastest_route

CustomRoute

Najszybsza trasa referencyjna.
shortest_route

CustomRoute

Najkrótsza trasa referencyjna.
fallback_info

FallbackInfo

Informacje zastępcze dla tras niestandardowych.

FallbackInfo

Zawiera informacje o zastępczych danych dla ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 rodzaje działań 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 został uruchomiony sposób postępowania w przypadku awarii, cel może być inny niż cel trasy podany 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 poprosi o usługę RateCard i ustawi opcję include_tolls na „true”, a Google nie ma danych o cenie za przejazd autostradą na danej trasie, interfejs API wróci do wartości domyślnej RateCard bez uwzględniania ceny za przejazd autostradą.

ComputeRouteMatrixRequest

Komunikat z prośbą o obliczenie macierzy tras

Pola
origins[]

RouteMatrixOrigin

Wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. W odniesieniu do mocy zbioru miejsc wylotu i przeznaczenia obowiązuje kilka ograniczeń dotyczących rozmiaru:

  • Liczba elementów (początki × miejsca docelowe) nie może przekraczać 625 w żadnym przypadku.
  • Jeśli routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL, liczba elementów (źródła × miejsca docelowe) nie może przekraczać 100.
  • Liczba punktów pośrednich (źródła i miejsca docelowe) podana 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 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. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
departure_time

Timestamp

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

ComputeRoutesRequest

ComputeRoutes prośba o spotkanie.

Pola
origin

Waypoint

Wymagane. Punkt początkowy.
destination

Waypoint

Wymagane. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie: Zestaw punktów na trasie (z wyłączeniem punktów końcowych) do zatrzymania się na lub przejechania. 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ć wybranych preferencji routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, 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, na przykład „en-US” 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ługiwane języki. 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świetlania. 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 zostaną wywnioskowane 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 któryś z punktów pośrednich jest punktem pośrednim, żądanie się nie powiedzie. 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 opcja optimize_waypoint_order ma wartość Fałsz, parametr ComputeRoutesResponse.optimized_intermediate_waypoint_index jest pusty.

ComputeRoutesResponse

Oblicza trasy dla wiadomości zwrotnej.

Pola
routes[]

Route

Jeśli podasz parametr compute_alternatives_routes, zawiera tablicę obliczonych tras (maksymalnie 3), a jeśli nie, zawiera tylko jedną trasę. 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

Zakodowany w internecie token trasy zakodowany w base64, który można przekazać do NavSDK. Umożliwia on zrekonstruowanie trasy podczas nawigacji, a w przypadku zmiany trasy uwzględnia pierwotną intencję wywoływania funkcji RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczysty blok danych.

FallbackInfo

Informacje o tym, jak i dlaczego użyto wyniku zastępczego. Jeśli to pole jest ustawione, oznacza to, że serwer użył innego trybu kierowania niż preferowany jako domyślny.

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 wtedy, gdy zostanie wywołany tryb zastępczy i zwrócona zostanie odpowiedź zastępcza.

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ń w preferowanym trybie wyznaczania trasy, ale udało się uzyskać wynik obliczony w trybie alternatywnym.

FallbackRoutingMode

Rzeczywisty tryb routingu używany w przypadku zwróconej odpowiedzi zastępczej.

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

Lokalizacja

Zawiera lokalizację (punkt geograficzny i opcjonalnie nagłówek).

Pola
lat_lng

LatLng

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

Int32Value

Kierunek kompasu związany z kierunkiem ruchu. Ta wartość określa stronę drogi, po której ma nastąpić odbiór i zwrot. Wartości kierunków mogą się wahać od 0 do 360, gdzie 0 to kierunek na północ, 90 to kierunek na wschód itd. Tego pola możesz użyć tylko w przypadku środków transportu DRIVE i TWO_WHEELER.

Skręt

Zestaw wartości określający działanie nawigacyjne, które należy wykonać w bieżącym kroku (np. skręć w lewo, wjedź na drogę główną lub jedź 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 Obróć się lekko w prawo.
TURN_SHARP_RIGHT Skręć ostro w prawo.
UTURN_RIGHT wykonać skręt w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Jedź prosto.
RAMP_LEFT Wejdź na lewą rampę.
RAMP_RIGHT Skręć w w prawo.
MERGE Włącz się do ruchu.
FORK_LEFT Skręć w lewy rozwidlenie.
FORK_RIGHT Skręć w prawy widelec.
FERRY Przeprawa promowa.
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

Zawiera instrukcje nawigacyjne dotyczące bieżącego kroku (np. skręć w lewo, włącz się do głównej drogi 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 sumy polyline_type. Zawiera typ linii łamany. 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 wielokąt w formacie GeoJSON LineString.

PolylineEncoding

Określa preferowany typ wielokąta 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

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

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości ścieżki wielopunktowej. 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. W przypadku tej opcji czas oczekiwania na żądanie jest krótszy niż w przypadku opcji 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 etap odpowiada przejazdowi między dwoma punktami pośrednimi, które nie są punktami pośrednimi typu via. Na przykład trasa bez pośrednich punktów kontrolnych ma tylko 1 etap. Trasa, która zawiera co najmniej 1 punkt pośredni inny niż via, ma 2 części. Trasa obejmująca 1 pośredni punkt na trasie 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 routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak 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.
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 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 ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, to pole zawiera zoptymalizowaną kolejność punktów pośrednich. W przeciwnym razie to pole jest puste. Załóżmy na przykład, że dane wejściowe to: punkt początkowy: Los Angeles; punkty pośrednie: Dallas, Bangor, Phoenix; punkt docelowy: Nowy Jork. Zwróć uwagę, że zoptymalizowana kolejność punktów pośrednich to: Phoenix, Dallas, Bangor. To 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ść pokonanego odcinka trasy w metrach.
duration

Duration

Czas potrzebny na poruszanie się po nodze. Jeśli wartość route_preference to TRAFFIC_UNAWARE, jest ona taka sama jak wartość static_duration. Jeśli wartość route_preference to TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, jest ona obliczana z uwzględnieniem warunków ruchu.
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 linie pętli każdego elementu step.
start_location

Location

Lokalizacja początkowa tego odcinka. 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 punkt 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. Krok odpowiada pojedynczej instrukcji nawigacji. Odcinki trasy składają się z etapów.

Pola
distance_meters

int32

Odległość do pokonania na tym etapie w metrach. W niektórych okolicznościach to pole może nie zawierać 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

Miejsce zakończenia 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

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

Pola
toll_info

TollInfo

Zawiera informacje o opłatach za przejazd na określonym RouteLeg. To pole jest wypełnione tylko wtedy, gdy przewidujemy, że na: RouteLeg będą naliczane opłaty. Jeśli to pole jest ustawione, ale podpole estimated_price jest puste, zakładamy, że droga zawiera opłaty drogowe, ale nie znamy ich przybliżonej ceny. Jeśli to pole nie istnieje, RouteLeg nie pobiera opłat.
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

RouteMatrixDestination

Pojedyncze miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Punkt docelowy

RouteMatrixElement

Obejmuje informacje o trasie obliczone dla pary punktu początkowego i docelowego w interfejsie ComputeRouteMatrix API. To proto może być przesyłane strumieniowo do klienta.

Pola
origin_index

int32

Źródło w żądaniu – indeks od 0.
destination_index

int32

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

Status

Kod stanu błędu tego elementu.
condition

RouteMatrixElementCondition

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

int32

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

Duration

Czas potrzebny na przejechanie trasy. Jeśli ustawisz routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak 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 może obliczyć trasy z uwzględnieniem podanych preferencji w przypadku danego połączenia między punktem początkowym a docelowym, 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 Trasa została znaleziona, a odpowiednie informacje zostały wypełnione w przypadku tego 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 ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

Opcjonalnie: Modyfikatory każdej trasy, która 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 zasada ma wartość Prawda, w miarę możliwości omija drogi płatne, traktując priorytetowo trasy, które nie zawierają dróg płatnych. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_highways

bool

Jeśli ustawisz wartość prawda, aplikacja będzie unikać autostrad, jeśli to możliwe, preferując trasy bez autostrad. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.
avoid_ferries

bool

Jeśli ta opcja jest ustawiona na wartość Prawda, w uzasadnionych przypadkach omija promy, preferując trasy bez promów. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_indoor

bool

Jeśli ta opcja jest ustawiona na wartość prawda, robot uniknie nawigacji w pomieszczeniach, jeśli to możliwe, i preferuje trasy nieobejmujące nawigacji w pomieszczeniach. 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 trybów podróży DRIVE i TWO_WHEELER.

RouteObjective

Zawiera cel, pod kątem którego ma być przeprowadzana optymalizacja (ComputeCustomRoutes).

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

RateCard

Cel „RateCard”.

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 karcie stawek.

Pola
value

double

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

RouteTravelAdvisory

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 na trasie. To pole jest wypełniane tylko wtedy, gdy przewidujemy, że na Trasie występują opłaty drogowe. 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 szybkości czytania określające gęstość 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 przedziału czasowego jest taki sam jak punkt końcowy poprzedniego przedziału czasowego.

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żących do określania środka transportu.

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

Podróżowanie taksówką z licencja, która może umożliwiać poruszanie się po wyznaczonych pasach dla taksówek w niektórych obszarach.

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

RoutingPreference

Zbiór wartości określających czynniki, które należy uwzględnić przy obliczaniu trasy.

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślnie TRAFFIC_AWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania bieżących warunków na drodze. Odpowiedni, gdy warunki ruchu nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości powoduje najniższe 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. Wyniki mogą się też różnić w przypadku prawie identycznych tras w dowolnym czasie lub 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 gęstości ruchu na ciągł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 linii łamanej. W pliku JSON, gdy indeks ma wartość 0, pole wydaje się być puste.
end_polyline_point_index

int32

Indeks końcowy tego przedziału w wielokącie. W pliku JSON, gdy indeks ma wartość 0, pole wydaje się być 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 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 kwotę pieniężną w każdej walucie, która ma być pobierana przez stacje poboru opłat. Zazwyczaj zawiera tylko 1 element dla tras z opłatami drogowymi 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 ta wartość zostanie użyta, żądanie się nie powiedzie.
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 wpłat za przejazd w Sydney. https://www.tollpay.com.au/
AU_LINKT Winieta na terenie całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Winieta argentyńska. 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 brazylijska. Więcej informacji znajdziesz na stronie https://conectcar.com.
BR_MOVE_MAIS winieta w Brazylii. Więcej informacji znajdziesz na stronie https://movemais.com.
BR_PASSA_RAPIDO winieta w Brazylii. Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR winieta w Brazylii. Więcej informacji znajdziesz na stronie https://www.semparar.com.br.
BR_TAGGY Winieta brazylijska. Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE Winieta brazylijska. 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 Kanady do przejścia granicznego ze 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. E-karta wydawana przez wielu banków, używana do płacenia za opłaty drogowe. Wszystkie e-karty przez banki są obciążane w ten sam sposób, więc potrzebna jest tylko jedna wartość z enumeracji. 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 obowiązku podatkowego w przypadku tablic rejestracyjnych stanów.
JP_ETC Japonia ETC. Bezprzewodowy system elektroniczny do pobierania opłat za przejazd autostradą. https://www.go-etc.jp/
JP_ETC2 Japonia ETC2.0. Nowa wersja ETC z dodatkowymi rabatami i dwukierunkową komunikacją między urządzeniami w pojazdach i antenach 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ńska firma zarządzająca systemem opłat drogowych. Jedna z wielu placówek działających w mieście Meksyk. Więcej informacji znajdziesz na https://www.televia.com.mx.
MX_TELEVIA Meksykańska firma zarządzająca systemem opłat drogowych. Jedna z wielu placówek w Meksyku. https://www.televia.com.mx
MX_VIAPASS Winieta meksykańska. Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, Stany Zjednoczone
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, Stany Zjednoczone.
US_CA_FASTRAK Kanada, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że kierowca ma kartę FastTrak oprócz naklejki DMV na pojazdy przyjazne środowisku. 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 KS, 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, Stany Zjednoczone.
US_MI_BCPASS MI, Stany Zjednoczone.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Stany Zjednoczone.
US_MI_IQ_PROX_CARD

MI, Stany Zjednoczone. 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 NC, Stany Zjednoczone
US_NC_QUICK_PASS NC, Stany Zjednoczone
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, Stany Zjednoczone.
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 Stany Zjednoczone, stan Waszyngton.
US_WA_GOOD_TO_GO Stany Zjednoczone, stan Waszyngton.
US_WV_EZPASSWV WV, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Stany Zjednoczone.
US_WV_MOV_PASS Wirginia Zachodnia, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stany Zjednoczone.

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. Domyślnie jest to jednostka miary określona na podstawie żądania.
METRIC Jednostki metryczne.
IMPERIAL jednostki miary imperialne (angielskie).

VehicleEmissionType

Zestaw wartości opisujących typ emisji pojazdu. Dotyczy tylko trybu jazdy.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie wybrano typu emisji. Domyślnie GASOLINE.
GASOLINE Pojazd benzynowy lub benzynowy.
ELECTRIC Pojazd elektryczny.
HYBRID Pojazd hybrydowy (np. benzyna + elektryczność).

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

Zawiera punkt na trasie. 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 w żądaniu odpowiedź dołącza wpis do tablicy legs, aby podać szczegóły dotyczące przystanków na tym 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 wyznaczają 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 to pole zostanie ustawione na punkty pośrednie terminala. Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, to pole nie może mieć wartości Prawda. W przeciwnym razie żądanie się nie powiedzie.
vehicle_stopover

bool

Wskazuje, że punkt drogi jest przeznaczony do zatrzymywania się pojazdów, gdzie zamierzają one zabrać lub wysadzić pasażerów. Po ustawieniu tej wartości obliczona trasa nie będzie zawierać punktów drogi o wartości innej niż via na drogach, które nie nadają się do zabierania 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 drogowego ma być preferowaną lokalizacją dla zatrzymania pojazdu po określonej stronie drogi. Po ustawieniu tej wartości trasa będzie przebiegać przez lokalizację, aby pojazd mógł się zatrzymać po tej stronie drogi, która jest zwrócona w stronę tej lokalizacji. Ta opcja działa tylko w przypadku trybów podróży „DRIVE” i „TWO_WHEELER”.
Pole unii 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 nagłówka.
place_id

string

Identyfikator miejsca docelowego powiązany z punktem drogi.