Package google.maps.routing.v2

Indeks

Trasy

Interfejs Routes API.

Tablica tras tras Compute

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Pobiera listę źródeł i miejsc docelowych oraz zwraca strumień zawierający informacje o trasie dla każdej kombinacji tych miejsc.

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ścią jest rozdzielona przecinkami lista ścieżek pól. Zapoznaj się ze szczegółowymi informacjami o tworzeniu ścieżek pól.

W ten sposób:

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

Bardzo ważne jest umieszczenie właściwości status w masce pól, ponieważ w przeciwnym razie wszystkie wiadomości będą prawidłowe. Google odradza stosowanie maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybór tylko potrzebnych pól pomoże naszemu serwerowi w zapisywaniu cykli obliczeniowych, co pozwoli nam szybciej zwracać wyniki.
  • Wybranie tylko pól potrzebnych w zadaniu produkcyjnym zapewnia stabilne opóźnienie. W przyszłości możemy dodać więcej pól odpowiedzi, które będą wymagać dodatkowego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się pogorszyć, ponieważ wszystkie nowe pola będą automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym większej przepustowości sieci.
Trasy Compute

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca trasę główną i opcjonalne trasy alternatywne ze względu na zestaw 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ć przy użyciu parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry i nagłówki adresów URL). Wartością jest rozdzielona przecinkami lista ścieżek pól. Zapoznaj się ze szczegółową dokumentacją tworzenia ścieżek pól.

W ten sposób:

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

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

  • Wybór tylko potrzebnych pól pomoże naszemu serwerowi w zapisywaniu cykli obliczeniowych, co pozwoli nam szybciej zwracać wyniki.
  • Wybranie tylko pól potrzebnych w zadaniu produkcyjnym zapewnia stabilne opóźnienie. W przyszłości możemy dodać więcej pól odpowiedzi, które będą wymagać dodatkowego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, wydajność może się pogorszyć, ponieważ wszystkie nowe pola będą automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym większej przepustowości sieci.

Żądanie ComputeRouteMatrix

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

Wymagany. Tablica źródeł, która określa wiersze macierzy odpowiedzi. Na mocy zbioru miejsc docelowych i miejsc docelowych stosowanych jest kilka ograniczeń rozmiaru:

  • Suma liczby miejsc początkowych + liczby miejsc docelowych określonych jako place_id lub address nie może być większa niż 50.
  • Iloczyn liczby miejsc wylotu × miejsc docelowych nie może być większy niż 625.
  • Iloczyn liczby punktów początkowych × liczba miejsc docelowych nie może być większy niż 100, jeśli routing wyznaczony jest na TRAFFIC_AWARE_OPTIMAL.
  • Iloczyn liczby miejsc początkowych × liczby miejsc docelowych nie może być większy niż 100, jeśli tryb Travel_mode ma wartość TRANSIT.
destinations[]

RouteMatrixDestination

Wymagany. Tablica miejsc docelowych, które określają kolumny macierzy odpowiedzi.

travel_mode

RouteTravelMode

Opcjonalnie. Określa środek transportu.

routing_preference

RoutingPreference

Opcjonalnie. Określa sposób wyznaczania trasy. Serwer spróbuje użyć wybranej preferencji routingu do obliczenia trasy. Jeśli ustawienie routingu skutkuje błędem lub bardzo długim czasem 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, będzie ona domyślna dla daty wysłania żądania. UWAGA: wartość departure_time możesz określić tylko w przeszłości, gdy pole RouteTravelMode ma wartość TRANSIT.

arrival_time

Timestamp

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

language_code

string

Opcjonalnie. Kod języka BCP-47, na przykład „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Listę obsługiwanych języków znajdziesz na stronie obsługi języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie ustalony na podstawie lokalizacji pierwszego źródła.

region_code

string

Opcjonalnie. Kod regionu określony jako ccTLD („domena najwyższego poziomu”) – dwuznakowa wartość. Więcej informacji znajdziesz na stronie https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

extra_computations[]

ExtraComputation

Opcjonalnie. Lista dodatkowych obliczeń, których można użyć do zrealizowania żądania. Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola odpowiedzi. Te dodatkowe pola muszą być również określone w masce pola, która ma być zwrócona w odpowiedzi.

traffic_model

TrafficModel

Opcjonalnie. Określa założenia służące do obliczania czasu ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polu RouteMatrixElement, która zawiera przewidywany czas określony na podstawie średnich wartości historycznych. RoutingPreference do TRAFFIC_AWARE_OPTIMAL i RouteTravelMode do DRIVE. Jeśli żądanie jest wymagane, a ruch TrafficModel nie jest określony, przyjmuje wartość domyślną BEST_GUESS.

transit_preferences

TransitPreferences

Opcjonalnie. Określa preferencje dotyczące trasy zwróconej dla TRANSIT tras. UWAGA: wartość transit_preferences możesz określić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT.

Dodatkowe obliczenia

Dodatkowe obliczenia do wykonania w trakcie żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość będą nieudane.
TOLLS Informacje o opłatach za elementy elementów macierzy.

Żądanie ComputeRoutes

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

Wymagany. Punkt początkowy punktu początkowego.

destination

Waypoint

Wymagany. Punkt docelowy.

intermediates[]

Waypoint

Opcjonalnie. Zbiór punktów na trasie (z wyłączeniem punktów końcowych), które zatrzymują się na drodze lub je przejeżdżają. Obsługiwane jest maksymalnie 25 punktów pośrednich punktów pośrednich.

travel_mode

RouteTravelMode

Opcjonalnie. Określa środek transportu.

routing_preference

RoutingPreference

