Package google.maps.routing.v2

Indeks

Trasy

Interfejs Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Na przykład w tej metodzie:

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

Bardzo ważne jest, aby do maski pola dodać atrybut status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyglądały poprawnie. Odradzamy używanie maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wyniki z krótszym czasem oczekiwania.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać dłuższego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się zmniejszyć, ponieważ nowe pola, które dodamy, będą automatycznie uwzględniane w odpowiedzi.
  • Jeśli wybierzesz tylko te pola, których potrzebujesz, rozmiar odpowiedzi będzie mniejszy, a tym samym większa przepustowość sieci.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Na przykład w tej metodzie:

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

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

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wyniki z krótszym czasem oczekiwania.
  • Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać dłuższego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się zmniejszyć, ponieważ nowe pola, które dodamy, będą automatycznie uwzględniane w odpowiedzi.
  • Jeśli wybierzesz tylko te pola, których potrzebujesz, rozmiar odpowiedzi będzie mniejszy, a tym samym większa przepustowość sieci.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

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

  • Suma liczby miejsc wylotu + liczba miejsc docelowych określonych jako place_id lub address nie może być większa niż 50.
  • Iloczyn liczby punktów początkowych × liczba miejsc docelowych w żadnym przypadku nie może przekraczać 625.
  • Iloczyn liczby źródeł × liczba miejsc docelowych nie może być większy niż 100, jeśli ustawienie routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL.
  • Iloczyn liczby punktów początkowych × liczba miejsc docelowych nie może być większy niż 100, jeśli wartość atrybutu Travel_mode ma wartość TRANSIT.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

Opcjonalnie: Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie przyjęta data przesłania żądania. UWAGA: pole departure_time z przeszłości możesz określić tylko wtedy, gdy opcja RouteTravelMode ma wartość TRANSIT.
arrival_time

Timestamp

Opcjonalnie: Godzina przyjazdu. UWAGA: ten parametr można ustawić tylko wtedy, gdy zasada RouteTravelMode ma wartość TRANSIT. Możesz określić departure_time lub arrival_time, ale nie oba jednocześnie.
language_code

string

Opcjonalnie: Kod języka BCP-47, na przykład „en-US”. czy „sr-Latn”. Więcej informacji znajdziesz w sekcji Identyfikator języka Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania będzie ustalany na podstawie lokalizacji pierwszego punktu początkowego.
region_code

string

Opcjonalnie: Kod regionu określony jako dwuznakowa wartość domeny ccTLD („domeny najwyższego poziomu”). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych.
extra_computations[]

ExtraComputation

Opcjonalnie: Lista dodatkowych obliczeń, które mogą zostać wykorzystane do wykonania żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być również określone w masce pola, aby została zwrócona w odpowiedzi.
traffic_model

TrafficModel

Opcjonalnie: Określa założenia, które należy zastosować przy obliczaniu czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polu RouteMatrixElement, które zawiera przewidywany czas ruchu określony na podstawie średnich wartości historycznych. RoutingPreference do TRAFFIC_AWARE_OPTIMAL i RouteTravelMode do DRIVE. Domyślna wartość to BEST_GUESS, jeśli żądanie dotyczy ruchu, a TrafficModel nie jest określony.
transit_preferences

TransitPreferences

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

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość zakończą się niepowodzeniem.
TOLLS Informacje o opłatach za elementy macierzy.

ComputeRoutesRequest

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

Wymagane. Punkt pośredni na trasie.
destination

Waypoint

Wymagane. Docelowy punkt na trasie.
intermediates[]

Waypoint

Opcjonalnie: Zestaw punktów na trasie (z wyłączeniem punktów końcowych) do zatrzymania się na lub przejechania. Obsługiwane jest maksymalnie 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ć wybranego ustawienia routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
polyline_quality

PolylineQuality

Opcjonalnie: Określa 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ślnie będzie przyjęta data przesłania żądania. UWAGA: pole departure_time z przeszłości możesz określić tylko wtedy, gdy opcja RouteTravelMode ma wartość TRANSIT. Podróże transportem publicznym mogą obejmować maksymalnie 7 dni wstecz lub 100 dni do przodu.
arrival_time

Timestamp

Opcjonalnie: Godzina przyjazdu. UWAGA: ten parametr można ustawić tylko wtedy, gdy zasada RouteTravelMode ma wartość TRANSIT. Możesz określić departure_time lub arrival_time, ale nie oba jednocześnie. Podróże transportem publicznym mogą obejmować maksymalnie 7 dni wstecz lub 100 dni do przodu.
compute_alternative_routes

bool

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

RouteModifiers

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

string

