Package google.maps.routes.v1

Indeks

RoutesPreferred

Routes Preferred API.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Biorąc pod uwagę zestaw końcowych i pośrednich punktów na trasie oraz cel trasy, oblicza najlepszą trasę dla tej trasy. Zwraca także najszybszą trasę i najkrótszą trasę jako trasy referencyjne.

UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać za pomocą parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL). Wartość jest rozdzielaną przecinkami listą ś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 kontroli ręcznej): X-Goog-FieldMask: *
  • Maska pola z odległościami, czasami trwania, tokenem i informacjami o opłatach: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

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

  • Zaznaczenie tylko tych pól, które są Ci potrzebne, pomaga naszemu serwerowi skrócić cykle obliczeniowe, a tym samym zwrócić Ci wynik z mniejszym czasem oczekiwania.
  • Wybór tylko tych pól, których potrzebujesz w zadaniu produkcyjnym, zapewnia stabilny czas oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi i te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde nowe pole, które dodajemy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko tych pól, które są Ci potrzebne, spowoduje zmniejszenie rozmiaru odpowiedzi i 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)

Pobiera listę miejsc początkowych i docelowych, a następnie zwraca strumień zawierający informacje o trasie dla każdej kombinacji punktu początkowego i docelowego.

UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać za pomocą parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL). Wartość jest rozdzielaną przecinkami listą ś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 kontroli ręcznej): X-Goog-FieldMask: *
  • Maska pola z czasami trwania trasy, odległościami, stanem elementu, stanem i indeksami elementów (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Ważne jest, aby w masce pola podać status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyglądały na prawidłowe. Google odradza korzystanie z maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Zaznaczenie tylko tych pól, które są Ci potrzebne, pomaga naszemu serwerowi skrócić cykle obliczeniowe, a tym samym zwrócić Ci wynik z mniejszym czasem oczekiwania.
  • Wybór tylko tych pól, których potrzebujesz w zadaniu produkcyjnym, zapewnia stabilny czas oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi i te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde nowe pole, które dodajemy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko tych pól, które są Ci potrzebne, spowoduje zmniejszenie rozmiaru odpowiedzi i 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 trasę podstawową wraz z opcjonalnymi trasami alternatywnymi z uwzględnieniem zestawu terminali i pośrednich punktów na trasie.

UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać za pomocą parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresu URL). Wartość jest rozdzielaną przecinkami listą ś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 kontroli ręcznej): X-Goog-FieldMask: *
  • Maska pola z czasem trwania, odległością i linią łamaną na poziomie trasy (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Odradzamy stosowanie maski pola odpowiedzi z symbolem wieloznacznym (*) i określanie maski pola na najwyższym poziomie (routes), ponieważ:

  • Zaznaczenie tylko tych pól, które są Ci potrzebne, pomaga naszemu serwerowi skrócić cykle obliczeniowe, a tym samym zwrócić Ci wynik z mniejszym czasem oczekiwania.
  • Wybór tylko tych pól, których potrzebujesz w zadaniu produkcyjnym, zapewnia stabilny czas oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi i te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde nowe pole, które dodajemy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko tych pól, które są Ci potrzebne, spowoduje zmniejszenie rozmiaru odpowiedzi i 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 żądania ComputeCustomRoutes.

Pola
origin

Waypoint

To pole jest wymagane. Punkt na trasie początkowy.

destination

Waypoint

To pole jest wymagane. Docelowy punkt na trasie.

intermediates[]

Waypoint

Opcjonalnie. Zestaw punktów pośrednich na trasie (bez punktów końcowych) do zatrzymania się lub przejechania. Obsługiwanych jest do 25 pośrednich punktów pośrednich.

travel_mode

RouteTravelMode

Opcjonalnie. Określa środek transportu. Obecnie obsługiwany jest tylko DYSK.

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 skutkuje błędem lub bardzo długim czasem oczekiwania, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie powiedzie się.

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

Opcjonalnie. Określa preferowane kodowanie linii łamanej.

departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się.

route_modifiers

RouteModifiers

Opcjonalnie. Zestaw warunków, które mają wpływ na sposób obliczania tras.

route_objective

RouteObjective

To pole jest wymagane. Cel trasy, pod którego kątem należy optymalizować kampanię.

language_code

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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 będzie określany na podstawie lokalizacji żądania trasy.

units

Units

Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Dotyczy to też pola instruction w NavigationInstruction. Nie ma wpływu na jednostki miary używane dla trasy, kroku, odległości kroków ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki będą ustalane na podstawie lokalizacji żądania.

ComputeCustomRoutesResponse

Komunikat 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 zastępcze dla tras niestandardowych.

FallbackInfo

Obejmuje informacje o zastępstwie ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 typy wartości zastępczych:

  1. Jeśli nie może obliczyć trasy przy użyciu parametru routing_preference, o który prosi klient, przełączy się na inny tryb routingu. W tym przypadku do przekazania informacji o użytym trybie awaryjnego oraz o przyczynie awaryjnego sposobu korzystania z usługi fallback_routing_mode i Routing_mode_fallback_reason są używane informacje o użyciu zastępczego trybu routingu.

  2. Jeśli nie może obliczyć „najlepszej” trasy dla celu trasy wyznaczonego przez klienta, może zostać użyta inna trasa. Zmienna fallback_route_objective służy do przekazywania celu trasy zastępczej.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu używany w odpowiedzi. Jeśli tak, tryb może się różnić od preferencji routingu określonych w pierwotnym żądaniu klienta.

routing_mode_reason

FallbackReason

Przyczyna użycia odpowiedzi zastępczej zamiast pierwotnej odpowiedzi. To pole jest wypełniane tylko po uruchomieniu trybu awaryjnego i zwróceniu odpowiedzi zastępczej.

route_objective

FallbackRouteObjective

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

FallbackRouteObjective

Cel RouteTarget używany w odpowiedzi.

Wartości w polu enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Cel trasy zastępczej nieokreślony.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Jeśli klient wysyła żądanie RateCard i ustawia ustawienie include_tolls na true, a Google nie ma informacji o cenach opłat za daną trasę, interfejs API przełącza się na kartę RateCard bez uwzględniania wysokości opłat za przejazd.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

To pole jest wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. W przypadku mocy zbioru miejsc wylotu i przylotu obowiązują pewne ograniczenia dotyczące rozmiaru:

  • Liczba elementów (źródła × miejsca docelowe) nie może być w każdym przypadku większa niż 625.
  • Liczba elementów (źródła × miejsca docelowe) nie może być większa niż 100, jeśli routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL.
  • Liczba punktów na trasie (miejsca początkowe + miejsca docelowe) określone jako place_id nie może być większa niż 50.
destinations[]

RouteMatrixDestination

To pole jest 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 ustawienia routingu spowodują błąd lub bardzo długi czas oczekiwania, zostanie zwrócony błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie powiedzie się.

departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się.

ComputeRoutesRequest

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

To pole jest wymagane. Punkt na trasie początkowy.

destination

Waypoint

To pole jest wymagane. Docelowy punkt na trasie.

intermediates[]

Waypoint

Opcjonalnie. Zestaw punktów pośrednich na trasie (bez punktów końcowych) do zatrzymania się lub przejechania. Obsługiwanych jest do 25 pośrednich 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 skutkuje błędem lub bardzo długim czasem oczekiwania, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie powiedzie się.

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

Opcjonalnie. Określa preferowane kodowanie linii łamanej.

departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się.

compute_alternative_routes

bool

Określa, czy oprócz trasy mają być obliczane trasy alternatywne.

route_modifiers

RouteModifiers

Opcjonalnie. Zestaw warunków, które mają wpływ na sposób obliczania tras.

language_code

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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 będzie określany na podstawie lokalizacji żądania trasy.

units

Units

Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Dotyczy to też pola instruction w NavigationInstruction. Nie ma wpływu na jednostki miary używane dla trasy, kroku, odległości kroków ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki będą ustalane na podstawie lokalizacji żądania.

optimize_waypoint_order

bool

Jeśli parametr OptimizeWaypointOrder ma wartość true (prawda), podejmowana jest próba zmiany kolejności określonych pośrednich punktów pośrednich w celu zminimalizowania ogólnego kosztu trasy. Jeśli którykolwiek z pośrednich punktów pośrednich prowadzi przez punkt pośredni, żądanie kończy się niepowodzeniem. Użyj ComputeRoutesResponse.Routes.Optimized_and_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku X-Goog-FieldMask nie zażądano adresu tras.Optimized_ wszelkich pośrednich_waypoint_index, żądanie nie powiedzie się. Jeśli parametr OptimizeWaypointOrder ma wartość false (fałsz), komponent ComputeRoutesResponse.Optimized_directed_waypoint_index jest pusty.

ComputeRoutesResponse

ComputeRoutes zwraca komunikat z odpowiedzią.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), gdy podasz compute_alternatives_routes, a jeśli nie, zawiera tylko 1 trasę. Jeśli ta tablica zawiera wiele wpisów, pierwsza z nich jest najbardziej zalecaną trasą. Jeśli tablica jest pusta, oznacza to, że nie udało się znaleźć żadnej trasy.

fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy na podstawie wszystkich ustawień wejściowych, może skorzystać z innego sposobu obliczania. W przypadku użycia trybu awaryjnego to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.

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 pakietu NavSDK w celu zrekonstruowania trasy niestandardowej na potrzeby nawigacji zakręt po zakręcie.

Pola
route

Route

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

token

string

Bezpieczny w internecie token trasy zakodowany w standardzie base64, który można przekazać do pakietu NavSDK. Umożliwia on odtworzenie trasy podczas nawigacji, a w przypadku zmiany trasy może uwzględniać pierwotną intencję, gdy wywoływane jest wywołanie RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob.

FallbackInfo

Informacje o sposobie i sposobie wykorzystania wyniku kreacji zastępczej. Jeśli to pole jest skonfigurowane, oznacza to, że serwer użył jako ustawienia awaryjnego trybu routingu innego niż preferowany.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu używany w odpowiedzi. Jeśli tak, tryb może się różnić od preferencji routingu określonych w pierwotnym żądaniu klienta.

reason

FallbackReason

Przyczyna użycia odpowiedzi zastępczej zamiast pierwotnej odpowiedzi. To pole jest wypełniane tylko po uruchomieniu trybu awaryjnego i zwróceniu odpowiedzi zastępczej.

FallbackReason