Opcjonalnie. Określa sposób wyznaczania trasy. Serwer spróbuje użyć wybranej preferencji routingu do obliczenia trasy. Jeśli ustawienie routingu skutkuje błędem lub bardzo długim czasem 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 preferencje dotyczące jakości linii łamanej.

polyline_encoding

PolylineEncoding

Opcjonalnie. Określa preferowane kodowanie linii łamanej.

departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, będzie ona domyślna dla daty wysłania żądania. UWAGA: wartość departure_time możesz określić tylko w przeszłości, gdy pole RouteTravelMode ma wartość TRANSIT.

arrival_time

Timestamp

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

compute_alternative_routes

bool

Opcjonalnie. Określa, czy oprócz trasy należy obliczać alternatywne trasy. W przypadku żądań, które mają pośrednie punkty pośrednie, nie są zwracane żadne alternatywne trasy.

route_modifiers

RouteModifiers

Opcjonalnie. Zestaw warunków, które muszą spełniać sposób obliczania tras.

language_code

string

Opcjonalnie. Kod języka BCP-47, na przykład „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Listę obsługiwanych języków znajdziesz na stronie obsługi języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie ustalony na podstawie lokalizacji w żądaniu trasy.

region_code

string

Opcjonalnie. Kod regionu określony jako ccTLD („domena najwyższego poziomu”) – dwuznakowa wartość. Więcej informacji znajdziesz na stronie https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

units

Units

Opcjonalnie. Określa jednostki miary dla wyświetlanych pól. Zawierają one pole instruction w NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary użyte w przypadku trasy, etapów, dystansu i czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki zostaną określone na podstawie lokalizacji pierwszego źródła.

optimize_waypoint_order

bool

Opcjonalnie. Jeśli ma wartość Prawda, usługa próbuje zminimalizować całkowity koszt trasy, zmieniając kolejność określonych punktów pośrednich. Żądanie nie powiedzie się, jeśli jeden z pośrednich punktów pośrednich to via punkt pośredni. Aby znaleźć nową kolejność, otwórz ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index. Jeśli żądanie ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index nie zostanie wysłane w nagłówku X-Goog-FieldMask, żądanie się nie powiedzie. Jeśli optimize_waypoint_order ma wartość Fałsz, ComputeRoutesResponse.optimized_intermediate_waypoint_index jest puste.

requested_reference_routes[]

ReferenceRoute

Opcjonalnie. Określa trasy referencyjne, które mają zostać obliczone w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to wyznaczona trasa, która ma inny cel obliczania trasy niż domyślna. Na przykład funkcja obliczania trasy referencyjnej FUEL_EFFICIENT uwzględnia różne parametry, które mogą zapewnić optymalną trasę z najniższym spalaniem.

extra_computations[]

ExtraComputation

Opcjonalnie. Lista dodatkowych obliczeń, których można użyć do zrealizowania żądania. Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola odpowiedzi. Te dodatkowe pola muszą być również określone w masce pola, która ma być zwrócona w odpowiedzi.

traffic_model

TrafficModel

Opcjonalnie. Określa założenia służące do obliczania czasu ruchu. To ustawienie wpływa na wartość zwracaną w polach czasu trwania w kolumnach Route i RouteLeg, które zawierają przewidywany czas na podstawie średnich wartości historycznych. Pole TrafficModel jest dostępne tylko w przypadku żądań, w których ustawiono RoutingPreference na TRAFFIC_AWARE_OPTIMAL, a RouteTravelMode na DRIVE. Jeśli żądanie jest wymagane, a ruch TrafficModel nie jest określony, przyjmuje wartość domyślną BEST_GUESS.

transit_preferences

TransitPreferences

Opcjonalnie. Określa preferencje dotyczące trasy zwróconej dla TRANSIT tras. UWAGA: wartość transit_preferences możesz określić tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT.

Dodatkowe obliczenia

Dodatkowe obliczenia do wykonania w trakcie żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość będą nieudane.
TOLLS Informacje o trasach drogowych.
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasach.
TRAFFIC_ON_POLYLINE Linia łamana uwzględniająca ruch na trasie.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Instrukcje nawigacji w formie sformatowanego ciągu tekstowego HTML. Treść powinna być wyświetlana w niezmienionej postaci. Tylko na potrzeby wyświetlania w sieci reklamowej. Nie analizuj go automatycznie.

Trasa referencyjna

Obsługiwana trasa referencyjna w ComputeRoutesRequest.

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

Odpowiedź ComputeRoutes

ComputeRoutes wysyła odpowiedź.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), gdy określisz parametr compute_alternatives_routes, i nie zawiera żadnej z nich. Jeśli ta tablica zawiera wiele wpisów, pierwsza z nich jest 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 ze wszystkimi ustawieniami wejścia, może skorzystać z innego sposobu obliczania danych. W trybie awaryjnym to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W innym przypadku to pole nie jest skonfigurowane.

geocoding_results

GeocodingResults

Zawiera informacje geokodowania odpowiedzi dla punktów orientacyjnych określonych jako adresy.

Informacje o kreacjach zastępczych

Informacje o tym, jak i dlaczego użyto wyniku zastępczego. Jeśli to pole jest skonfigurowane, serwer używa innego trybu routingu niż preferowany jako zastępczy.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu używany w odpowiedzi. Jeśli tryb awaryjny został aktywowany, tryb może być inny niż ustawienia routingu ustawione w pierwotnym żądaniu klienta.

reason

FallbackReason

Powód, dla którego używana była odpowiedź zastępcza zamiast pierwotnej odpowiedzi. To pole jest wypełniane tylko wtedy, gdy aktywowany jest tryb awaryjny i wyświetlona jest odpowiedź zastępcza.