Opcjonalnie: Kod języka BCP-47, na przykład „en-US”. czy „sr-Latn”. Więcej informacji znajdziesz w sekcji Identyfikator języka Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania będzie ustalany na podstawie lokalizacji żądania trasy.
region_code

string

Opcjonalnie: Kod regionu określony jako dwuznakowa wartość domeny ccTLD („domeny najwyższego poziomu”). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu.
units

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Te pola obejmują pole instruction w elemencie NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary stosowane dla trasy, odcinka, dystansu ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki zostaną ustalone na podstawie lokalizacji pierwszego punktu początkowego.
optimize_waypoint_order

bool

Opcjonalnie: Jeśli zasada ma wartość true (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 pośrednim via. Aby znaleźć nowe kolejność, użyj funkcji ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index. Jeśli w nagłówku X-Goog-FieldMask nie jest żądane ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli optimize_waypoint_order ma wartość Fałsz, pole ComputeRoutesResponse.optimized_intermediate_waypoint_index jest puste.
requested_reference_routes[]

ReferenceRoute

Opcjonalnie: Określa, które trasy referencyjne mają zostać obliczone w ramach żądania, oprócz trasy domyślnej. Trasa referencyjna to trasa z innym celem obliczenia trasy niż domyślna. Na przykład podczas obliczania trasy referencyjnej FUEL_EFFICIENT uwzględniane są różne parametry, które mogą wygenerować optymalną trasę z najniższym spalaniem.
extra_computations[]

ExtraComputation

Opcjonalnie: Lista dodatkowych obliczeń, które mogą zostać wykorzystane do wykonania żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być również określone w masce pola, aby została zwrócona w odpowiedzi.
traffic_model

TrafficModel

Opcjonalnie: Określa założenia stosowane przy obliczaniu czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polach Route i RouteLeg, które zawierają przewidywany czas ruchu określony na podstawie średnich wartości historycznych. Funkcja TrafficModel jest dostępna tylko w przypadku żądań, w których wartość RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a RouteTravelMode na DRIVE. Domyślna wartość to BEST_GUESS, jeśli wymagane jest ruch, a TrafficModel nie jest określony.
transit_preferences

TransitPreferences

Opcjonalnie: Określa preferencje, które mają wpływ na trasę zwracaną dla TRANSIT tras. UWAGA: pole 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żywane. Żądania zawierające tę wartość zakończą się niepowodzeniem.
TOLLS Informacje o opłatach na trasach.
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasach.
TRAFFIC_ON_POLYLINE Na trasach występują linie łamane z informacją o natężeniu ruchu.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions w postaci sformatowanego ciągu tekstowego HTML. Tę treść należy czytać w takiej postaci, w jakiej jest. Ta treść jest przeznaczona tylko do wyświetlania. Nie analizuj go automatycznie.

ReferenceRoute

Obsługiwana trasa referencyjna w ComputeRoutesRequest.

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

ComputeRoutesResponse

ComputeRoute zarządza komunikatem z odpowiedzią.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), jeśli została określona jako compute_alternatives_routes, oraz zawiera tylko jedną trasę, jeśli nie jest. Jeśli 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źć trasy.
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć wyników trasy przy wszystkich podanych preferencjach wejściowych, może użyć innego sposobu 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 informacje o odpowiedzi na geokodowanie dla punktów pośrednich określonych jako adresy.

FallbackInfo

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

Pola
routing_mode

FallbackRoutingMode

Tryb routingu używany w odpowiedzi. Jeśli aktywowano działanie kreacji zastępczej, tryb może się różnić od ustawienia routingu ustawionego w pierwotnym żądaniu klienta.
reason

FallbackReason

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

FallbackReason

Powody używania odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie określono przyczyny kreacji zastępczej.
SERVER_ERROR Podczas obliczania trasy w preferowanym trybie routingu wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony przez inny tryb.
LATENCY_EXCEEDED Nie udało nam się na czas ukończyć obliczeń przy użyciu preferowanego trybu routingu, ale udało nam się zwrócić wynik obliczony w innym trybie.

FallbackRoutingMode

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

Wartości w polu enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Nieużywane.
FALLBACK_TRAFFIC_UNAWARE Wskazuje, że do obliczenia odpowiedzi użyto elementu RoutingPreference typu TRAFFIC_UNAWARE.
FALLBACK_TRAFFIC_AWARE Wskazuje, że do obliczenia odpowiedzi użyto elementu RoutingPreference typu TRAFFIC_AWARE.

GeocodedWaypoint

