Package google.maps.routing.v2

Indeks

Trasy

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Zwraca listę miejsc odjazdu i miejsc docelowych, a potem 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ć przy użyciu parametru adresu 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 wszystkich dostępnych pól (do sprawdzenia ręcznej): X-Goog-FieldMask: *
  • Maska pola z czasami trwania tras, odległościami, stanem, stanem i indeksami elementów (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

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

  • Zaznaczenie tylko tych pól, które są Ci potrzebne, pozwala naszemu serwerowi skrócić cykle obliczeniowe, a przez to zwracać Ci wyniki z mniejszym opóźnieniem.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilność czasu oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli zaznaczysz wszystkie pola lub wybierzesz wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde dodane przez nas nowe pole zostanie automatycznie uwzględnione w odpowiedzi.
  • Wybranie tylko tych pól, które są potrzebne, zmniejsza rozmiar odpowiedzi i większą przepustowość sieci.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi z określonym zestawem 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ć przy użyciu parametru adresu 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 wszystkich dostępnych pól (do sprawdzenia 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

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, pozwala naszemu serwerowi skrócić cykle obliczeniowe, a przez to zwracać Ci wyniki z mniejszym opóźnieniem.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilność czasu oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli zaznaczysz wszystkie pola lub wybierzesz wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde dodane przez nas nowe pole zostanie automatycznie uwzględnione w odpowiedzi.
  • Wybranie tylko tych pól, które są potrzebne, zmniejsza rozmiar odpowiedzi i większą przepustowość sieci.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

To pole jest wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. W odniesieniu do mocy zbioru miejsc początkowych i miejsc docelowych obowiązuje kilka ograniczeń dotyczących rozmiaru:

  • Suma liczby miejsc wylotu + liczba miejsc docelowych określonych jako place_id lub address nie może być większa niż 50.
  • Iloczyn liczby miejsc wylotu × liczba miejsc docelowych w żadnym przypadku nie może przekraczać 625.
  • Jeśli iloczyn liczby punktów początkowych × liczbę miejsc docelowych nie może być większy niż 100, jeśli parametr routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL.
  • Jeśli iloczyn liczby miejsc wylotu × liczba miejsc docelowych nie może przekraczać 100, jeśli tryb podróżowania jest ustawiony na TRANSIT.
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 wyznaczyć trasę, korzystając z wybranego ustawienia routingu. Jeśli ustawienie routingu powoduje błąd lub bardzo długi czas oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślną wartością będzie czas przesłania żądania. UWAGA: w przeszłości można było określić departure_time tylko wtedy, gdy opcja RouteTravelMode ma wartość TRANSIT.
arrival_time

Timestamp

Opcjonalnie. Godzina przyjazdu. UWAGA: to ustawienie można ustawić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT. Możesz podać wartość departure_time lub arrival_time, ale nie obie te wartości.
language_code

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Lokalny identyfikator 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 pierwszego punktu początkowego.
region_code

string

Opcjonalnie. Kod regionu, podany jako dwuznakowa wartość domeny najwyższego poziomu (ccTLD). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu.
units

Units

Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania.
extra_computations[]

ExtraComputation

Opcjonalnie. Lista dodatkowych obliczeń, które mogą zostać użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w masce pola, aby zostały zwrócone w odpowiedzi.
traffic_model

TrafficModel

Opcjonalnie. Określa założenia do obliczenia czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polu RouteMatrixElement, które zawiera przewidywany czas w ruchu na podstawie średnich historycznych. Z: RoutingPreference do: TRAFFIC_AWARE_OPTIMAL i RouteTravelMode do: DRIVE. Jeśli żądanie ruchu jest wysyłane, a TrafficModel nie jest określony, przyjmuje domyślnie wartość BEST_GUESS.
transit_preferences

TransitPreferences

Opcjonalnie. Określa preferencje, które mają wpływ na zwracaną trasę dla tras TRANSIT. UWAGA: transit_preferences możesz określić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT.

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywany. Żądania zawierające tę wartość będą kończyć się niepowodzeniem.
TOLLS Informacje o opłatach związanych z elementami macierzy.

ComputeRoutesRequest

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

To pole jest wymagane. Punkt 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 wyznaczyć trasę, korzystając z wybranego ustawienia routingu. Jeśli ustawienie routingu prowadzi do błędu lub długiego czasu oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie. Określa preferencję dotyczącą 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ślną wartością będzie czas przesłania żądania. UWAGA: w przeszłości można było określić departure_time tylko wtedy, gdy opcja RouteTravelMode ma wartość TRANSIT. Podróże transportem publicznym są dostępne dla podróży na okres do 7 dni wstecz lub do 100 dni do przodu.
arrival_time

Timestamp

Opcjonalnie. Godzina przyjazdu. UWAGA: to ustawienie można ustawić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT. Możesz podać wartość departure_time lub arrival_time, ale nie obie te wartości. Podróże transportem publicznym są dostępne dla podróży na okres do 7 dni wstecz lub do 100 dni do przodu.
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 trasy alternatywne.
route_modifiers

RouteModifiers

Opcjonalnie. Zbiór warunków, które muszą spełniać warunki wpływające na sposób obliczania tras.
language_code

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Lokalny identyfikator 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.
region_code

string

Opcjonalnie. Kod regionu, podany jako dwuznakowa wartość domeny najwyższego poziomu (ccTLD). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu.
units

Units

Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Te pola obejmują pole instruction w tabeli NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary używane dla trasy, etapu, dystansu kroków ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki zostaną ustalone na podstawie lokalizacji pierwszego punktu początkowego.
optimize_waypoint_order

bool

Opcjonalnie. Jeśli zasada ma wartość Prawda, usługa próbuje zminimalizować ogólny koszt trasy przez zmianę kolejności określonych pośrednich punktów pośrednich. Żądanie nie powiedzie się, jeśli dowolny z pośrednich punktów pośrednich jest punktem na trasie via. Użyj pola ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku X-Goog-FieldMask nie zostanie wysłane żądanie ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index, nie uda się zrealizować żądania. Jeśli optimize_waypoint_order ma wartość Fałsz, ComputeRoutesResponse.optimized_intermediate_waypoint_index jest pusty.
requested_reference_routes[]

ReferenceRoute

Opcjonalnie. Określa, które trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa, której cel wyznaczania trasy jest inny niż trasa domyślna. Na przykład wynikowe obliczanie trasy z uwzględnieniem FUEL_EFFICIENT uwzględnia różne parametry, które pozwalają wygenerować optymalną trasę z najniższym spalaniem.
extra_computations[]

ExtraComputation

Opcjonalnie. Lista dodatkowych obliczeń, które mogą zostać użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w masce pola, aby zostały zwrócone w odpowiedzi.
traffic_model

TrafficModel

Opcjonalnie. Określa założenia do obliczenia czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polach Route i RouteLeg, która zawiera przewidywany czas w korku na podstawie średnich historycznych. Funkcja TrafficModel jest dostępna tylko dla żądań, które ustawiono w polu RoutingPreference na TRAFFIC_AWARE_OPTIMAL, a w kolumnie RouteTravelMode na DRIVE. Jeśli żądanie ruchu jest wysyłane, a TrafficModel nie jest określony, przyjmuje domyślnie wartość BEST_GUESS.
transit_preferences

TransitPreferences

Opcjonalnie. Określa preferencje, które mają wpływ na zwracaną trasę dla tras TRANSIT. UWAGA: transit_preferences możesz określić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT.

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywany. Żądania zawierające tę wartość będą kończyć się niepowodzeniem.
TOLLS Informacje o opłatach na trasach.
FUEL_CONSUMPTION Szacunkowe zużycie paliwa na trasach.
TRAFFIC_ON_POLYLINE linie łamane na trasach z odpowiednim natężeniem ruchu;
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions przedstawiony jako sformatowany ciąg tekstowy HTML. Treść jest przeznaczona tylko do wyświetlania. Nie analizuj ich automatycznie.

ReferenceRoute

Obsługiwana trasa odniesienia w ComputeRoutesRequest.

Wartości w polu enum
REFERENCE_ROUTE_UNSPECIFIED Nieużywany. Żądania zawierające tę wartość kończą się niepowodzeniem.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem takich parametrów jak zużycie paliwa.

ComputeRoutesResponse

ComputeRoutes zwraca wiadomość z odpowiedzią,

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), gdy podasz compute_alternatives_routes, i tylko 1 trasę, jeśli jej nie określisz. 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źć żadnej trasy.
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie może obliczyć wyników trasy przy użyciu wszystkich danych wejściowych, może w zastępstwie użyć innej metody obliczeń. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.
geocoding_results

GeocodingResults

Zawiera odpowiedź geokodowania dla punktów na trasie określonych jako adresy.

FallbackInfo

Informacje o tym, jak i dlaczego użyto wyniku kreacji zastępczej. Jeśli to pole jest skonfigurowane, oznacza to, że serwer jako kreacji zastępczej użył innego trybu routingu niż preferowany.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu używany w odpowiedzi. Jeśli aktywowano kreację zastępczą, tryb może być inny niż ustawienie routingu ustawione w pierwotnym żądaniu klienta.
reason

FallbackReason

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

FallbackReason

Powody użycia odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano przyczyny kreacji zastępczej.
SERVER_ERROR Podczas obliczania tras w preferowanym trybie trasy 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ń przy użyciu Twojego preferowanego trybu trasy, ale udało nam się zwrócić 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żywany.
FALLBACK_TRAFFIC_UNAWARE Wskazuje, że do obliczenia odpowiedzi użyto pola TRAFFIC_UNAWARE RoutingPreference.
FALLBACK_TRAFFIC_AWARE Wskazuje, że do obliczenia odpowiedzi użyto pola TRAFFIC_AWARE RoutingPreference.

GeocodedWaypoint

Szczegółowe informacje o lokalizacjach używanych jako punkty na trasie. Pole wypełnione tylko w przypadku punktów na trasie. Zawiera szczegółowe informacje dotyczące wyników geokodowania na potrzeby określania, na co adres został zakodowany geokod.

Pola
geocoder_status

Status

Wskazuje kod stanu wynikający z operacji geokodowania.
type[]

string

Typy wyniku w postaci 0 lub większej liczby tagów typu. Obsługiwane typy: typy adresów i typy komponentów adresu.
partial_match

bool

Wskazuje, że geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, chociaż udało mu się dopasować część żądanego adresu. Warto sprawdzić pierwotne żądanie pod kątem błędów z błędami lub niekompletnego adresu.
place_id

string

Identyfikator miejsca powiązany z tym wynikiem.
intermediate_waypoint_request_index

int32

Indeks odpowiedniego pośredniego punktu pośredniego w żądaniu. Pole wypełnione tylko wtedy, gdy odpowiedni punkt na trasie jest pośrednim punktem na trasie.

GeocodingResults

Zawiera GeocodedWaypoints dla punktów początkowych, docelowych i pośrednich. Pole wypełnione tylko w przypadku punktów na trasie.

Pola
origin

GeocodedWaypoint

Geokodowany punkt na trasie początkowy.
destination

GeocodedWaypoint

Geokodowany punkt na trasie docelowy.
intermediates[]

GeocodedWaypoint

Lista pośrednich geokodowanych punktów pośrednich, z których każdy zawiera pole indeksu odpowiadające zerowej pozycji punktu pośredniego w kolejności, w jakiej zostały one określone w żądaniu.

LocalizedTime

Zlokalizowany opis czasu.

Pola
time

LocalizedText

Czas podany jako ciąg znaków w danej strefie czasowej.
time_zone

string

Zawiera strefę czasową. Ta wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”.

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ść określa stronę drogi, po której będzie odbiór i przyjazd. Nagłówek może mieć wartość z zakresu od 0 do 360, gdzie 0 wskazuje kierunek na północ, 90 określa kierunek na wschód itd. Tego pola możesz używać tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.

Ruch

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

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywany.
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 Zawróć w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Idź prosto.
RAMP_LEFT Skręć w lewą rampę.
RAMP_RIGHT Skręć w prawą rampę.
MERGE Scal w ruch.
FORK_LEFT Skręć w lewy rozwidlenie.
FORK_RIGHT Weź właściwy rozwidlenie.
FERRY Wybierzcie się promem.
FERRY_TRAIN Wsiądź do pociągu prowadzącego na prom.
ROUNDABOUT_LEFT Skręć w lewo na rondzie.
ROUNDABOUT_RIGHT Skręć w prawo na rondzie.
DEPART Początkowy manewr.
NAME_CHANGE Służy do wskazywania zmiany nazwy ulicy.

Obejmuje instrukcje nawigacji dotyczące obiektu RouteLegStep.

Pola
maneuver

Maneuver

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

string

Instrukcje, jak przejść ten etap.

Linia łamana

Obejmuje zakodowaną linię łamaną.

Pola
Pole sumy polyline_type. Obejmuje typ linii łamanej. Domyślnie jest to zakodowana_łamana. polyline_type może być tylko jedną z tych wartości:
encoded_polyline

string

Kodowanie ciągu łamanego linii łamanej za pomocą algorytmu kodowania linii łamanej
geo_json_linestring

Struct

Wskazuje linię łamaną w formacie linii GeoJSON.

PolylineEncoding

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

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 linii łamanej.
GEO_JSON_LINESTRING Określa linię łamaną w formacie linii GeoJSON

PolylineQuality

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

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji jakości linii łamanej. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa wysokiej jakości linię łamaną, która składa się z większej liczby punktów niż OVERVIEW, ale kosztem zwiększenia 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 przy wyświetlaniu opisu trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie niż opcja HIGH_QUALITY.

Trasa

Obejmuje trasę, która składa się z szeregu połączonych fragmentów drogi łączących się z punktami na trasie (początkowy, końcowy i pośredni).

Pola
route_labels[]

RouteLabel

Etykiety Route umożliwiające identyfikację konkretnych właściwości trasy, które można porównać z innymi.
legs[]

RouteLeg

Zespół ścieżek (odcinków ścieżek między punktami na trasie), które tworzą trasę. Każdy etap odpowiada podróży między 2 elementami Waypoints spoza via. Na przykład trasa bez pośrednich punktów na trasie ma tylko jeden etap. Trasa obejmująca jeden pośredni punkt na trasie inny niż via ma dwa etapy. Trasa obejmująca jeden pośredni punkt na trasie via ma jeden etap. Kolejność punktów jest zgodna z kolejnością punktów pośrednich od origin do intermediates do destination.
distance_meters

int32

Długość trasy w metrach.
duration

Duration

Długość czasu potrzebnego na pokonanie trasy. Jeśli ustawisz routing_preference na TRAFFIC_UNAWARE, ta wartość jest taka sama jak static_duration. Jeśli ustawisz routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków ruchu.
static_duration

Duration

Długość przejazdu wzdłuż trasy bez uwzględniania warunków drogowych.
polyline

Polyline

Całkowita linia łamana trasy. Ta linia łamana jest 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 ustawisz optimize_waypoint_order na wartość true, to pole będzie zawierać zoptymalizowaną kolejność pośrednich punktów pośrednich. W przeciwnym razie to pole jest puste. Jeśli na przykład podasz dane punktu początkowego: LA; pośrednie punkty na drodze: Dallas, Bangor, Phoenix; cel podróży: Nowy Jork; a zoptymalizowana pośrednia 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 pośredniego punktu pośredniego podanego w danych wejściowych.
localized_values

RouteLocalizedValues

Reprezentacje tekstowe właściwości obiektu Route.
route_token

string

Bezpieczny w internecie token trasy zakodowany w standardzie base64, który można przekazać do pakietu Navigation SDK, który umożliwia zrekonstruowanie trasy podczas nawigacji, a w przypadku zmiany trasy musi uwzględniać pierwotną intencję podczas tworzenia trasy przez wywołanie ComputeRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob. Nie służy do odczytywania tekstu ani wprowadzania mutacji. UWAGA: Route.route_token jest dostępne tylko dla żądań, dla których ComputeRoutesRequest.routing_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Funkcja Route.route_token nie jest obsługiwana w przypadku żądań z punktami pośrednimi Via.

RouteLocalizedValues

Reprezentacje tekstowe określonych właściwości.

Pola
distance

LocalizedText

Długość podróży przedstawiona w formie tekstowej.
duration

LocalizedText

Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie prosiłeś o informacje o natężeniu ruchu, ta wartość będzie taka sama jak wartość static_duration.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.
transit_fare

LocalizedText

Opłata za transport w formie tekstowej.

RouteLabel

Etykiety Route umożliwiające identyfikację konkretnych właściwości trasy, które można porównać z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślny – nieużywany.
DEFAULT_ROUTE Przy obliczaniu trasy została zwrócona domyślna „najlepsza” trasa.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnej „najlepszej” trasy. Takie trasy będą zwracane po określeniu compute_alternative_routes.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem parametrów Eko, takich jak zużycie paliwa.

RouteLeg

Zawiera segment między punktami na trasie spoza via.

Pola
distance_meters

int32

Odległość pokonywania odcinka trasy w metrach.
duration

Duration

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

Duration

Długość przejazdu przez odcinek, obliczona bez uwzględniania warunków drogowych.
polyline

Polyline

Ogólna linia łamana tej odnogi obejmująca linię łamaną każdego elementu step.
start_location

Location

Lokalizacja początkowa tego etapu. Ta lokalizacja może się różnić od podanej lokalizacji 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 etapu. Ta lokalizacja może się różnić od podanej lokalizacji 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 odcinku. 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 na danym etapie trasy.
localized_values

RouteLegLocalizedValues

Reprezentacje tekstowe właściwości obiektu RouteLeg.
steps_overview

StepsOverview

Omówienie czynności, które musisz wykonać w tym artykule (RouteLeg). Pole jest wypełniane tylko w przypadku tras TRANSIT.

RouteLegLocalizedValues

Reprezentacje tekstowe określonych właściwości.

Pola
distance

LocalizedText

Długość podróży przedstawiona w formie tekstowej.
duration

LocalizedText

Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie wysyłasz żądania informacji o ruchu, ta wartość będzie taka sama jak wartość static_duration.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.

StepsOverview

Zawiera ogólne informacje o liście elementów RouteLegStep.

Pola
multi_modal_segments[]

MultiModalSegment

Podsumowanie informacji o różnych multimodalnych segmentach elementu RouteLeg.steps. To pole nie jest wypełniane, jeśli RouteLeg nie zawiera żadnych segmentów multimodalnych w krokach.

MultiModalSegment

Zawiera podsumowanie informacji o różnych multimodalnych segmentach interfejsu RouteLeg.steps. Segment wielomodalny to co najmniej 1 przylegający do siebie segment RouteLegStep, który ma taki sam parametr RouteTravelMode. To pole nie jest wypełniane, jeśli RouteLeg nie zawiera żadnych segmentów multimodalnych w krokach.

Pola
navigation_instruction

NavigationInstruction

Instrukcja nawigacji dla segmentu multimodalnego.
travel_mode

RouteTravelMode

Środek transportu segmentu multimodalnego.
step_start_index

int32

Odpowiedni indeks RouteLegStep, który jest początkiem segmentu multimodalnego.
step_end_index

int32

Odpowiedni indeks RouteLegStep, który kończy się segmentem multimodalnym.

RouteLegStep

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

Pola
distance_meters

int32

Odległość pokonywania tego kroku wyrażona w metrach. W pewnych okolicznościach to pole może nie mieć wartości.
static_duration

Duration

Czas podróży na tym etapie bez uwzględniania warunków drogowych. W pewnych okolicznościach 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.
localized_values

RouteLegStepLocalizedValues

Reprezentacje tekstowe właściwości obiektu RouteLegStep.
transit_details

RouteLegStepTransitDetails

Szczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT.
travel_mode

RouteTravelMode

Środek transportu użyty w tym kroku.

RouteLegStepLocalizedValues

Reprezentacje tekstowe określonych właściwości.

Pola
distance

LocalizedText

Długość podróży przedstawiona w formie tekstowej.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.

RouteLegStepTransitDetails

Dodatkowe informacje o RouteLegStep związane z trasami TRANSIT.

Pola
stop_details

TransitStopDetails

Informacje o przystankach na czas przyjazdu i odjazdu na danym etapie.
localized_values

TransitDetailsLocalizedValues

Reprezentacje tekstowe właściwości obiektu RouteLegStepTransitDetails.
headsign

string

Określa kierunek jazdy na tej linii zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdu. Kierunek to często stacja docelowa.
headway

Duration

Określa oczekiwany czas jako czas między odjazdem z tego samego przystanku o danej porze. Jeśli na przykład ustawisz wartość 600 sekund na trasie przejazdu, w razie spóźnienia na autobus musisz czekać 10 minut.
transit_line

TransitLine

Informacje o linii transportu publicznego użytej w tym kroku.
stop_count

int32

Liczba przesiadek od odjazdu do przystanku przyjazdu. Liczba ta obejmuje przystanek przylotów, ale nie uwzględnia przystanku odlotu. Jeśli na przykład trasa rozpoczyna się ze przystanku A, mija przez przystanki B i C, a dotrze do przystanku D, stop_count zwraca wartość 3.
trip_short_text

string

Tekst widoczny w rozkładach jazdy i na tablicach informacyjnych dla pasażerów, którzy chcą skorzystać z transportu publicznego. Tekst powinien jednoznacznie identyfikować podróż w ramach dnia usługi. Na przykład „538” to trip_short_text pociągu Amtrak odjeżdżającego z San Jose, CA o 15:10 w dni powszednie do Sacramento, CA.

TransitDetailsLocalizedValues

Zlokalizowane opisy wartości dla parametru RouteTransitDetails.

Pola
arrival_time

LocalizedTime

Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową.
departure_time

LocalizedTime

Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową.

TransitStopDetails

Szczegółowe informacje o przystankach: RouteLegStep.

Pola
arrival_stop

TransitStop

Informacje o przystanku na danym etapie.
arrival_time

Timestamp

Szacowany czas dotarcia na miejsce.
departure_stop

TransitStop

Informacje o przystanku odjazdu dla tego kroku.
departure_time

Timestamp

Szacowany czas odjazdu danego kroku.

RouteLegStepTravelAdvisory

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

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole nie jest obecnie wypełnione.

RouteLegTravelAdvisory

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

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na poszczególnych obszarach RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd na: RouteLeg. Jeśli to pole jest ustawione, ale pole podrzędne szacunków_price nie jest wypełnione, droga zawiera opłaty za przejazd, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, RouteLeg nie ma opłat.
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

RouteMatrixDestination

Jedno miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

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
status

Status

Kod stanu błędu tego elementu.
condition

RouteMatrixElementCondition

Wskazuje, czy trasa została znaleziona. Bez względu na status.
distance_meters

int32

Długość trasy w metrach.
duration

Duration

Długość czasu potrzebnego na pokonanie trasy. Jeśli ustawisz routing_preference na TRAFFIC_UNAWARE, ta wartość jest taka sama jak static_duration. Jeśli ustawisz routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość 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 przy podanych preferencjach dla tej konkretnej pary miejsca docelowego i miejsca docelowego, może przełączyć się na inny tryb obliczania. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.
localized_values

LocalizedValues

Reprezentacje tekstowe właściwości obiektu RouteMatrixElement.
origin_index

int32

Oparty na zera indeks źródła w żądaniu.
destination_index

int32

Oparty na zera indeks miejsca docelowego w żądaniu.

LocalizedValues

Reprezentacje tekstowe określonych właściwości.

Pola
distance

LocalizedText

Długość podróży przedstawiona w formie tekstowej.
duration

LocalizedText

Czas trwania przedstawiony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie zażądano informacji o ruchu, ta wartość ma taką samą wartość jak static_duration.
static_duration

LocalizedText

Czas trwania przedstawiony w formie tekstowej bez uwzględnienia warunków na drodze.
transit_fare

LocalizedText

Opłata za transport w formie tekstowej.

RouteMatrixElementCondition

Stan zwracanej trasy.

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

RouteMatrixOrigin

Jedno źródło dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

To pole jest wymagane. Punkt początkowy
route_modifiers

RouteModifiers

Opcjonalnie. Modyfikatory wszystkich tras, które wykorzystują to jako punkt początkowy

RouteModifiers

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

Pola
avoid_tolls

bool

Jeśli ma wartość Prawda, w uzasadnionych przypadkach omija drogi płatne, preferując trasy bez dróg płatnych. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.
avoid_highways

bool

Jeśli zasada ma wartość Prawda, w uzasadnionych przypadkach omija autostrady. Priorytetem są też trasy niezawierające autostrad. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.
avoid_ferries

bool

Jeśli ma wartość Prawda, w uzasadnionych przypadkach omija przeprawy promowe, preferując trasy bez przepraw promowych. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Jeśli zasada ma wartość Prawda, w uzasadnionych przypadkach pomija nawigację wewnątrz budynków, preferując trasy bez nawigacji wewnątrz. Dotyczy tylko: WALK RouteTravelMode.
vehicle_info

VehicleInfo

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

TollPass

Zawiera informacje o winietach. Jeśli są dostępne karty opłat, interfejs API próbuje zwrócić cenę biletu. Jeśli nie podasz winiet, interfejs API traktuje je jako nieznane i próbuje zwrócić kwotę gotówkową. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

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

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie są spodziewane opłaty za przejazd. Jeśli to pole jest ustawione, ale pole podrzędne estimatedPrice nie jest wypełnione, trasa zawiera opłaty za przejazd, ale szacunkowa cena jest nieznana. Jeśli to pole nie jest ustawione, na trasie nie będą naliczane żadne opłaty.
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

int64

Przewidywane zużycie paliwa w mikrolitrach.
route_restrictions_partially_ignored

bool

Powrotna trasa może mieć ograniczenia, które nie są odpowiednie dla wybranych środków transportu lub modyfikatorów trasy.
transit_fare

Money

Jeśli ta opcja jest dostępna, zawiera całkowitą cenę lub koszty biletu na tej trasie. Ten obiekt jest zwracany tylko w przypadku żądań TRANSIT i tylko w przypadku tras, dla których dostępne są informacje o opłatach dla wszystkich etapów transportu publicznego.

RouteTravelMode

Zbiór wartości określających środek transportu. UWAGA: trasy WALK, BICYCLE i TWO_WHEELER są w wersji beta i czasami mogą nie być na nich puste chodniki, ścieżki dla pieszych i ścieżki rowerowe. Ostrzeżenie musisz wyświetlać użytkownikowi w przypadku wszystkich tras pieszych, rowerowych i rowerowych wyświetlanych w aplikacji.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu. Domyślna wartość to DRIVE.
DRIVE Podróż samochodem.
BICYCLE Podróżuj rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Dwukołowy pojazd silnikowy. Na przykład motocykl. Różni się to od trybu podróży BICYCLE, który obejmuje tryb obsługiwany przez człowieka.
TRANSIT podróżować transportem publicznym, gdy są dostępne;

RoutingPreference

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Wartość domyślna: TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania bieżących warunków drogowych. Ta opcja jest przydatna, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości powoduje najkrótszy czas oczekiwania. Uwaga: w przypadku numerów RouteTravelMode DRIVE i TWO_WHEELER wybrana trasa i czas jej trwania zależą od sieci drogowej i średniej wartości natężenia ruchu niezależnego od czasu, a nie bieżących warunków na drodze. Dlatego trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki dotyczące danego żądania mogą się z czasem zmieniać ze względu na zmiany w sieci drogowej, zaktualizowane warunki średniego natężenia ruchu oraz rozproszony charakter usługi. Wyniki mogą się też zmieniać w dowolnej chwili i z częstotliwością na niemal identycznych trasach.
TRAFFIC_AWARE Oblicza trasy, biorąc pod uwagę aktualne natężenie ruchu. W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje są stosowane w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę aktualne natężenie ruchu, 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, ... i P_N (indeks liczony od zera), SpeedReadingInterval definiuje przedział i opisuje jego ruch za pomocą następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego interwału na linii łamanej.
end_polyline_point_index

int32

Końcowy indeks tego przedziału na linii łamanej.

Pole sumy speed_type.

speed_type może być tylko jedną z tych wartości:
speed

Speed

Szybkość ruchu w tym przedziale czasu.

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 korków.
SLOW Wykryto korek, ale nie pojawił się korek.
TRAFFIC_JAM Wykryto korek.

TollInfo

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

Pola
estimated_price[]

Money

Wysokość opłat pieniężnych za odpowiednie Route lub RouteLeg. Ta lista zawiera kwoty dla każdej waluty, która ma zostać pobrana przez stacje poboru opłat. Zwykle zawiera ona tylko jeden element dla tras z opłatami w jednej walucie. W przypadku podróży międzynarodowych lista może zawierać wiele pozycji, które odzwierciedlają opłaty za przejazd w różnych walutach.

TollPass

Lista winiet na całym świecie, które obsługujemy.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywany. Jeśli zostanie ona użyta, żądanie nie powiedzie się.
AU_ETOLL_TAG Płatna opłata za przejazd w Sydney. Dodatkowe informacje znajdziesz na stronie https://www.myetoll.com.au.
AU_EWAY_TAG Płatna opłata za przejazd w Sydney. Więcej informacji znajdziesz na stronie https://www.tollpay.com.au.
AU_LINKT Opłata za przejazd w Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Płatny bilet w Argentynie. Dodatkowe informacje znajdziesz na stronie https://telepase.com.ar.
BR_AUTO_EXPRESO Bilet płatny w Brazylii. Więcej informacji znajdziesz na https://www.autoexpreso.com.
BR_CONECTCAR Bilet płatny w Brazylii. Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS Bilet płatny w Brazylii. Więcej informacji znajdziesz na https://movemais.com.
BR_PASSA_RAPIDO Bilet płatny w Brazylii. Dodatkowe informacje znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR Bilet płatny w Brazylii. Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY Bilet płatny w Brazylii. Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE Bilet płatny w Brazylii. 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 z Ontario w Kanadzie do Michigan.
CA_US_CONNEXION przejście graniczne z Ontario w Kanadzie do Michigan.
CA_US_NEXUS_CARD Przejście graniczne z Kanady do Stanów Zjednoczonych.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez wiele banków używana do płatności za przejazd. Wszystkie karty elektroniczne w bankach są obciążane tak samo, więc wystarczy podać jedną wartość wyliczeniową. Przykład: – Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indie.
IN_LOCAL_HP_PLATE_EXEMPT Indie, zwolnienie z numeru rejestracyjnego HP.
JP_ETC Japonia itp. Elektroniczny system bezprzewodowy do pobierania opłat. https://www.go-etc.jp/
JP_ETC2 Japan. ETC2.0. Nowa wersja ETC z dalszą, rabatową i dwukierunkową komunikacją między urządzeniami w pojazdach oraz antenami na drodze. https://www.go-etc.jp/etc2/index.html
MX_IAVE Opłata za przejazd w Meksyku. 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 http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Meksyk
MX_TAG_TELEVIA Firma oferująca winiety w Meksyku. Jeden z wielu działających w mieście Meksyk. Dodatkowe informacje znajdziesz na https://www.televia.com.mx.
MX_TELEVIA Firma oferująca winiety w Meksyku. Jeden z wielu działających w mieście Meksyk. https://www.televia.com.mx
MX_VIAPASS Płatna opłata za przejazd w Meksyku. Więcej informacji znajdziesz na https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że kierowca ma dowolny bilet FasTrak, a oprócz naklejki z samochodem ciężarowym wydanym 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 Illinois, Stany Zjednoczone.
US_IL_IPASS Illinois, Stany Zjednoczone.
US_IN_EZPASSIN Indie, Stany Zjednoczone.
US_KS_BESTPASS_HORIZON KS, Stany Zjednoczone.
US_KS_KTAG KS, Stany Zjednoczone.
US_KS_NATIONALPASS KS, Stany Zjednoczone.
US_KS_PREPASS_ELITEPASS KS, Stany Zjednoczone.
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, 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. Wycofano, ponieważ ten typ karty już nie istnieje.
US_MI_IQ_TAG 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 NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH New Hampshire, Stany Zjednoczone.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stany Zjednoczone.
US_NJ_EZPASSNJ NJ, Stany Zjednoczone.
US_NY_EXPRESSPASS Nowy Jork, USA.
US_NY_EZPASSNY Nowy Jork, USA.
US_OH_EZPASSOH Ohio, USA.
US_PA_EZPASSPA PA, Stany Zjednoczone.
US_RI_EZPASSRI Rzym, Stany Zjednoczone.
US_SC_PALPASS SC, Stany Zjednoczone.
US_TX_AVI_TAG Teksas, USA.
US_TX_BANCPASS Teksas, USA.
US_TX_DEL_RIO_PASS Teksas, USA.
US_TX_EFAST_PASS Teksas, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD Teksas, USA.
US_TX_EPTOLL Teksas, USA.
US_TX_EZ_CROSS Teksas, USA.
US_TX_EZTAG Teksas, USA.
US_TX_FUEGO_TAG Teksas, USA.
US_TX_LAREDO_TRADE_TAG Teksas, USA.
US_TX_PLUSPASS Teksas, USA.
US_TX_TOLLTAG Teksas, USA.
US_TX_TXTAG Teksas, USA.
US_TX_XPRESS_CARD Teksas, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, Stany Zjednoczone.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Stany Zjednoczone.
US_WV_MOV_PASS Wirginia Zachodnia, Stany Zjednoczone
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stany Zjednoczone.

TrafficModel

Określa założenia do obliczenia czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu duration w odpowiedzi, która zawiera przewidywany czas w ruchu na podstawie średnich historycznych.

Wartości w polu enum
TRAFFIC_MODEL_UNSPECIFIED Nieużywane. Jeśli określisz wartość, zostanie użyta domyślna wartość BEST_GUESS.
BEST_GUESS Wskazuje, że zwracana wartość duration powinna być najdokładniejszym oszacowaniem czasu podróży, biorąc pod uwagę zarówno historyczne dane o warunkach drogowych, jak i aktualne natężenie ruchu. Ruch na żywo staje się ważniejszy, im bliżej do niej znajduje się departure_time.
PESSIMISTIC Wskazuje, że zwracany czas powinien być dłuższy niż rzeczywisty czas podróży w większości dni, chociaż w niektórych dniach o szczególnie dużym natężeniu ruchu ta wartość może przekroczyć tę wartość.
OPTIMISTIC Wskazuje, że zwrócony czas trwania powinien być krótszy od rzeczywistego czasu podróży w większości dni, chociaż w niektórych dniach, w których panuje szczególnie dobre warunki na drodze, może minąć ta wartość szybciej.

TransitAgency

Przewoźnik, który obsługuje linię transportu publicznego.

Pola
name

string

Nazwa tego przewoźnika.
phone_number

string

Numer telefonu przewoźnika w zależności od regionu.
uri

string

Identyfikator URI przewoźnika.

TransitLine

Zawiera informacje o linii transportu publicznego użytej w tym kroku.

Pola
agencies[]

TransitAgency

Przewoźnik (lub przewoźnika), który obsługuje tę linię transportu publicznego.
name

string

Pełna nazwa tej linii transportu publicznego, na przykład „ul. Lokalna 8”.
uri

string

identyfikator URI dla tej linii transportu publicznego podany przez przewoźnika.
color

string

Kolor często używany na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym.
icon_uri

string

Identyfikator URI ikony powiązanej z tym wierszem.
name_short

string

Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer wiersza, np. „M7” lub „355”.
text_color

string

Kolor często używany w tekście na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym.
vehicle

TransitVehicle

Typ pojazdu poruszającego się na tej linii transportu publicznego.

TransitPreferences

Preferencje dotyczące tras opartych na TRANSIT, które mają wpływ na zwracaną trasę.

Pola
allowed_travel_modes[]

TransitTravelMode

Zestaw trybów podróży do użycia podczas wyznaczania trasy TRANSIT. Domyślnie wszystkie obsługiwane środki transportu.
routing_preference

TransitRoutingPreference

Preferencja routingu, która po określeniu wpływa na zwracaną trasę TRANSIT.

TransitRoutingPreference

Określa preferencje routingu dla tras transportu publicznego.

Wartości w polu enum
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji.
LESS_WALKING Wskazuje, że obliczona trasa powinna preferować ograniczoną ilość ruchu.
FEWER_TRANSFERS Wskazuje, że obliczona trasa powinna preferować ograniczoną liczbę przesiadek.

TransitTravelMode

Zbiór wartości określających środek transportu.

Wartości w polu enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu publicznego.
BUS Możesz skorzystać z podróży autobusem.
SUBWAY Podróż metrem
TRAIN Możesz podróżować pociągiem.
LIGHT_RAIL Podróżuj pociągiem lub tramwajem.
RAIL Możesz podróżować pociągiem. Jest to odpowiednik kombinacji elementów SUBWAY, TRAIN i LIGHT_RAIL.

TransitStop

Informacje o przystanku.

Pola
name

string

Nazwa przystanku.
location

Location

Lokalizacja przystanku wyrażona we współrzędnych szerokości i długości geograficznej.

TransitVehicle

Informacje o pojeździe używanym na trasach transportu publicznego.

Pola
name

LocalizedText

Nazwa pojazdu pisana wielkimi literami.
type

TransitVehicleType

Typ używanego pojazdu.
icon_uri

string

Identyfikator URI ikony powiązanej z tym typem pojazdu.
local_icon_uri

string

Identyfikator URI ikony powiązanej z tym typem pojazdu na podstawie lokalnego znaku transportowego.

TransitVehicleType

Rodzaj pojazdów na trasach transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywane.
BUS Autobus.
CABLE_CAR Pojazd na kablu, zazwyczaj znajdujący się na ziemi. Kolejki linowe mogą należeć do typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Promem
FUNICULAR Pojazd ciągnięty linią po stromym wzniesieniu. Kolejka linowa zwykle składa się z 2 samochodów, z których każdy stanowi przeciwwagę dla drugiego.
GONDOLA_LIFT Kolejka linowa.
HEAVY_RAIL Ciężka kolej.
HIGH_SPEED_TRAIN Szybki pociąg.
INTERCITY_BUS Autobus dalekobieżny.
LONG_DISTANCE_TRAIN Pociąg dalekobieżny.
METRO_RAIL Transport kolejowy.
MONORAIL Kolej jednoszynowa.
OTHER Pozostałe pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka zbiorowa to typ autobusu umożliwiający zaparkowanie i podwiezienie pasażerów w dowolnym miejscu na trasie.
SUBWAY Podziemna kolejka.
TRAM Kolej linowa naziemna.
TROLLEYBUS Trolejbus.

Jednostki

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

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

Zbiór wartości opisujących rodzaj emisji spalin w pojeździe. Dotyczy tylko: DRIVE RouteTravelMode.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Wartość domyślna: GASOLINE.
GASOLINE Pojazd na benzynę lub benzynę.
ELECTRIC Pojazd napędzany prądem.
HYBRID Pojazd napędzany paliwem hybrydowym (np. benzynowym i elektrycznym).
DIESEL Pojazd na olej napędowy.

VehicleInfo

Zawiera informacje o pojeździe, takie jak typ emisji.

Pola
emission_type

VehicleEmissionType

Opisuje emisyjność pojazdu. Dotyczy tylko: DRIVE RouteTravelMode.

Punkt pośredni

Obejmuje punkt pośredni. Punkty pośrednie oznaczają początek i koniec trasy, a także między innymi pośrednie przystanki.

Pola
via

bool

Oznacza ten punkt na drodze jako kamień milowy, a raczej punkt pośredni. W przypadku każdego punktu pośredniego nieprzeznaczonego w żądaniu odpowiedź zawiera wpis do tablicy legs, który zawiera szczegóły międzylądowań na danym etapie podróży. Ustaw tę wartość na true, jeśli chcesz, aby trasa przechodziła przez ten punkt na trasie bez zatrzymywania się. Punkty na trasie nie powodują dodania wpisu do tablicy legs, ale stanowią trasę przez punkt pośredni. Tę wartość możesz ustawić tylko dla punktów pośrednich będących pośrednimi. Żądanie nie powiedzie się, jeśli ustawisz to pole na końcowych punktach pośrednich. 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 pośredni jest przeznaczony dla pojazdów do zatrzymania się i tam, gdzie mają być podwiezienie lub wysadzenie. 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 oddania. Ta opcja działa tylko w trybach DRIVE i TWO_WHEELER, a location_type ma wartość Location.
side_of_road

bool

Wskazuje, że lokalizacja tego punktu pośredniego ma umożliwiać zatrzymywanie pojazdu po określonej stronie drogi. Po ustawieniu tej wartości trasa przechodzi przez daną lokalizację, dzięki czemu pojazd może się zatrzymać na boku drogi, na którą kierowana jest ta lokalizacja, od środka drogi. Ta opcja działa tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.
Pole sumy location_type. Różne sposoby przedstawiania lokalizacji. location_type może być 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 na trasie.
address

string

Zrozumiały dla człowieka adres lub kod plus. Więcej informacji znajdziesz na stronie https://plus.codes.