Przyczyna przywracania

Przyczyny stosowania odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano powodu zastępczego.
SERVER_ERROR Podczas obliczania tras w preferowanym trybie routingu wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony przez alternatywny tryb.
LATENCY_EXCEEDED Nie udało nam się ukończyć obliczenia w wybranym trybie routingu na czas, ale udało nam się zwrócić wynik obliczony przez inny tryb.

Tryb routingu zastępczego

Rzeczywisty tryb routingu używany do zwracania odpowiedzi zastępczej.

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

Punkt geokodowania

Szczegółowe informacje o lokalizacjach używanych jako punkty na trasie. Wartość podawana tylko w przypadku punktów pośrednich adresów. Zawiera szczegółowe informacje o wynikach geokodowania, aby można było określić adres, na który został przekodowany adres.

Pola
geocoder_status

Status

Wskazuje kod stanu na podstawie operacji geokodowania.

type[]

string

Typy wyników w postaci zero lub więcej tagów typu. Obsługiwane typy: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types

partial_match

bool

Wskazuje, że geokoder nie zwrócił ścisłego pierwotnego żądania, choć mógł dopasować część żądanego adresu. Możesz sprawdzić pierwotną prośbę o weryfikację i niepoprawny adres.

place_id

string

Identyfikator miejsca tego wyniku.

intermediate_waypoint_request_index

int32

Indeks odpowiedniego pośredniego punktu pośredniego w żądaniu. Wartość wypełniana tylko wtedy, gdy odpowiadający jej punkt pośredni jest pośrednim punktem pośrednim.

Wyniki geokodowania

Zawiera GeocodedWaypoints dla punktu początkowego, docelowego i pośredniego. Wartość podawana tylko w przypadku punktów pośrednich adresów.

Pola
origin

GeocodedWaypoint

Geokod punktu początkowego punktu początkowego.

destination

GeocodedWaypoint

Geograficzne punkt docelowy punktu docelowego.

intermediates[]

GeocodedWaypoint

Lista pośrednich geokodowanych punktów pośrednich punktów orientacyjnych, które zawierają pole indeksu odpowiadające zerowej pozycji punktu na trasie w kolejności, w jakiej zostały określone w żądaniu.

Zlokalizowany czas

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ścią jest nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA (np. „Ameryka/Nowy_Jork”).

Lokalizacja

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

Pola
lat_lng

LatLng

Współrzędne geograficzne punktu na trasie.

heading

Int32Value

Nagłówek kompasu powiązany z kierunkiem ruchu. Ta wartość określa stronę drogi do odbioru i zwrotu. Wartości nagłówka mogą wynosić od 0 do 360, gdzie 0 to nagłówek o kierunku północnym, 90 nagłówek trasy wschodu itd. Tego pola możesz użyć tylko w przypadku kolumn DRIVE i TWO_WHEELER RouteTravelMode.

Skok

Zestaw wartości określających czynności nawigacyjne, które należy wykonać w bieżącym kroku (np. skręć w lewo, scalaj, prosto itd.).

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywane.
TURN_SLIGHT_LEFT Skręć lekko w lewo.
TURN_SHARP_LEFT Skręć ostro w lewo.
UTURN_LEFT Zawróć w lewo.
TURN_LEFT Skręć w lewo.
TURN_SLIGHT_RIGHT Skręć lekko w prawo.
TURN_SHARP_RIGHT Skręć ostro w prawo.
UTURN_RIGHT Zawróć w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Idź prosto.
RAMP_LEFT Wybierz lewą wjazd.
RAMP_RIGHT Wybierz właściwą wjazd.
MERGE Scal z ruchem.
FORK_LEFT Skręć w lewo.
FORK_RIGHT Wybierz właściwy rozwidlenie.
FERRY Weź prom.
FERRY_TRAIN Wsiądź do pociągu na prom.
ROUNDABOUT_LEFT Skręć w lewo na rondzie.
ROUNDABOUT_RIGHT Skręć w prawo na rondzie.
DEPART Początkowy ruch.
NAME_CHANGE Służy do zasygnalizowania zmiany nazwy ulicy.

Zawiera instrukcje nawigacji dotyczące elementu RouteLegStep

Pola
maneuver

Maneuver

Obejmuje instrukcje nawigacji w bieżącym kroku (np. obrót w lewo, scalanie, prosto itp.). To pole określa, która ikona ma być wyświetlana.

instructions

string

Instrukcje na temat poruszania się po tym kroku.

Linia łamana

Koduje łamaną łamaną.

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

string

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

geo_json_linestring

Struct

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

Kodowanie Polyline

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

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

Jakość linii łamanych

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

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości linii łamanych. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa linię łamaną o wysokiej jakości, która składa się z większej liczby punktów niż OVERVIEW kosztem zwiększonego rozmiaru odpowiedzi. Używaj tej wartości, gdy potrzebujesz większej precyzji.
OVERVIEW Określa linię łamaną przeglądu, która składa się z małej liczby punktów. Użyj tej wartości podczas wyświetlania przeglądu trasy. Użycie tej opcji skraca czas oczekiwania na wysłanie żądania w porównaniu z opcją HIGH_QUALITY.

Trasa

Zawiera trasę, która składa się z szeregu połączonych fragmentów drogi łączących początek, koniec i pośredni punkt pośredni.

Pola
route_labels[]

RouteLabel

Etykiety dla atrybutu Route przydatne do rozpoznawania określonych właściwości trasy w celu ich porównania z innymi.

legs[]

RouteLeg