Szczegółowe informacje o lokalizacjach używanych jako punkty pośrednie. Wartość podawana tylko w przypadku punktów pośrednich związanych z adresem. Zawiera szczegółowe informacje o wynikach geokodowania, które pomogą nam określić, do czego został przekonwertowany adres.

Pola
geocoder_status

Status

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

string

Typy wyniku w postaci zero 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. Możesz sprawdzić, czy pierwotne zgłoszenie nie zawiera błędów pisowni ani niekompletnych adresów.
place_id

string

Identyfikator miejsca powiązany z tym wynikiem.
intermediate_waypoint_request_index

int32

Indeks odpowiedniego pośredniego punktu pośredniego w żądaniu. Wartość podawana tylko wtedy, gdy odpowiedni punkt na trasie jest pośrednim punktem pośrednim.

GeocodingResults

Zawiera GeocodedWaypoints dla punktów początkowych, docelowych i pośrednich. Wartość podawana tylko w przypadku punktów pośrednich związanych z adresem.

Pola
origin

GeocodedWaypoint

Geokodowany punkt pośredni wyznaczający punkt początkowy.
destination

GeocodedWaypoint

Geokodowany punkt pośredni miejsca docelowego.
intermediates[]

GeocodedWaypoint

Lista pośrednich, geokodowanych punktów pośrednich zawierających pole indeksu odpowiadające pozycji punktu pośredniego (od zera) w kolejności, w jakiej zostały określone w żądaniu.

LocalizedTime

Zlokalizowany opis czasu.

Pola
time

LocalizedText

Czas określony jako ciąg znaków w danej strefie czasowej.
time_zone

string

Zawiera strefę czasową. Wartość jest nazwą strefy czasowej zgodnie z definicją w bazie danych stref czasowych IANA, np. „Ameryka/Nowy_Jork”.

Lokalizacja

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

Pola
lat_lng

LatLng

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

Int32Value

Nagłówek kompasu powiązany z kierunkiem ruchu. Ta wartość określa po stronie drogi, po której na miejscu będzie można wsiąść i wsiąść. Wartości nagłówka mogą należeć do zakresu od 0 do 360, gdzie 0 oznacza kierunek północny, 90 kierunek kierunku wschodu itd. Możesz użyć tego pola tylko w przypadku pól DRIVE i TWO_WHEELER RouteTravelMode.

Skręt

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

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywane.
TURN_SLIGHT_LEFT Obróć się lekko w lewo.
TURN_SHARP_LEFT Skręć ostro w lewo.
UTURN_LEFT Zawróć w lewo.
TURN_LEFT Skręć w lewo.
TURN_SLIGHT_RIGHT 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 w prawo.
MERGE Scalanie w ruch.
FORK_LEFT Skręć w lewy rozwidlenie.
FORK_RIGHT Skręć w prawy widelec.
FERRY Przeprawa promowa.
FERRY_TRAIN Wsiądź do pociągu kursującego na prom.
ROUNDABOUT_LEFT Skręć w lewo na rondzie.
ROUNDABOUT_RIGHT Skręć w prawo na rondzie.
DEPART Manewr początkowy.
NAME_CHANGE Służy do wskazywania zmiany nazwy ulicy.

Obejmuje instrukcje nawigacji dla 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 dotyczące poruszania się po tym kroku.

Linia łamana

Oznacza 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 znaków w linii łamanej za pomocą algorytmu kodowania linii łamanej
geo_json_linestring

Struct

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

PolylineEncoding

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

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

PolylineQuality

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

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji jakości linii łamanej. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa wysokiej jakości linię łamaną, która składa się z większej liczby punktów niż OVERVIEW, ale kosztem zwiększonego rozmiaru odpowiedzi. Użyj tej wartości, jeśli 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 do wyświetlania ogólnego widoku trasy. Ta opcja wiąże się z krótszym czasem oczekiwania na żądanie w porównaniu z opcją HIGH_QUALITY.

Trasa

Zawiera trasę, która składa się z kilku połączonych fragmentów drogi, które łączą punkt początkowy, końcowy i pośredni.

Pola
route_labels[]

RouteLabel

Etykiety obiektu Route, które służą do identyfikowania określonych właściwości trasy w celu porównania jej z innymi.
legs[]

RouteLeg

Zbiór nóg (odcinków ścieżki między punktami pośrednimi), z których składa się trasa. Każdy odcinek odpowiada podróży między dwoma drogami innymi niż via Waypoints. Na przykład trasa bez pośrednich punktów pośrednich ma tylko jeden etap. Trasa obejmująca jeden punkt pośredni inny niż via ma dwie nogi. Trasa obejmująca 1 pośredni punkt na trasie via, ma 1 etap. Kolejność etapów odpowiada kolejności punktów na trasie od origin do intermediates do destination.
distance_meters