Powody korzystania z odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano przyczyny awaryjnej.
SERVER_ERROR Podczas obliczania tras przy użyciu preferowanego trybu routingu wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony w innym trybie.
LATENCY_EXCEEDED Nie udało nam się ukończyć obliczeń z wykorzystaniem preferowanego trybu trasy na czas, ale udało nam się zwrócić wynik obliczony przez tryb alternatywny.

FallbackRoutingMode

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

Wartości w polu enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Niewykorzystywany.
FALLBACK_TRAFFIC_UNAWARE Wskazuje, że do obliczenia odpowiedzi użyto trybu routingu „TRAFFIC_UNAWARE”.
FALLBACK_TRAFFIC_AWARE Wskazuje, że do obliczenia odpowiedzi użyto trybu 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

Kierunek kompasu powiązany z kierunkiem ruchu. Ta wartość służy do określenia strony drogi na potrzeby odbioru i zwrotu. Wartości nagłówka mogą przyjmować wartość z zakresu od 0 do 360, gdzie 0 oznacza kierunek północny, 90 wskazuje kierunek na wschód itd. Tego pola można używać tylko w przypadku trybów podróży DRIVE i TWO_WHEELER.

Ruch

Zestaw wartości określających działanie nawigacyjne w danym kroku (np. skręt w lewo, scalanie, prosto itd.).

Wartości w polu enum
MANEUVER_UNSPECIFIED Niewykorzystywany.
TURN_SLIGHT_LEFT Obróć się lekko w lewo.
TURN_SHARP_LEFT Ostro w lewo.
UTURN_LEFT Zawróć w lewo.
TURN_LEFT Obróć się w lewo.
TURN_SLIGHT_RIGHT Obróć się lekko w prawo.
TURN_SHARP_RIGHT Ostro w prawo.
UTURN_RIGHT Zawróć w prawo.
TURN_RIGHT Obróć się w prawo.
STRAIGHT Idź prosto.
RAMP_LEFT Skorzystaj z lewej pochylni.
RAMP_RIGHT Skorzystaj z właściwego zjazdu.
MERGE Scal w ruch.
FORK_LEFT Otwórz lewy rozwidlenie.
FORK_RIGHT Trzymaj właściwy rozwidlenie.
FERRY Wybierz prom.
FERRY_TRAIN Wybierz pociąg prowadzący do promu.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
Pola
maneuver

Maneuver

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

instructions

string

Instrukcje poruszania się po tym kroku.

Linia łamana

Obejmuje zakodowaną linię łamaną.

Pola
Pole sumy polyline_type. Obejmuje typ linii łamanej. Wartość domyślna to encoded_polyline. polyline_type może mieć tylko jedną z tych wartości:
encoded_polyline