Zbiór nóg (segmentów ścieżek między punktami orientacyjnymi), z których składa się trasa. Każdy etap odpowiada podróży między 2 sposób, który nie jest via Waypoints. Na przykład trasa bez pośrednich punktów pośrednich punktów trasy ma tylko jeden etap. Trasa obejmująca jeden pośredni punkt pośredni inny niż via ma dwa nogi. Trasa obejmująca jeden pośredni punkt pośredni via ma jeden odcinek. Kolejność nóg odpowiada kolejności punktów pośrednich od origin do intermediates do destination.

distance_meters

int32

Odległość trasy w metrach.

duration

Duration

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

static_duration

Duration

Czas podróży wzdłuż trasy bez uwzględnienia warunków na drodze.

polyline

Polyline

Całkowita linia łamana. Ta linia łamana jest sumą linii łamanych wszystkich legs.

description

string

Opis trasy.

warnings[]

string

Tablica ostrzeżeń do wyświetlenia trasy.

viewport

Viewport

Ramka ograniczająca widoczny na linii łamanej.

travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.

optimized_intermediate_waypoint_index[]

int32

Jeśli optimize_waypoint_order ma wartość Prawda, to pole zawiera zoptymalizowaną kolejność punktów pośrednich punktów pośrednich. W przeciwnym razie to pole jest puste. Jeśli na przykład wpiszesz Źródło: LA; Średnie punkty pośrednie: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork, a zoptymalizowany pośredni punkt pośredni 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

Tekstowe właściwości właściwości Route.

route_token

string

Bezpieczny dla internetu token zakodowany w base64, który można przekazać do pakietu SDK SDK, który umożliwia nawigację w celu odtworzenia trasy podczas nawigacji, a w przypadku zmiany trasy uwzględnia pierwotną intencję podczas tworzenia trasy przez wywoływanie ComputeRoutes. Klienci powinni traktować ten token jako nieprzezroczysty. Nie jest przeznaczona do czytania ani mutowania. UWAGA: opcja Route.route_token jest dostępna tylko w przypadku żądań z ustawieniem ComputeRoutesRequest.routing_preference ustawionym na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Pole Route.route_token nie jest obsługiwane w przypadku żądań, które mają punkty pośrednie.

Wartości RouteLocalizedValues

przedstawienie określonych właściwości tekstowych.

Pola
distance

LocalizedText

Odległość przeprowadzona w formie tekstowej.

duration

LocalizedText

Czas trwania uwzględniający warunki na drodze (podany w formie tekstowej). Uwaga: jeśli prośba o informacje o ruchu nie została wysłana przez Ciebie, ta wartość będzie taka sama jak wartość static_duration.

static_duration

LocalizedText

Czas trwania w postaci tekstu bez uwzględnienia warunków na drodze.

transit_fare

LocalizedText

Opłata za przejazd w formie tekstowej.

Etykieta trasy

Etykiety dla atrybutu Route przydatne do rozpoznawania określonych właściwości trasy w celu ich porównania z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślne – nieużywane.
DEFAULT_ROUTE Domyślna „najlepsza” trasa zwracana przy obliczaniu trasy.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnej trasy najlepszej. Trasy takie jak ta są zwracane, gdy określono 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.

Trasa

Zawiera segment między punktami orientacyjnymi innymi niż via.

Pola
distance_meters

int32

Odległość przebycia trasy w metrach.

duration

Duration

Czas potrzebny na obsługę nogi. Jeśli route_preference ma wartość TRAFFIC_UNAWARE, wartość jest taka sama jak static_duration. Jeśli route_preference to TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, wartość jest obliczana z uwzględnieniem warunków ruchu.

static_duration

Duration

Czas trwania podróży obliczony z uwzględnieniem warunków ruchu.

polyline

Polyline

Całkowita linia łamana dla tego nogi, wraz z każdą łamaną step.

start_location

Location

Punkt początkowy tego etapu. Ta lokalizacja może być inna niż podana wartość origin. Jeśli na przykład podany atrybut 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 być inna niż podana wartość destination. Jeśli na przykład podany atrybut destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.

steps[]

RouteLegStep

Tablica kroków oznaczających segmenty na tym etapie. Każdy krok przedstawia jedną instrukcję nawigacji.

travel_advisory

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien być informowany, takie jak możliwe ograniczenia strefy ruchu na danym etapie trasy.

localized_values

RouteLegLocalizedValues

Tekstowe właściwości właściwości RouteLeg.

steps_overview

StepsOverview

Informacje o czynnościach, które zawiera RouteLeg. To pole jest wypełnione tylko w przypadku tras TRANSIT.

TrasaZlokalizowanychWartości

przedstawienie określonych właściwości tekstowych.

Pola
distance

LocalizedText

Odległość przeprowadzona w formie tekstowej.

duration

LocalizedText

Czas trwania uwzględniający warunki ruchu przedstawiony w formie tekstowej. Uwaga: jeśli prośba o informacje o ruchu nie została wysłana przez Ciebie, ta wartość będzie taka sama jak wartość static_duration.

static_duration

LocalizedText

Czas trwania w postaci tekstu bez uwzględnienia warunków na drodze.

Omówienie kroków

Zawiera omówienie informacji na temat listy RouteLegStep.

Pola
multi_modal_segments[]

MultiModalSegment

Podsumowanie informacji o wielomodalnych segmentach kolumny RouteLeg.steps. To pole nie jest wypełniane, jeśli w krokach RouteLeg nie ma żadnych segmentów wielomodalnych.

Segment wielosegmentowy