int32

Odległość przebyta trasa w metrach.
duration

Duration

Czas potrzebny na nawigowanie 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, ta wartość jest obliczana z uwzględnieniem warunków na drodze.
static_duration

Duration

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

Polyline

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

string

Opis trasy.
warnings[]

string

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

Viewport

Ramka ograniczająca widoczny obszar linii łamanej.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.
optimized_intermediate_waypoint_index[]

int32

Jeśli ustawisz optimize_waypoint_order na wartość true, to pole zawiera zoptymalizowaną kolejność pośrednich punktów pośrednich. W przeciwnym razie to pole jest puste. Jeśli na przykład podasz dane pochodzenia: LA; Punkty pośrednie: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork; a zoptymalizowana kolejność pośrednich punktów pośrednich to Phoenix, Dallas, Bangor. To pole zawiera wartości [2, 0, 1]. Indeks rozpoczyna się od 0 dla pierwszego pośredniego punktu pośredniego podanego w danych wejściowych.
localized_values

RouteLocalizedValues

Tekstowe przedstawienie właściwości elementu Route.
route_token

string

Zakodowany w internecie token trasy zakodowany w base64, który można przekazać do pakietu Navigation SDK, który umożliwia pakietowi Navigation SDK zrekonstruowanie trasy podczas nawigacji, a w przypadku ponownego wyznaczania trasy — zgodnie z pierwotną intencją utworzoną przez Ciebie przez wywołanie ComputeRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob. Nie porównuj jego wartości w poszczególnych żądaniach – ten token może się zmienić, nawet jeśli zwrócona zostanie dokładnie ta sama trasa. UWAGA: funkcja Route.route_token jest dostępna tylko w przypadku żądań, w których pole ComputeRoutesRequest.routing_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Pole Route.route_token nie jest obsługiwane w przypadku żądań z punktami pośrednimi Via.

RouteLocalizedValues

Tekstowe przedstawienie określonych usług.

Pola
distance

LocalizedText

Odległość podróży w formie tekstowej.
duration

LocalizedText

Czas trwania z uwzględnieniem warunków na drodze, wyrażony w formie tekstowej. Uwaga: jeśli żądanie informacji o ruchu nie zostało wysłane, ta wartość będzie mieć taką samą wartość jak static_duration.
static_duration

LocalizedText

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

LocalizedText

Cena za transport publiczny w formie tekstowej.

RouteLabel

Etykiety obiektu Route, które służą do identyfikowania określonych właściwości trasy w celu porównania jej z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślnie – nieużywane.
DEFAULT_ROUTE Wartość domyślna „najlepszy”. zwracaną na potrzeby obliczenia trasy.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnego „najlepszego” . Tego typu trasy zostaną zwrócone, gdy określisz wartość compute_alternative_routes.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są uznane za zoptymalizowane pod kątem parametrów Eko, takich jak zużycie paliwa.

RouteLeg

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

Pola
distance_meters

int32

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

Duration

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

Duration

Długość odcinka obliczona bez uwzględniania warunków na drodze.
polyline

Polyline

Ogólna linia łamana dla tego odcinka, która zawiera linię łamaną każdej step.
start_location

Location

Lokalizacja początkowa tego odcinka. Ta lokalizacja może się różnić od lokalizacji wskazanej w lokalizacji origin. Jeśli na przykład podany obiekt origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.
end_location

Location

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

RouteLegStep

Tablica kroków oznaczająca 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. o ewentualnych ograniczeniach dotyczących strefy ruchu na danym etapie trasy.
localized_values

RouteLegLocalizedValues

Tekstowe przedstawienie właściwości elementu RouteLeg.
steps_overview

StepsOverview

Omówienie kroków w tym RouteLeg. To pole jest wypełniane tylko w przypadku tras TRANSIT.

RouteLegLocalizedValues

Tekstowe przedstawienie określonych usług.

Pola
distance

LocalizedText

Odległość podróży w formie tekstowej.
duration

LocalizedText

Czas trwania z uwzględnieniem warunków na drodze wyrażony w formie tekstowej. Uwaga: jeśli żądanie informacji o ruchu nie zostało wysłane, ta wartość będzie mieć taką samą wartość jak parametr static_duration.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drodze, wyrażony w formie tekstowej.

StepsOverview

Udostępnia przegląd informacji na temat listy elementów RouteLegStep.

Pola
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