string

kodowanie ciągu łamanego za pomocą algorytmu kodowania wiersza łamanego,

geo_json_linestring

Struct

Wskazuje linię łamaną w formacie linii GeoJSON

PolylineEncoding

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

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

PolylineQuality

Zestaw wartości określających jakość linii łamanej.

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości linii łamanych. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa wysokiej jakości linię łamaną, która składa się z większej liczby punktów niż OVERVIEW, ale kosztem większego rozmiaru odpowiedzi. Użyj tej wartości, gdy potrzebujesz większej precyzji.
OVERVIEW Określa ogólną linię łamaną, która składa się z małej liczby punktów. Użyj tej wartości przy wyświetlaniu opisu trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie w porównaniu do opcji HIGH_QUALITY.

Trasa

Obejmuje trasę, która składa się z szeregu połączonych fragmentów drogi łączących początek, koniec i pośrednie punkty na trasie.

Pola
legs[]

RouteLeg

Zbiór odcinków (odcinków ścieżki między punktami na trasie) tworzących trasę. Każdy etap odpowiada podróży między dwoma punktami Waypoint niebędącymi via. Na przykład trasa bez pośrednich punktów pośrednich ma tylko jeden etap. Trasa obejmująca jeden pośredni punkt pośredni inny niż via ma dwa etapy. Trasa zawierająca jeden pośredni punkt pośredni via ma jeden etap. Kolejność etapów jest zgodna z kolejnością punktów Waypoints od origin do intermediates do destination.

distance_meters

int32

Długość trasy w metrach.

duration

Duration

Czas potrzebny na nawigację po trasie. Jeśli ustawisz routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak static_duration. Jeśli ustawisz routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, wartość ta jest obliczana z uwzględnieniem warunków ruchu.

static_duration

Duration

Czas podróży po trasie bez uwzględniania warunków drogowych.

polyline

Polyline

Ogólna linia łamana trasy. Ta linia łamana będzie połączona linią łamaną wszystkich elementów legs.

description

string

Opis trasy.

warnings[]

string

Tablica ostrzeżeń do wyświetlenia 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ść pośrednich punktów na trasie. W przeciwnym razie pole jest puste. Załóżmy np., że dane wejściowe to: Origin: LA; średniozaawansowany: Dallas, Bangor, Phoenix; miejsce docelowe: Nowy Jork; a zoptymalizowana kolejność pośrednich punktów pośrednich to: Phoenix, Dallas, Bangor. Następnie pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 dla pierwszego pośredniego punktu pośredniego.

RouteLeg

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

Pola
distance_meters

int32

Długość odcinka trasy w metrach.

duration

Duration

Długość czasu potrzebnego na poruszanie się przez nogę. 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 drogowych.

static_duration

Duration

Długość przejazdu przez dany etap obliczona bez uwzględniania warunków drogowych.

polyline

Polyline

Ogólna linia łamana dla tej nogi. Obejmuje to też linię łamaną każdego elementu step.

start_location

Location

Lokalizacja początkowa tego etapu. Ta wartość może się różnić od atrybutu 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 tej części. Ta wartość może się różnić od atrybutu 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 odpowiada jednej instrukcji nawigacji.

travel_advisory

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp. na etapie trasy.

RouteLegStep

Obejmuje segment elementu RouteLeg. Krok odpowiada jednej instrukcji nawigacji. Etapy trasy składają się z schodów.

Pola
distance_meters

int32

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

static_duration

Duration

Długość podróży na tym etapie bez uwzględniania warunków drogowych. 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 należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie etapu.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie etapu.

Pola
speed_reading_intervals[]

SpeedReadingInterval

Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną obiektu RouteLegStep bez nakładania się. Punkt początkowy określonego przedziału czasu 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).

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp. na etapie trasy.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach w konkretnej RouteLeg. To pole jest wypełniane tylko wtedy, gdy na RouteLeg powinny być dostępne opłaty za przejazd. Jeśli to pole jest ustawione, ale pole podrzędne szacunkowej ceny nie jest wypełniane, droga będzie zawierać drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, na trasie RouteLeg nie jest pobierana opłata.

speed_reading_intervals[]

SpeedReadingInterval

Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną obiektu RouteLg bez nakładania się. Punkt początkowy określonego przedziału czasu 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

To pole jest wymagane. Docelowy punkt na trasie