Zawiera podsumowanie informacji o segmentach obejmujących wiele modułów RouteLeg.steps. Segment wielomodalny jest zdefiniowany jako co najmniej jeden ciągły ciąg znaków RouteLegStep, który ma taki sam obiekt RouteTravelMode. To pole nie jest wypełniane, jeśli w krokach RouteLeg nie ma żadnych segmentów wielomodalnych.

Pola
navigation_instruction

NavigationInstruction

Nawigacja dla segmentu wielomodalnego

travel_mode

RouteTravelMode

Tryb podróży w segmencie wielomodalnym.

step_start_index

int32

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

step_end_index

int32

Odpowiedni indeks RouteLegStep, który jest końcem segmentu wielomodalnego.

TrasaLegStep

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

Pola
distance_meters

int32

Odległość pokonana przez ten krok (w metrach). W niektórych przypadkach to pole może nie mieć wartości.

static_duration

Duration

Czas trwania tego etapu bez uwzględniania warunków na drodze. W niektórych przypadkach to pole może nie mieć wartości.

polyline

Polyline

Linia łamana powiązana z tym krokiem.

start_location

Location

Lokalizacja początkowa tego kroku.

end_location

Location

Lokalizacja końcowa tego kroku.

navigation_instruction

NavigationInstruction

Instrukcje nawigacji.

travel_advisory

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien być informowany, np. o możliwych ograniczeniach strefy ruchu na etapie kroku.

localized_values

RouteLegStepLocalizedValues

Tekstowe właściwości właściwości RouteLegStep.

transit_details

RouteLegStepTransitDetails

Szczegóły dotyczące tego kroku, jeśli środek transportu to TRANSIT.

travel_mode

RouteTravelMode

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

TrasaLegStepZlokalizowaneWartości

przedstawienie określonych właściwości tekstowych.

Pola
distance

LocalizedText

Odległość przeprowadzona w formie tekstowej.

static_duration

LocalizedText

Czas trwania w postaci tekstu bez uwzględnienia warunków na drodze.

Szczegóły trasy transportu publicznego

Dodatkowe informacje o trasie RouteLegStep związane z trasami TRANSIT.

Pola
stop_details

TransitStopDetails

Informacje o przystankach i przyjazdach na dany krok.

localized_values

TransitDetailsLocalizedValues

Tekstowe właściwości właściwości RouteLegStepTransitDetails.

headsign

string

Określa kierunek, w którym porusza się ten środek transportu, zgodnie z opisem na pojeździe lub przystanku. Kierunek to często stacja końcowa.

headway

Duration

Określa oczekiwany czas podróży z tego samego przystanku do wybranego momentu. Na przykład przy wartości 600 sekund na wczesnym etapie ścieżki możesz się spodziewać 10 minut, jeśli zabraknie autobusu.

transit_line

TransitLine

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

stop_count

int32

Liczba przystanków odjazdu do przystanku przyjazdu. Ta liczba uwzględnia przyjazd, ale nie obejmuje przystanku odjazdu. Jeśli na przykład Twoja przystanek odlatuje z przystanku A, przechodzi przez przystanki B i C oraz dociera do przystanku D, stop_count zwróci wartość 3.

trip_short_text

string

tekst widoczny na rozkładach i znakach, który informuje o przewozie pasażerów. Tekst powinien jednoznacznie identyfikować podróż w ciągu dnia serwisowego. Na przykład „538” to trip_short_text pociągu Amtrak, który wyjeżdża z San Francisco w Kalifornii o 15:10 w dni robocze do Sacramento, Kalifornia.

TransitDetailsLocalizedValues

Zlokalizowane opisy wartości dla trasy RouteTransitDetails.

Pola
arrival_time

LocalizedTime

Czas w sformatowanym formacie tekstowym odpowiadający odpowiedniej strefie czasowej.

departure_time

LocalizedTime

Czas w sformatowanym formacie tekstowym odpowiadający odpowiedniej strefie czasowej.

Szczegóły przystanku transportu publicznego

Szczegóły przystanków transportu publicznego dla: RouteLegStep

Pola
arrival_stop

TransitStop

Informacje o przystanku przyjazdu dla danego kroku.

arrival_time

Timestamp

Szacowany czas dotarcia na dany krok.

departure_stop

TransitStop

Informacje o przystanku wyjazdu na dany krok.

departure_time

Timestamp

Szacowany czas wyjazdu na dany krok.

Porady dotyczące podróżowania na trasie

Zawiera dodatkowe informacje, o których powinien być widoczny użytkownik, np. informacje o ewentualnych ograniczeniach strefy ruchu.

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole nie jest obecnie wypełniane.

Porady dotyczące podróżowania na trasie

Zawiera dodatkowe informacje, o których użytkownik powinien być informowany na etapie rejestracji, np. informacje o możliwych ograniczeniach strefy ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach za przejazdy konkretnego pojazdu (RouteLeg). To pole jest wypełniane tylko wtedy, gdy oczekujemy, że na RouteLeg działają opłaty. Jeśli to pole jest ustawione, ale pole podrzędna ceny_szacunkowej nie jest wypełniane, ta droga prawdopodobnie zawiera opłaty drogowe, ale nie wiemy, jaka będzie cena. Jeśli to pole nie istnieje, na tym obszarze (RouteLeg) nie ma żadnej opłaty.

speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkości odczytu określające gęstość ruchu. Ma zastosowanie w przypadku ustawień routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Odstępy 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).

Miejsce docelowe RouteMatrix

Jedno miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagany. Docelowy punkt na trasie

Element RouteMatrix

Zawiera informacje o trasie obliczone dla pary źródła i miejsca docelowego interfejsu API ComputeRouteMatrix. Protokół można przesłać do klienta.

Pola
status

Status

Kod stanu błędu tego elementu.