Zawiera podsumowanie informacji o różnych segmentach multimodalnych w RouteLeg.steps. Segment multimodalny to co najmniej jeden ciągły element typu RouteLegStep o tym samym identyfikatorze RouteTravelMode. To pole nie jest wypełniane, jeśli w krokach RouteLeg nie zawiera żadnych segmentów multimodalnych.

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 jest końcem segmentu multimodalnego.

RouteLegStep

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

Pola
distance_meters

int32

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

Duration

Długość tej drogi bez uwzględnienia 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. o ewentualnych ograniczeniach związanych z ruchem drogowym, na etapie schodów.
localized_values

RouteLegStepLocalizedValues

Tekstowe przedstawienie właściwości elementu RouteLegStep.
transit_details

RouteLegStepTransitDetails

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

RouteTravelMode

Tryb podróży użyty w tym kroku.

RouteLegStepLocalizedValues

Tekstowe przedstawienie określonych usług.

Pola
distance

LocalizedText

Odległość podróży w formie tekstowej.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drodze, wyrażony w formie tekstowej.

RouteLegStepTransitDetails

Dodatkowe informacje o: RouteLegStep związane z trasami (TRANSIT).

Pola
stop_details

TransitStopDetails

Informacje o przystankach na tym etapie.
localized_values

TransitDetailsLocalizedValues

Tekstowe przedstawienie właściwości elementu RouteLegStepTransitDetails.
headsign

string

Określa kierunek, w jakim należy poruszać się po tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku. Kierunek ruchu często prowadzi do stacji końcowej.
headway

Duration

Określa oczekiwaną godzinę jako czas między odjazdami z tego samego przystanku w tym samym czasie. Jeśli na przykład spóźnisz się na autobus, czas oczekiwania wynosi 600 sekund, a przejazd może potrwać 10 minut.
transit_line

TransitLine

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

int32

Liczba przystanków od startu do przystanku. Ta liczba uwzględnia przystanek, ale nie uwzględnia przystanku odjazdu. Jeśli na przykład trasa zjeżdża z przystanku A, mija przystanki B i C i dotrze na przystanek D, wartość stop_count zwróci wartość 3.
trip_short_text

string

Tekst wyświetlany w rozkładach jazdy i tablicach informacyjnych, które umożliwiają identyfikację podróży tranzytem dla pasażerów. Tekst powinien jednoznacznie identyfikować podróż w danym dniu obsługi klienta. Przykład: „538”. to trip_short_text pociągu Amtrak, który odjeżdża z San Jose w Kalifornii o 15:10 w dni robocze do Sacramento w Kalifornii.

TransitDetailsLocalizedValues

Zlokalizowane opisy wartości dla: RouteTransitDetails.

Pola
arrival_time

LocalizedTime

Czas w sformatowanym tekście z odpowiednią strefą czasową.
departure_time

LocalizedTime

Czas w sformatowanym tekście z odpowiednią strefą czasową.

TransitStopDetails

Szczegółowe informacje o przystankach transportu publicznego: RouteLegStep.

Pola
arrival_stop

TransitStop

Informacje o przystanku na przyjazd dla tego kroku.
arrival_time

Timestamp

Szacowany czas dotarcia na miejsce.
departure_stop

TransitStop

Informacje o przystanku odjazdu na tym etapie.
departure_time

Timestamp

Przewidywany czas wyjazdu 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 schodach, np. możliwe ograniczenia strefy ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na konkretnym: RouteLeg. To pole jest wypełnione tylko wtedy, gdy przewidujemy, że na: RouteLeg będą naliczane opłaty. Jeśli to pole jest skonfigurowane, ale pole podrzędne suggested_price nie jest wypełnione, można oczekiwać, że na drodze są opłaty, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, RouteLeg nie pobiera opłat.
speed_reading_intervals[]

SpeedReadingInterval

Interwały szybkiego odczytywania z informacjami o gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną RouteLeg bez nakładania się. Punkt początkowy określonego interwału jest taki sam jak punkt końcowy poprzedniego interwału.

Przykład:

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

RouteMatrixDestination

Jedno miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Docelowy punkt na trasie

RouteMatrixElement

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

Pola
status

Status

Kod stanu błędu tego elementu.
condition

RouteMatrixElementCondition

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

int32

Odległość przebyta trasa w metrach.
duration

Duration

Czas potrzebny na nawigowanie 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, ta wartość jest obliczana z uwzględnieniem warunków na drodze.
static_duration

Duration

Długość trasy bez uwzględnienia 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 jest w stanie obliczyć trasy przy określonych preferencjach dla danej pary punktu początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.
localized_values

LocalizedValues

Tekstowe przedstawienie właściwości elementu RouteMatrixElement.
origin_index

int32

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

int32

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

LocalizedValues

Tekstowe przedstawienie określonych usług.