RouteMatrixElement

Zawiera informacje o trasie obliczone dla pary punktu początkowego i docelowego w interfejsie ComputeRouteMatrix API. Protokół ten można przesyłać strumieniowo do klienta.

Pola
origin_index

int32

Liczony od zera indeks źródła w żądaniu.

destination_index

int32

Indeks miejsca docelowego w żądaniu, który jest liczony od zera.

status

Status

Kod stanu błędu tego elementu.

condition

RouteMatrixElementCondition

Wskazuje, czy trasa została znaleziona. Niezależność od statusu.

distance_meters

int32

Długość trasy w metrach.

duration

Duration

Czas potrzebny na nawigację po trasie. Jeśli ustawisz routing_preference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak static_duration. Jeśli ustawisz routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, wartość ta jest obliczana z uwzględnieniem warunków ruchu.

static_duration

Duration

Czas podróży po trasie bez uwzględniania warunków drogowych.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie może obliczyć trasy na podstawie podanych ustawień dla tej konkretnej pary miejsca docelowego i miejsca docelowego, może przełączyć się na inny tryb obliczania. W przypadku używania trybu awaryjnego to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.

RouteMatrixElementCondition

Stan zwracanej trasy.

Wartości w polu enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Używana tylko wtedy, gdy status elementu jest nieprawidłowy.
ROUTE_EXISTS Znaleziono trasę i uzupełniono odpowiednie informacje o elemencie.
ROUTE_NOT_FOUND Nie znaleziono trasy. Pola zawierające informacje o trasie, takie jak distance_meters czy duration, nie zostaną wypełnione w elemencie.

RouteMatrixOrigin

Jedno źródło dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

To pole jest wymagane. Punkt na trasie początkowy

route_modifiers

RouteModifiers

Opcjonalnie. Modyfikatory każdej trasy, która używa tego elementu jako punktu początkowego

RouteModifiers

Zawiera zestaw opcjonalnych warunków do spełnienia przy obliczaniu tras.

Pola
avoid_tolls

bool

Określa, czy w uzasadnionych przypadkach unikać dróg płatnych. Pierwszeństwo będą miały trasy, które nie zawierają dróg płatnych. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.

avoid_highways

bool

Określa, czy w uzasadnionych przypadkach należy unikać autostrad. Pierwszeństwo będą miały trasy niezawierające autostrad. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.

avoid_ferries

bool

Określa, czy w uzasadnionych przypadkach unikać przepraw promowych. Pierwszeństwo będą miały trasy, które nie obejmują podróży promami. Dotyczy tylko trybów podróży DRIVE i TWO_WHEELER.

avoid_indoor

bool

Określa, czy w uzasadnionych przypadkach unikać wchodzenia w pomieszczenia. Pierwszeństwo będą miały trasy, które nie zawierają nawigacji wewnątrz budynku. Dotyczy tylko trybu podróży WALK.

vehicle_info

VehicleInfo

Określa informacje o pojeździe.

toll_passes[]

TollPass

Zawiera informacje o winietach. Jeśli podasz opłaty za przejazd, interfejs API spróbuje zwrócić cenę biletu. Jeśli nie podasz informacji o opłatach, interfejs API będzie traktować tę opłatę jako nieznaną i stara się zwrócić cenę gotówką. Dotyczy tylko trybów podróży Drive i TWO_WHEELER.

RouteObjective

Zawiera cel, pod kątem którego ma zostać zoptymalizowana optymalizacja według ComputeCustomRoutes.

Pola
rate_card

RateCard

Cel Arkusz stawek.

RateCard

Obejmuje cel trasy RateCard.

Pola
cost_per_minute

MonetaryCost

Opcjonalnie. Koszt za minutę.

cost_per_km

MonetaryCost

Opcjonalnie. Koszt za kilometr

include_tolls

bool

Opcjonalnie. Określa, czy należy uwzględnić opłaty za przejazd w łącznym koszcie.

MonetaryCost

Obejmuje koszt używany w arkuszu stawek.

Pola
value

double

To pole jest wymagane. Wartość kosztu w walucie lokalnej wywnioskowana z żądania.

RouteTravelAdvisory

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie spodziewane są opłaty za przejazd. Jeśli to pole jest ustawione, ale pole podrzędne szacunkowej ceny nie jest wypełniane, droga będzie zawierać drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie jest ustawione, na trasie nie ma opłaty.