condition

RouteMatrixElementCondition

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

distance_meters

int32

Odległość trasy w metrach.

duration

Duration

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

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

W niektórych przypadkach serwer nie jest w stanie obliczyć trasy na podstawie podanych preferencji dla tej pary źródła i miejsca docelowego. W takich sytuacjach może zostać użyty inny tryb obliczeniowy. W trybie awaryjnym to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W innym przypadku to pole nie jest skonfigurowane.

localized_values

LocalizedValues

Tekstowe właściwości właściwości RouteMatrixElement.

origin_index

int32

Indeks źródła zerowego źródła żądania.

destination_index

int32

Indeks miejsca docelowego o wartości zerowej w żądaniu.

Zlokalizowane wartości

przedstawienie określonych właściwości tekstowych.

Pola
distance

LocalizedText

Odległość przeprowadzona w formie tekstowej.

duration

LocalizedText

Czas trwania w formie tekstowej z uwzględnieniem warunków ruchu. Uwaga: jeśli nie żądano informacji o ruchu, wartość jest taka sama jak wartość static_duration.

static_duration

LocalizedText

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

transit_fare

LocalizedText

Opłata za przejazd w formie tekstowej.

RouteMatrixElementStan

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 odpowiednie informacje zostały wypełnione dla elementu.
ROUTE_NOT_FOUND Nie udało się znaleźć trasy. Element zawierający informacje o trasie, takie jak distance_meters czy duration, nie zostanie wypełniony.

RouteMatrixOrigin

Jedno źródło dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagany. Punkt początkowy punktu początkowego

route_modifiers

RouteModifiers

Opcjonalnie. Modyfikatory dla każdej trasy, która pobiera tę wartość jako punkt początkowy

Parametry RouteModifis

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

Pola
avoid_tolls

bool

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

avoid_highways

bool

Jeśli ma wartość Prawda, jeśli autostrady są rozsądne, autostrady preferują trasy, które nie zawierają tych autostrad. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.

avoid_ferries

bool

Jeśli zasada ma wartość Prawda, w miarę potrzeb unika promów, preferując trasy niezawierające promów. Dotyczy wyłącznie: DRIVE i TWO_WHEELER RouteTravelMode.

avoid_indoor

bool

Jeśli ma wartość Prawda, w miarę możliwości unikaj poruszania się w pomieszczeniach, preferując trasy niezawierające nawigacji wewnętrznej. Dotyczy wyłącznie: WALK RouteTravelMode.

vehicle_info

VehicleInfo

Określa informacje o pojeździe.

toll_passes[]

TollPass

Zawiera informacje o biletach płatnych. Jeśli podasz opłaty za przejazd, interfejs API spróbuje zwrócić cenę biletu. Jeśli opłata za przejazd nie została podana, interfejs API traktuje ją jako nieznaną i próbuje zwrócić cenę gotową. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.

Porady dotyczące tras

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

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie są oczekiwane opłaty. Jeśli to pole jest ustawione, ale pole podszacowane cena nie jest wypełniane, trasa zawiera opłaty drogowe, ale szacowana cena jest nieznana. Jeśli to pole nie jest skonfigurowane, na trasie nie ma wymaganych opłat.

speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkości odczytu określające gęstość ruchu. Ma zastosowanie w przypadku ustawień routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Odstępy 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

Zwrócona trasa może podlegać ograniczeniom, które nie są odpowiednie w przypadku żądanych środków transportu i modyfikatorów trasy.

transit_fare

Money

Jeśli wyświetla się łączna cena lub koszt biletu na tej trasie, ta usługa jest zwracana tylko w przypadku żądań TRANSIT i tylko w przypadku tras, dla których dostępne są informacje o cenie dla wszystkich kroków transportu publicznego.

Tryb podróży

Zestaw wartości używanych do określania środka transportu. UWAGA: trasy WALK, BICYCLE i TWO_WHEELER są w wersji beta i mogą czasami nie wyświetlać wyraźnych chodników, ścieżek dla pieszych lub ścieżek rowerowych. To ostrzeżenie musi być wyświetlane użytkownikowi w przypadku wszystkich tras pieszych, rowerowych i dwukołowych 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óż rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Motocykl, motocykl. na przykład motocykl. Różni się to od trybu podróży BICYCLE, który obejmuje tryb ludzki.
TRANSIT Podróżuj transportem publicznym (jeśli masz taką możliwość).

Ustawienie routingu

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślnie TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania bieżących warunków drogowych. Jest to przydatne, gdy natężenie ruchu nie ma znaczenia lub nie ma zastosowania. Użycie tej wartości powoduje najkrótszy czas oczekiwania. Uwaga: w przypadku opcji RouteTravelMode DRIVE i TWO_WHEELER. Wyniki danego żądania mogą się z czasem zmienić ze względu na zmiany w sieci drogowej, zaktualizowane średnie warunki drogowe i rozproszony charakter usługi. Wyniki mogą się też różnić w porównaniu do niemal równoważnych tras w dowolnym czasie i częstotliwości.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem warunków na drodze. W przeciwieństwie do zasady TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje stosujemy w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę aktualne informacje o ruchu drogowym, bez większości optymalizacji skuteczności. Użycie tej wartości powoduje najdłuższe opóźnienie.

Prędkość odczytu

Wskaźnik gęstości ruchu na ciągłym fragmencie linii łamanej lub ścieżki. Biorąc pod uwagę ścieżkę z punktami P_0, P_1, ... , P_N (indeks oparty na zero), parametr SpeedReadingInterval określa przedział i opisuje ruch za pomocą poniższych kategorii.

Pola
start_polyline_point_index