Pola
distance

LocalizedText

Odległość podróży w formie tekstowej.
duration

LocalizedText

Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie wysłano żądania informacji o ruchu, ta wartość ma taką samą wartość jak parametr static_duration.
static_duration

LocalizedText

Czas trwania wyrażony w formie tekstowej bez uwzględnienia warunków na drodze.
transit_fare

LocalizedText

Cena za transport publiczny w formie tekstowej.

RouteMatrixElementCondition

Stan zwracanej trasy.

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

RouteMatrixOrigin

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

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

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

RouteModifiers

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

Pola
avoid_tolls

bool

Jeśli zasada ma wartość Prawda, w miarę możliwości omija drogi płatne, traktując priorytetowo trasy, które nie zawierają dróg płatnych. Ma zastosowanie tylko do DRIVE i TWO_WHEELER RouteTravelMode.
avoid_highways

bool

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

bool

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

bool

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

VehicleInfo

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

TollPass

Obejmuje informacje o winietach. Jeśli podano winiety na opłaty, interfejs API spróbuje zwrócić ich cenę. Jeśli nie podasz winiet, interfejs API traktuje je jako nieznane i próbuje zwrócić kwotę pieniężną. Ma zastosowanie tylko do DRIVE i TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

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

Pola
toll_info

TollInfo

Zawiera informacje o opłatach drogowych na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie należy spodziewać się opłat. Jeśli to pole jest skonfigurowane, ale pole podrzędne estimatedPrice nie jest wypełnione, trasa zawiera opłaty drogowe, ale szacowana cena jest nieznana. Jeśli to pole nie jest skonfigurowane, na trasie nie są wymagane żadne opłaty.
speed_reading_intervals[]

SpeedReadingInterval

Interwały szybkiego odczytywania z informacjami o 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 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

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

Money

Zawiera łączną cenę lub koszty biletu na tej trasie. Ta właściwość jest zwracana tylko w przypadku żądań TRANSIT i tylko w przypadku tras, dla których dostępne są informacje o cenie dla wszystkich etapów transportu publicznego.

RouteTravelMode

Zbiór wartości używanych do określenia środka transportu. UWAGA: trasy WALK, BICYCLE i TWO_WHEELER są w wersji beta i czasami nie ma wyraźnych chodników, ścieżek dla pieszych lub ścieżek rowerowych. Musisz wyświetlać to ostrzeżenie w przypadku wszystkich tras pieszych, rowerowych lub motocyklowych 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 osobowym.
BICYCLE Podróż rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Dwukołowy pojazd silnikowy. Na przykład motocykl. Pamiętaj, że różni się to od środka transportu BICYCLE, który obejmuje tryb zasilany przez człowieka.
TRANSIT podróżować trasami transportu publicznego (jeśli są dostępne);

RoutingPreference

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślna wartość to TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględnienia aktualnych warunków drogowych. Przydatne, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości pozwala zminimalizować opóźnienie. Uwaga: w przypadku RouteTravelMode, DRIVE i TWO_WHEELER trasa i czas trwania zależą od sieci drogowej i średnich warunków drogowych w danym czasie, a nie od bieżących warunków drogowych. Dlatego trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki danego żądania mogą się z czasem zmieniać ze względu na zmiany w sieci drogowej, zaktualizowane średnie warunki drogowe i rozproszony charakter usługi. Wyniki mogą też w każdej chwili różnić się w przypadku zbliżonych tras.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem bieżących warunków drogowych. W przeciwieństwie do zasady TRAFFIC_AWARE_OPTIMAL stosowane są niektóre optymalizacje w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy z uwzględnieniem rzeczywistego ruchu bez stosowania większości optymalizacji wydajności. Użycie tej wartości powoduje największe opóźnienie.

SpeedReadingInterval

Wskaźnik natężenia ruchu na przyległym odcinku linii łamanej lub ścieżki. Dla ścieżki z punktami P_0, P_1, ... , P_N (indeks liczony od zera) funkcja SpeedReadingInterval definiuje przedział i opisuje ruch przy użyciu następujących kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału w linii łamanej.
end_polyline_point_index

int32

Indeks końcowy tego przedziału na linii łamanej.

Pole sumy speed_type.

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

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

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

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

TollInfo

Obejmuje informacje o opłatach z Route lub RouteLeg.

Pola
estimated_price[]

Money

Kwota opłat drogowych za: Route lub RouteLeg. Ta lista zawiera kwotę pieniężną w każdej walucie, która ma być pobierana przez stacje poboru opłat. Zwykle lista zawiera tylko jeden element w przypadku tras z opłatami za przejazd w jednej walucie. W przypadku podróży międzynarodowych ta lista może zawierać wiele pozycji w odniesieniu do opłat drogowych w różnych walutach.