speed_reading_intervals[]

SpeedReadingInterval

Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną trasy bez nakładania się. Punkt początkowy określonego przedziału czasu 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

Zestaw wartości służących 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óżuj rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Jednokołowy pojazd silnikowy. Na przykład motocykl. Zwróć uwagę, że różni się to od trybu podróży BICYCLE, który obejmuje tryb obsługiwany przez człowieka.
TAXI

Jazda licencjonowaną taksówką, która na niektórych obszarach może pozwolić pojazdowi na korzystanie z wyznaczonych pasów taksówek.

Tryb TAXI jest funkcją eksperymentalną. Jeśli klient poprosi o trasę TAXI w mieście, w którym dane o pasach taksówek nie są dostępne, zwracana jest trasa drive.

RoutingPreference

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Wartość domyślna to TRAFFIC_AWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania warunków drogowych. Odpowiednie, gdy warunki drogowe nie mają znaczenia. Użycie tej wartości skutkuje najkrótszym czasem oczekiwania.
TRAFFIC_AWARE Oblicza trasy, uwzględniając warunki na drodze. W odróżnieniu od 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 bez stosowania większości optymalizacji skuteczności. Użycie tej wartości powoduje najdłuższe opóźnienie.

SpeedReadingInterval

Wskaźnik natężenia ruchu na przyległym odcinku linii łamanej lub ścieżki. Biorąc pod uwagę ścieżkę z punktami P_0, P_1, ... , P_N (indeks liczony od zera), SpeedReadingInterval definiuje przedział i opisuje jego ruch według następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału na linii łamanej. Jeśli w formacie JSON indeks ma wartość 0, pole wydaje się niepełne.

end_polyline_point_index

int32

Indeks końcowy tego przedziału na linii łamanej. Jeśli w formacie JSON indeks ma wartość 0, pole wydaje się niepełne.

speed

Speed

Prędkość ruchu w tym interwale.

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ść, korek nie jest wykrywany.
SLOW Wykryto korek, ale nie utworzono korka.
TRAFFIC_JAM Wykryto korek.

TollInfo

Zawiera informacje o opłatach na stronie Route lub RouteLeg.

Pola
estimated_price[]

Money

Wartość pieniężna opłat za określoną trasę lub RouteLeg. Ta lista zawiera kwoty dla każdej waluty, która ma zostać pobrana przez stacje opłat. Zwykle lista zawiera tylko jeden element dla tras z opłatami za przejazd w jednej walucie. W przypadku wyjazdów międzynarodowych lista może zawierać kilka elementów, które odzwierciedlają opłaty za przejazd w różnych walutach.

TollPass