int32

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

end_polyline_point_index

int32

Indeks końcowy tego interwał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 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 utworzono korków.
TRAFFIC_JAM Wykryto korek.

Opłata za przejazd

Obejmuje informacje o opłatach na Route lub RouteLeg.

Pola
estimated_price[]

Money

Kwota opłat za połączenia związane z tymi usługami: Route lub RouteLeg. Na liście znajdują się środki w każdej walucie, której uiszczają opłaty. Zwykle lista zawiera tylko jeden element z trasami płatnymi w jednej walucie. W przypadku podróży międzynarodowych ta lista może zawierać wiele pozycji, które odzwierciedlają opłaty w różnych walutach.

Opłata za przejazd

Lista płatnych dróg na całym świecie, wspieranych przez nas.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywane. Jeśli ta wartość jest używana, żądanie się nie powiedzie.
AU_ETOLL_TAG Płatny bilet w Sydney. Więcej informacji znajdziesz na https://www.myetoll.com.au.
AU_EWAY_TAG Płatny bilet w Sydney. Więcej informacji znajdziesz na https://www.tollpay.com.au.
AU_LINKT Karnet na terenie całej Australii. Więcej informacji znajdziesz na https://www.linkt.com.au/.
AR_TELEPASE Karnet na Argentynę. Więcej informacji znajdziesz na https://telepase.com.ar.
BR_AUTO_EXPRESO Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://www.autoexpreso.com.
BR_CONECTCAR Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://movemais.com.
BR_PASSA_RAPIDO Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://pasorapido.gob.do/.
BR_SEM_PARAR Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://taggy.com.br.
BR_VELOE Brazylijski bilet wstępu. Więcej informacji znajdziesz na https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanadzie i Stanach Zjednoczonych.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanadzie i Stanach Zjednoczonych.
CA_US_BLUE_WATER_EDGE_PASS z prowincji Ontario, Kanada do Michigan, przejście graniczne w Stanach Zjednoczonych.
CA_US_CONNEXION z prowincji Ontario, Kanada do Michigan, przejście graniczne w Stanach Zjednoczonych.
CA_US_NEXUS_CARD Kanadzie i Stanach Zjednoczonych.
ID_E_TOLL Indonezja Karta elektroniczna udostępniana przez wiele banków płacących za przejazdy za przejazdy. Płatności za pomocą e-kart przez bank są takie same, więc wymagana jest tylko jedna wartość enum. 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 Zwolnienie z podatku dochodowego w Indiach, HP.
MX_IAVE Płatny bilet 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 (w języku angielskim)
MX_TAG_IAVE Meksyk
MX_TAG_TELEVIA Meksyku. Jedna z wielu firm w Meksyku. Więcej informacji znajdziesz na https://www.televia.com.mx.
MX_TELEVIA Meksyku. Jedna z wielu działających w Meksyku. https://www.televia.com.mx
MX_VIAPASS Karnet płatny 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, Stany Zjednoczone.
US_CA_FASTRAK Kanada, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje kierowca, który oprócz wydanej przez DMV pojazdu pozwolenia czystego powietrza (CAV) ma kartę FasTrak. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Stany Zjednoczone.
US_CO_GO_PASS CO, Stany Zjednoczone.
US_DE_EZPASSDE Niemcy, Stany Zjednoczone.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floryda, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floryda, USA.
US_FL_EPASS Floryda, USA.
US_FL_GIBA_TOLL_PASS Floryda, USA.
US_FL_LEEWAY Floryda, USA.
US_FL_SUNPASS Floryda, USA.
US_FL_SUNPASS_PRO Floryda, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
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, Stany Zjednoczone.
US_LA_TOLL_TAG LA, Stany Zjednoczone.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, Stany Zjednoczone.
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, USA.
US_NY_EZPASSNY Nowy Jork, USA.
US_OH_EZPASSOH Ohio, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA;
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 Wirginia Zachodnia, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS Wirginia Zachodnia, Stany Zjednoczone.
US_WV_NEWELL_TOLL_BRIDGE_TICKET Wirginia Zachodnia, Stany Zjednoczone.

Model ruchu

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

Wartości w polu enum
TRAFFIC_MODEL_UNSPECIFIED Nieużywana. Jeśli zostanie podany, domyślnie przyjęta zostanie wartość BEST_GUESS.
BEST_GUESS Zwraca wartość duration, która powinna być szacowanym czasem podróży, biorąc pod uwagę zarówno informacje o warunkach historycznych, jak i natężeniu ruchu. Ruch na żywo staje się ważniejszy, gdy departure_time jest bliżej.
PESSIMISTIC Zwraca on informację, że w większości dni zwrócony czas podróży powinien być dłuższy niż rzeczywisty czas podróży, ale czasami dni o szczególnie złych warunkach drogowych mogą przekraczać tę wartość.
OPTIMISTIC Zwraca on informacje o tym, że w większości dni zwrócony czas podróży powinien być krótszy niż w rzeczywistości, chociaż w przypadku dni, w których warunki na drodze są wyjątkowo atrakcyjne, te wartości mogą być krótsze.

Przewoźnik

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

Pola
name

string

Nazwa tego przewoźnika.

phone_number

string

Właściwy format numeru telefonu danego przewoźnika.

uri

string

Identyfikator URI przewoźnika.

Linia transportu publicznego

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

Pola
agencies[]

TransitAgency

Przewoźnicy, którzy obsługują tę linię.

name

string

Pełna nazwa tej linii transportu publicznego, na przykład „8 Aleja Lokalne”.

uri

string

Identyfikator URI linii transportu publicznego podany przez przewoźnika.

color

string