TollPass

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

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywane. Jeśli zostanie użyta ta wartość, żądanie zakończy się niepowodzeniem.
AU_ETOLL_TAG Winieta w Sydney. Więcej informacji znajdziesz na stronie https://www.myetoll.com.au.
AU_EWAY_TAG Winieta w Sydney. Więcej informacji znajdziesz na https://www.tollpay.com.au.
AU_LINKT Winieta w całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Winieta w Argentynie. Więcej informacji znajdziesz na stronie https://telepase.com.ar.
BR_AUTO_EXPRESO winieta w Brazylii. Więcej informacji znajdziesz na https://www.autoexpreso.com.
BR_CONECTCAR winieta w Brazylii. Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS winieta w Brazylii. Więcej informacji znajdziesz na https://movemais.com.
BR_PASSA_RAPIDO winieta w Brazylii. Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR winieta w Brazylii. Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY winieta w Brazylii. Więcej informacji znajdziesz na https://taggy.com.br.
BR_VELOE winieta w Brazylii. Więcej informacji znajdziesz na https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
CA_US_BLUE_WATER_EDGE_PASS Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_NEXUS_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez wiele banków używanych do płacenia opłat. Wszystkie karty elektroniczne w bankach są rozliczane w taki sam sposób, więc potrzebna jest tylko jedna wartość wyliczeniowa. Na 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 Japan. Elektroniczny system bezprzewodowy do pobierania opłat. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Nowa wersja ETC z dodatkowymi rabatami i dwukierunkową komunikacją między urządzeniami w pojazdach i antenach na drodze. https://www.go-etc.jp/etc2/index.html
MX_IAVE Winieta 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 Meksykański wystawca winiet. Jedna z wielu placówek działających w mieście Meksyk. Więcej informacji znajdziesz na https://www.televia.com.mx.
MX_TELEVIA Meksykański wystawca winiet. Jedna z wielu placówek działających w mieście Meksyk. https://www.televia.com.mx
MX_VIAPASS Winieta 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 oprócz naklejki na pojazd czysty przez DMV (DMV) posiada też dowolny dokument FasTrak. 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 Floryda, Stany Zjednoczone.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floryda, Stany Zjednoczone.
US_FL_EPASS Floryda, Stany Zjednoczone.
US_FL_GIBA_TOLL_PASS Floryda, Stany Zjednoczone.
US_FL_LEEWAY Floryda, Stany Zjednoczone.
US_FL_SUNPASS Floryda, Stany Zjednoczone.
US_FL_SUNPASS_PRO Floryda, Stany Zjednoczone.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
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 Los Angeles, Stany Zjednoczone.
US_LA_TOLL_TAG Los Angeles, Stany Zjednoczone.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, Stany Zjednoczone.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Wycofano, ponieważ ten typ karty już nie istnieje.
US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, Stany Zjednoczone.
US_NC_EZPASSNC Karolina Północna, USA.
US_NC_PEACH_PASS Karolina Północna, USA.
US_NC_QUICK_PASS Karolina Północna, USA.
US_NH_EZPASSNH NH, Stany Zjednoczone.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stany Zjednoczone.
US_NJ_EZPASSNJ NJ, Stany Zjednoczone.
US_NY_EXPRESSPASS Nowy Jork, Stany Zjednoczone.
US_NY_EZPASSNY Nowy Jork, Stany Zjednoczone.
US_OH_EZPASSOH Ohio, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
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 Utah, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS Wirginia Zachodnia, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

Określa założenia, które należy zastosować przy obliczaniu czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu duration w odpowiedzi, która zawiera przewidywany czas ruchu na podstawie średnich wartości 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 zwrócona wartość duration powinna być najdokładniejszym szacowanym czasem podróży, biorąc pod uwagę zarówno historyczne warunki, jak i aktualne natężenie ruchu. Aktualne natężenie ruchu staje się ważniejsze, im bliżej jest departure_time.
PESSIMISTIC Wskazuje, że zwracany czas powinien być dłuższy niż rzeczywisty czas podróży w większość dni, chociaż czasami w przypadku szczególnie niekorzystnych warunków drogowych ta wartość może być większa.
OPTIMISTIC Wskazuje, że zwracany czas powinien być krótszy niż rzeczywisty czas podróży w większość dni, chociaż czasami w dni o szczególnie dobrym natężeniu ruchu może on przekraczać tę wartość.

TransitAgency

Przewoźnik obsługujący linię transportu publicznego.

Pola
name

string