Lista obsługiwanych przez nas winiet na całym świecie.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Niewykorzystywany. Jeśli ta wartość zostanie użyta, żądanie nie powiedzie się.
AU_ETOLL_TAG Jeden z wielu dostawców winietów w Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Jeden z wielu dostawców winietów w Sydney. https://www.tollpay.com.au/
AU_LINKT Opłata za przejazd w całej Australii Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Opłata za przejazd w Argentynie. Dodatkowe informacje znajdziesz na https://telepase.com.ar.
BR_AUTO_EXPRESO Brazylijska opłata za przejazd Dodatkowe informacje znajdziesz na https://www.autoexpreso.com.
BR_CONECTCAR Brazylijska opłata za przejazd Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS Brazylijska opłata za przejazd Więcej informacji znajdziesz na https://movemais.com.
BR_PASSA_RAPIDO Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://www.semparar.com.br.
BR_TAGGY Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Przejście graniczne z Kanady do Stanów Zjednoczonych.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Przejście graniczne z Kanady do Stanów Zjednoczonych.
CA_US_BLUE_WATER_EDGE_PASS Przejście graniczne przez Ontario w Kanadzie – Michigan.
CA_US_CONNEXION Przejście graniczne przez Ontario w Kanadzie – Michigan.
CA_US_NEXUS_CARD Przejście graniczne z Kanady do Stanów Zjednoczonych.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez kilka banków używana do płacenia za przejazdy. Wszystkie karty elektroniczne w bankach są rozliczane tak samo, więc potrzeba tylko jednej wartości wyliczeniowej. 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 tablicy stanowej HP.
MX_TAG_IAVE Meksyk.
MX_TAG_TELEVIA Meksykański biuro podróży. Jeden z wielu działających w mieście Meksyk. Dodatkowe informacje znajdziesz na https://www.televia.com.mx.
MX_VIAPASS Meksyk. Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, Stany Zjednoczone.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, Stany Zjednoczone.
US_CA_FASTRAK Kalifornia, Stany Zjednoczone.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że oprócz naklejki na pojazd z czystym powietrzem (CAV) wydany przez DMV kierowca ma dowolny bilet. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Kolorado, USA.
US_CO_GO_PASS Kolorado, USA.
US_DE_EZPASSDE Niemcy, Stany Zjednoczone.
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 Illinois, Stany Zjednoczone.
US_IL_IPASS Illinois, Stany Zjednoczone.
US_IN_EZPASSIN Indie, 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 Kansas, Stany Zjednoczone.
US_LA_GEAUXPASS Luizjana, Stany Zjednoczone.
US_LA_TOLL_TAG Luizjana, Stany Zjednoczone.
US_MA_EZPASSMA Massachusetts, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, Stany Zjednoczone.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Stany Zjednoczone.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Stany Zjednoczone.
US_MI_IQ_PROX_CARD MI, Stany Zjednoczone.
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 Karolina Północna, Stany Zjednoczone.
US_NC_PEACH_PASS Karolina Północna, Stany Zjednoczone.
US_NC_QUICK_PASS Karolina Północna, 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 Pensylwania, Stany Zjednoczone.
US_RI_EZPASSRI Rzym, Stany Zjednoczone.
US_SC_PALPASS Karolina Południowa, 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_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 UT, Stany Zjednoczone.
US_VA_EZPASSVA Wirginia, Stany Zjednoczone.
US_WA_BREEZEBY Waszyngton, USA.
US_WA_GOOD_TO_GO Waszyngton, USA.
US_WV_EZPASSWV WV, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Stany Zjednoczone.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stany Zjednoczone.

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 określona na podstawie żądania.
METRIC Jednostki miary.
IMPERIAL Imperialne (angielskie) jednostki miary.

VehicleEmissionType

Zestaw wartości opisujących typ emisji dwutlenku węgla. Dotyczy to tylko trybu podróży DYSK.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Domyślnie GASOLINE.
GASOLINE Pojazd napędzany paliwem benzynowym lub benzynowym.
ELECTRIC Pojazd napędzany prądem.
HYBRID Pojazd z napędem hybrydowym (np. benzynowym lub elektrycznym).

VehicleInfo

Zawiera informacje o pojeździe, takie jak ostatni znak na tablicy rejestracyjnej.

Pola
emission_type

VehicleEmissionType

Opisuje typ emisji zanieczyszczeń pojazdu. Dotyczy to tylko trybu podróży DYSK.

Punkt pośredni

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

Pola
via

bool

Oznacza ten punkt na drodze jako etap, a nie punkt pośredni. W przypadku każdego punktu pośredniego nieprzeznaczonego w żądaniu, odpowiedź dołącza 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 przechodziła przez ten punkt pośredni bez zatrzymywania. Punkty na trasie nie powodują dodania wpisu do tablicy legs, ale kierują całą podróż przez punkt pośredni. Tę wartość można ustawić tylko dla punktów pośrednich pośrednich. Żądanie nie powiedzie się, jeśli ustawisz to pole na terminalach na trasie. Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość true (prawda), to pole nie może mieć wartości prawda. W przeciwnym razie żądanie nie powiedzie się.

vehicle_stopover

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów do zatrzymania się i tam, gdzie mogą mieć przystanek lub wysyłkę. Gdy 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 zwrotu. Ta opcja działa tylko w trybach DRIVE i TWO_WHEELER oraz gdy location_type ma wartość location.

side_of_road

bool

Wskazuje, że lokalizacja tego punktu pośredniego ma pierwszeństwo przy zatrzymaniu się po określonej stronie drogi. Po ustawieniu tej wartości trasa biegnie przez daną lokalizację, dzięki czemu pojazd może się zatrzymać na stronie drogi, na którą kierowana jest ta lokalizacja, od jej środka. Ta opcja działa tylko w przypadku trybów podróży „Drive” i „TWO_WHEELER” oraz gdy parametr „location_type” ma wartość „location”.

Pole sumy location_type. Różne sposoby prezentowania lokalizacji. location_type może mieć tylko jedną z tych wartości:
location

Location

Punkt określony za pomocą współrzędnych geograficznych, wraz z opcjonalnym nagłówkiem.

place_id

string

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