Kolor powszechnie używany na szyldach i znakach. Wartość szesnastkowa.

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 powszechnie używany w tekście na tej linii. Wartość szesnastkowa.

vehicle

TransitVehicle

Rodzaj pojazdu na tej linii transportu publicznego.

Transport publiczny

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

Pola
allowed_travel_modes[]

TransitTravelMode

Zestaw środków transportu, których można używać podczas wyznaczania trasy TRANSIT. Domyślnie są wszystkie obsługiwane środki transportu.

routing_preference

TransitRoutingPreference

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

Ustawienie TransportRoute

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 obliczona trasa powinna preferować ograniczoną liczbę kroków.
FEWER_TRANSFERS Wskazuje, że obliczona trasa powinna preferować ograniczoną liczbę transferów.

Transport

Zestaw wartości określających środek 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 Podróż kolejką linową lub tramwajem.
RAIL Podróż koleją. Jest to odpowiednik SUBWAY, TRAIN i LIGHT_RAIL.

Przystanek transportu publicznego

Informacje o przystanku komunikacji publicznej.

Pola
name

string

Nazwa przystanku.

location

Location

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

Transport publiczny

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

Pola
name

LocalizedText

Nazwa pojazdu pisana wielkimi literami.

type

TransitVehicleType

Typ pojazdu.

icon_uri

string

Identyfikator URI ikony powiązanej z tym typem pojazdu.

local_icon_uri

string

Identyfikator URI ikony powiązany z tym typem pojazdu, oparty na lokalnym oznakowaniu transportu.

Rodzaj pojazdu transportu publicznego

Typ pojazdów na trasach transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywana.
BUS Autobus.
CABLE_CAR Pojazd poruszający się kablem, zwykle na ziemi. Kolejka linowa może mieć typ GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Prom.
FUNICULAR Pojazd ciągnięty za pomocą kabla. Kolejka linowa zazwyczaj składa się z dwóch samochodów, z których każdy działa jako przeciwległa ciężarówka.
GONDOLA_LIFT Kolejka linowa.
HEAVY_RAIL Ciężka kolej.
HIGH_SPEED_TRAIN Pociąg szybki.
INTERCITY_BUS Autobus krajowy.
LONG_DISTANCE_TRAIN Pociąg dalekobieżny.
METRO_RAIL Kolej miejska.
MONORAIL Kolej jednoszynowa.
OTHER Wszystkie inne pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka z dojazdem to rodzaj autobusu z możliwością podwożenia i odbierania pasażerów w dowolnym miejscu na trasie.
SUBWAY Podziemna kolej miejska.
TRAM Nad ziemią.
TROLLEYBUS Trolejbus.

Jednostki

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

Wartości w polu enum
UNITS_UNSPECIFIED Nie określono jednostek miary. Domyślnie jest to jednostka miary określona na podstawie żądania.
METRIC Jednostki miary.
IMPERIAL Jednostki miary angielskiej (imperialne).

Typ emisji pojazdów

Zestaw wartości opisujących typ pojazdu. Dotyczy wyłącznie: DRIVE RouteTravelMode.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Domyślnie GASOLINE.
GASOLINE Pojazd z silnikiem benzynowym lub benzynowym.
ELECTRIC Pojazd elektryczny.
HYBRID Pojazdy hybrydowe (np. benzynowe i elektryczne).
DIESEL Pojazdy z silnikiem diesla.

Informacje o pojeździe

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

Pola
emission_type

VehicleEmissionType

Opisuje emisję pojazdu. Dotyczy wyłącznie: DRIVE RouteTravelMode.

Punkt pośredni

Otwiera punkt pośredni. Punkty pośrednie oznaczają początek i koniec trasy oraz punkty pośrednie na trasie.

Pola
via

bool

Wskazuje jako punkt milowy, a nie przystanek. W przypadku każdego punktu końcowego nienależącego do żądania w odpowiedzi przesyłane są wpisy do tablicy legs zawierające informacje o przesiadkach na danym etapie podróży. Ustaw tę wartość na Prawda, jeśli chcesz, aby trasa przebiegała przez ten punkt pośredni, bez zatrzymywania się. Przez punkty pośrednie nie powodują dodania wpisu do tablicy legs, ale kierują ruchem po drodze. Tę wartość możesz ustawić tylko dla punktów pośrednich. Żądanie nie powiedzie się, jeśli ustawisz to pole w terminalach. Jeśli zasada ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, to pole nie może mieć wartości Prawda. W przeciwnym razie żądanie się nie powiedzie.

vehicle_stopover

bool

Wskazuje, że punkt drogi jest przeznaczony dla pojazdów, których celem jest odbiór lub odbiór. Gdy ustawisz tę wartość, wytyczona trasa nie będzie obejmować punktów innych niż via na drogach, które nie kwalifikują się do odbioru i zwrotu. Ta opcja działa tylko w przypadku trybów podróży DRIVE i TWO_WHEELER, a location_type to Location.

side_of_road

bool

Wskazuje, że lokalizacja tego punktu orientacyjnego ma być korzystna dla danego pojazdu po drodze. Gdy ustawisz tę wartość, trasa będzie przechodzić przez lokalizację, tak aby pojazd mógł się zatrzymać z boku drogi, tak aby to odchylenie było odsunięte od środka drogi. Ta opcja działa tylko w przypadku dysków „DRIVE” i „TWO_WHEELER” RouteTravelMode.

Pole sumy location_type. Różne sposoby reprezentowania 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 ciekawego miejsca powiązanego z punktem pośrednim.

address

string

Adres czytelny dla człowieka lub kod plus. Szczegółowe informacje znajdziesz na https://plus.codes.