Nazwa tego przewoźnika.
phone_number

string

Sformatowany dla języka numer telefonu przewoźnika.
uri

string

Identyfikator URI przewoźnika.

TransitLine

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

Pola
agencies[]

TransitAgency

Przewoźnik obsługujący tę linię transportu publicznego.
name

string

Pełna nazwa tej linii transportu publicznego, np. „ul. Główna 8”.
uri

string

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

string

Kolor często używany na oznakowaniu tej linii. Wartość szesnastkowa.
icon_uri

string

Identyfikator URI ikony powiązanej z tym wierszem.
name_short

string

Krótka nazwa tej linii transportu publicznego. Najczęściej jest to numer wiersza, np. „M7”. czy „355”.
text_color

string

Kolor często używany w tekście na oznakowaniu w tej linii. Wartość szesnastkowa.
vehicle

TransitVehicle

Typ pojazdu, który porusza się po tej linii transportu publicznego.

TransitPreferences

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

Pola
allowed_travel_modes[]

TransitTravelMode

Zestaw środków transportu do wykorzystania przy wyznaczaniu trasy TRANSIT. Domyślnie wszystkie obsługiwane środki transportu.
routing_preference

TransitRoutingPreference

Preferencje routingu, które po określeniu wpływają na zwróconą trasę TRANSIT.

TransitRoutingPreference

Określa ustawienia routingu dla tras transportu publicznego.

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

TransitTravelMode

Zbiór wartości służących do określania środka transportu.

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

TransitStop

Informacje o przystanku.

Pola
name

string

Nazwa przystanku transportu publicznego.
location

Location

Lokalizacja przystanku wyrażona we współrzędnych geograficznych.

TransitVehicle

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

Pola
name

LocalizedText

Nazwa tego 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 określany na podstawie lokalnego znaku transportowego.

TransitVehicleType

Typ pojazdów na potrzeby tras transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywane.
BUS Autobus.
CABLE_CAR Pojazd poruszający się po kablu, zwykle na ziemi. Kolejki linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Prom.
FUNICULAR Pojazd wciągany po stromym wzniesieniu za pomocą kabla. Kolej linowo-terenowa składa się zazwyczaj z dwóch wagonów, z których każdy stanowi przeciwwagę dla drugiego.
GONDOLA_LIFT Kolej gondolowa.
HEAVY_RAIL Ciężka linia kolejowa.
HIGH_SPEED_TRAIN Szybki pociąg.
INTERCITY_BUS Autobus dalekobieżny.
LONG_DISTANCE_TRAIN Pociąg dalekobieżny.
METRO_RAIL Kolej miejska.
MONORAIL Kolej jednoszynowa.
OTHER Wszystkie inne pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka zbiorowa to rodzaj autobusu, który pozwala wsiąść i odebrać pasażerów w dowolnym miejscu na trasie.
SUBWAY Podziemna kolej miejska.
TRAM Kolej miejska.
TROLLEYBUS Trolejbus.

Jednostki

Zbiór wartości, które określają jednostkę miary używaną na wyświetlaczu.

Wartości w polu enum
UNITS_UNSPECIFIED Nie określono jednostek miary. Przyjmuje wartość domyślną jednostki miary ustalonej na podstawie żądania.
METRIC Metryczne jednostki miary.
IMPERIAL Imperialne (w języku angielskim) jednostki miary.

VehicleEmissionType

Zbiór wartości opisujących typ emisji spalin pojazdu. Dotyczy tylko DRIVE RouteTravelMode.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Domyślna wartość to GASOLINE.
GASOLINE Pojazd benzynowy lub benzynowy.
ELECTRIC Pojazd napędzany prądem.
HYBRID Pojazd na paliwo hybrydowe (np. benzynowy i elektryczny).
DIESEL Pojazd z silnikami Diesla.

VehicleInfo

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

Pola
emission_type

VehicleEmissionType

Opisuje typ emisji dwutlenku węgla w pojeździe. Dotyczy tylko DRIVE RouteTravelMode.

Punkt pośredni

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

Pola
via

bool

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

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, na których się zatrzymują, gdzie celem jest wysyłkę lub wyjazd. Gdy ustawisz tę wartość, obliczona trasa nie będzie uwzględniać punktów pośrednich innych niż via na drogach, które nie nadają się do wsiąść i wysiąść. Ta opcja działa tylko w przypadku środków transportu DRIVE i TWO_WHEELER, a location_type ma wartość Location.
side_of_road

bool

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

Location

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

string

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

string

Zrozumiały dla człowieka adres lub kod plus. Szczegółowe informacje znajdziesz na stronie https://plus.codes.