Package google.maps.routing.v2

Indeks

Trasy

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Przyjmuje listę miejsc nadania i miejsc docelowych, a zwraca strumień zawierający informacje o trasie dla każdej kombinacji miejsca nadania i miejsca docelowego.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo za pomocą nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek do pól rozdzielona przecinkami. Szczegółowe informacje o tworzeniu ścieżek pól znajdziesz w tej dokumentacji.

Na przykład w tej metodzie:

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

Ważne jest, aby w masce pola umieścić znak status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyświetlane jako prawidłowe. Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybieranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność w zakresie opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól skutkuje mniejszym rozmiarem odpowiedzi, a tym samym większą przepustowością sieci.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca trasę główną wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu punktów pośrednich i końcowych.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo za pomocą nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek do pól rozdzielona przecinkami. Szczegółową dokumentację tworzenia ścieżek pól znajdziesz tutaj.

Na przykład w tej metodzie:

  • Maska pola 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ład konfiguracji produkcyjnej): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybieranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilną wydajność w zakresie opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól skutkuje mniejszym rozmiarem odpowiedzi, a tym samym większą przepustowością sieci.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

Wymagany. Tablica miejsc docelowych, która określa wiersze macierzy odpowiedzi. W przypadku mocy zbioru źródeł i miejsc docelowych obowiązuje kilka ograniczeń rozmiaru:

  • Suma liczby punktów początkowych i liczby punktów docelowych określonych jako place_id lub address nie może być większa niż 50.
  • Iloczyn liczby miejsc docelowych i miejsc pochodzenia nie może w żadnym przypadku przekraczać 625.
  • Jeśli routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL, iloczyn liczby punktów początkowych i liczby punktów docelowych nie może być większy niż 100.
  • Jeśli parametr travel_mode ma wartość TRANSIT, iloczyn liczby punktów początkowych i liczby punktów docelowych nie może być większy niż 100.
destinations[]

RouteMatrixDestination

Wymagany. 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 obliczyć trasę przy użyciu wybranego ustawienia routingu. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo 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 się nie powiedzie.
departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie to czas wysłania żądania. UWAGA: datę departure_time w przeszłości możesz określić tylko wtedy, gdy ustawienie RouteTravelMode ma wartość TRANSIT.
arrival_time

Timestamp

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

string

Opcjonalnie. Kod języka w formacie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator ustawień regionalnych Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie określony na podstawie lokalizacji pierwszego źródła.
region_code

string

Opcjonalnie. Kod regionu określony jako dwuznakowa wartość ccTLD („domena 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świetlania.
extra_computations[]

ExtraComputation

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

TrafficModel

Opcjonalnie. Określa założenia, które mają być używane podczas obliczania czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w RouteMatrixElement, które zawiera przewidywany czas w ruchu na podstawie średnich wartości historycznych. TrafficModel jest dostępna tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode ma wartość DRIVE. Jeśli ruch jest wymagany, a wartość TrafficModel nie jest określona, domyślnie przyjmuje się BEST_GUESS.
transit_preferences

TransitPreferences

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

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nie używane. Żądania zawierające tę wartość nie zostaną zrealizowane.
TOLLS Informacje o opłatach za przejazd dla elementów macierzy.

ComputeRoutesRequest

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

Wymagany. Punkt początkowy.
destination

Waypoint

Wymagany. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie. Zestaw punktów pośrednich na trasie (z wyjątkiem punktów końcowych), w których można się zatrzymać lub które można ominąć. Obsługiwanych jest maksymalnie 25 pośrednich punktów na trasie.
travel_mode

RouteTravelMode

Opcjonalnie. Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie. Określa sposób obliczania trasy. Serwer próbuje obliczyć trasę przy użyciu wybranego ustawienia routingu. Jeśli preferencje routingu spowodują 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 się nie powiedzie.
polyline_quality

PolylineQuality

Opcjonalnie. Określa preferencje dotyczące jakości polilinii.
polyline_encoding

PolylineEncoding

Opcjonalnie. Określa preferowane kodowanie polilinii.
departure_time

Timestamp

Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie to czas wysłania żądania. UWAGA: datę departure_time w przeszłości możesz określić tylko wtedy, gdy ustawienie RouteTravelMode ma wartość TRANSIT. Trasy transportu publicznego są dostępne do 7 dni wstecz i do 100 dni w przyszłości.
arrival_time

Timestamp

Opcjonalnie. Godzina przyjazdu. UWAGA: to pole jest ignorowane, gdy w prośbach określono wartość RouteTravelMode inną niż TRANSIT. Możesz określić wartość departure_time lub arrival_time, ale nie obie jednocześnie. Trasy transportu publicznego są dostępne do 7 dni wstecz i do 100 dni w przyszłości.
compute_alternative_routes

bool

Opcjonalnie. Określa, czy oprócz trasy mają być obliczane trasy alternatywne. W przypadku żądań z pośrednimi punktami trasy 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 w formacie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator ustawień regionalnych Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie wywnioskowany na podstawie lokalizacji żądania trasy.
region_code

string

Opcjonalnie. Kod regionu określony jako dwuznakowa wartość ccTLD („domena 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świetlania. Pola te obejmują pole instruction w NavigationInstruction. Jednostki miary używane w przypadku trasy, odcinka, odległości kroku i czasu trwania nie zależą od tej wartości. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną wywnioskowane na podstawie lokalizacji pierwszego źródła.
optimize_waypoint_order

bool

Opcjonalnie. Jeśli ta opcja ma wartość „true”, usługa próbuje zminimalizować ogólny koszt trasy, zmieniając kolejność określonych pośrednich punktów na trasie. Żądanie nie powiedzie się, jeśli którykolwiek z pośrednich punktów trasy jest punktem trasy via. Użyj kodu ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku X-Goog-FieldMask nie ma żądania ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli parametr optimize_waypoint_order ma wartość Fałsz, parametr ComputeRoutesResponse.optimized_intermediate_waypoint_index będzie pusty.
requested_reference_routes[]

ReferenceRoute

Opcjonalnie. Określa, które trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa o innym celu obliczania niż trasa domyślna. Na przykład FUEL_EFFICIENTobliczenia trasy referencyjnej uwzględniają różne parametry, które pozwalają wygenerować optymalną trasę pod względem zużycia paliwa. Gdy korzystasz z tej funkcji, szukaj na wyznaczonych trasach ikony route_labels.
extra_computations[]

ExtraComputation

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

TrafficModel

Opcjonalnie. Określa założenia, które mają być używane podczas obliczania czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w elementach Route i RouteLeg, które zawierają przewidywany czas w ruchu na podstawie średnich wartości historycznych. TrafficModel jest dostępna tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode ma wartość DRIVE. Jeśli ruch jest wymagany, a wartość TrafficModel nie jest określona, domyślnie przyjmuje się BEST_GUESS.
transit_preferences

TransitPreferences

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

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nie używane. Żądania zawierające tę wartość nie zostaną zrealizowane.
TOLLS Informacje o opłatach za przejazd na trasie.
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasie.
TRAFFIC_ON_POLYLINE Linie łamane uwzględniające natężenie ruchu na trasach.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions w postaci sformatowanego ciągu tekstowego HTML. Te treści mają być odczytywane w takiej formie, w jakiej są wyświetlane. Nie analizuj go programowo.
FLYOVER_INFO_ON_POLYLINE Informacje o przelocie nad trasą. Aby zwrócić te informacje, musisz określić routes.polyline_details.flyover_info fieldmask. Obecnie te dane są wypełniane tylko w przypadku niektórych obszarów metropolitalnych w Indiach. Ta funkcja jest eksperymentalna, a kod SKU lub opłata mogą ulec zmianie.
NARROW_ROAD_INFO_ON_POLYLINE Informacje o wąskich drogach na trasie. Aby zwrócić te informacje, musisz określić routes.polyline_details.narrow_road_info fieldmask. Obecnie te dane są wypełniane tylko w przypadku niektórych obszarów metropolitalnych w Indiach. Ta funkcja jest eksperymentalna, a kod SKU lub opłata mogą ulec zmianie.

ReferenceRoute

Obsługiwana trasa referencyjna w obiekcie ComputeRoutesRequest.

Wartości w polu enum
REFERENCE_ROUTE_UNSPECIFIED Nie używane. Żądania zawierające tę wartość kończą się niepowodzeniem.
FUEL_EFFICIENT Trasa z najniższym spalaniem.
SHORTER_DISTANCE

Trasa o krótszym dystansie. To funkcja eksperymentalna.

W przypadku DRIVE ta funkcja traktuje krótszy dystans jako ważniejszy od komfortu jazdy. Może na przykład preferować drogi lokalne zamiast autostrad, korzystać z dróg gruntowych, przejeżdżać przez parkingi itp. Ta funkcja nie zwraca żadnych manewrów, o których Google Maps wie, że są niezgodne z prawem.

W przypadku żądań BICYCLE i TWO_WHEELER ta funkcja zwraca trasy podobne do tych, które są zwracane, gdy nie określisz parametru requested_reference_routes.

Ta funkcja nie jest zgodna z innymi środkami transportu, punktami pośrednimi ani optimize_waypoint_order. Takie prośby nie będą realizowane. Możesz jednak używać go z dowolnym routing_preference.

ComputeRoutesResponse

ComputeRoutes.

Pola
routes[]

Route

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

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć wyników trasy przy użyciu wszystkich preferencji wejściowych, może zastosować inny sposób obliczania. Gdy używany jest tryb rezerwowy, to pole zawiera szczegółowe informacje o odpowiedzi rezerwowej. W przeciwnym razie to pole nie jest ustawione.
geocoding_results

GeocodingResults

Zawiera informacje o odpowiedzi geokodowania dla punktów pośrednich określonych jako adresy.

FallbackInfo

Informacje o tym, jak i dlaczego użyto wyniku rezerwowego. Jeśli to pole jest ustawione, oznacza to, że serwer użył innego trybu routingu niż preferowany tryb jako trybu rezerwowego.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty w odpowiedzi. Jeśli nastąpiło przejście na tryb rezerwowy, tryb może być inny niż preferencje dotyczące routingu ustawione w oryginalnym żądaniu klienta.
reason

FallbackReason

Powód, dla którego zamiast pierwotnej odpowiedzi użyto odpowiedzi rezerwowej. To pole jest wypełniane tylko wtedy, gdy zostanie uruchomiony tryb rezerwowy i zostanie zwrócona odpowiedź rezerwowa.

FallbackReason

Przyczyny użycia odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano przyczyny powrotu.
SERVER_ERROR Podczas obliczania tras w wybranym trybie routingu wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym.
LATENCY_EXCEEDED Nie udało nam się na czas zakończyć obliczeń w wybranym trybie wyznaczania trasy, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym.

FallbackRoutingMode

Rzeczywisty tryb routingu użyty w odpowiedzi zastępczej.

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

GeocodedWaypoint

Szczegóły lokalizacji używanych jako punkty pośrednie. Wartość podawana tylko w przypadku punktów pośrednich w postaci adresu. Zawiera szczegółowe informacje o wynikach geokodowania, które pomagają określić, do czego został geokodowany adres.

Pola
geocoder_status

Status

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

string

Typy wyniku w postaci co najmniej 1 tagu typu. Obsługiwane typy: typy adresów i typy komponentów adresu.
partial_match

bool

Oznacza, że geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, ale udało mu się dopasować część żądanego adresu. Sprawdź, czy w pierwotnym żądaniu nie ma błędów pisowni lub niekompletnego adresu.
place_id

string

Identyfikator miejsca dla tego wyniku.
intermediate_waypoint_request_index

int32

Indeks odpowiedniego pośredniego punktu na trasie w żądaniu. Wypełniane tylko wtedy, gdy odpowiedni punkt pośredni jest punktem pośrednim.

GeocodingResults

Zawiera GeocodedWaypoints dla punktu początkowego, miejsca docelowego i pośrednich punktów trasy. Wartość podawana tylko w przypadku punktów pośrednich w postaci adresu.

Pola
origin

GeocodedWaypoint

Geokodowany punkt pośredni miejsca wylotu.
destination

GeocodedWaypoint

Docelowy punkt pośredni po geokodowaniu.
intermediates[]

GeocodedWaypoint

Lista pośrednich punktów trasy z geokodowaniem, z których każdy zawiera pole indeksu odpowiadające pozycji punktu trasy w kolejności, w jakiej został określony w żądaniu (liczonej od zera).

LocalizedTime

Zlokalizowany opis czasu.

Pola
time

LocalizedText

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

string

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

Lokalizacja

Zawiera lokalizację (punkt geograficzny i opcjonalny kierunek).

Pola
lat_lng

LatLng

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

Int32Value

Kierunek na kompasie powiązany z kierunkiem ruchu. Ta wartość określa stronę drogi, po której ma nastąpić odbiór i wysadzenie pasażera. Wartości kierunku mogą wynosić od 0 do 360, gdzie 0 oznacza kierunek północny, 90 – wschodni itd. Możesz używać tego pola tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.

Maneuver

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

Wartości w polu enum
MANEUVER_UNSPECIFIED Nie uż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 Jedź prosto.
RAMP_LEFT Skieruj się na wjazd po lewej stronie.
RAMP_RIGHT Skieruj się na zjazd po prawej stronie.
MERGE Włącz się do ruchu.
FORK_LEFT Skręć w lewo.
FORK_RIGHT Skręć w prawo.
FERRY Popłyń promem.
FERRY_TRAIN Wsiądź do pociągu, który wjeżdża na prom.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
DEPART Początkowy manewr.
NAME_CHANGE Służy do wskazywania zmiany nazwy ulicy.

Zawiera instrukcje nawigacji dla RouteLegStep.

Pola
maneuver

Maneuver

Zawiera instrukcje nawigacyjne dotyczące bieżącego kroku (np. skręć w lewo, włącz się do ruchu lub jedź prosto). To pole określa, która ikona ma być wyświetlana.
instructions

string

Instrukcje dotyczące tego kroku.

Linia łamana

Zawiera zakodowaną linię łamaną.

Pola
Pole unii polyline_type. Zawiera typ linii łamanej. Domyślna wartość to encoded_polyline. polyline_type może mieć tylko jedną z tych wartości:
encoded_polyline

string

Ciąg znaków reprezentujący linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
geo_json_linestring

Struct

Określa polilinię za pomocą formatu GeoJSON LineString.

PolylineDetails

Szczegóły odpowiadające danemu indeksowi lub ciągłemu segmentowi polilinii. W przypadku linii łamanej z punktami P_0, P_1, ... , P_N (indeksowanie od zera) PolylineDetails określa przedział i powiązane z nim metadane.

Pola
flyover_info[]

FlyoverInfo

Szczegóły przelotu wzdłuż linii łamanej.
narrow_road_info[]

NarrowRoadInfo

Szczegóły wąskiej drogi wzdłuż linii łamanej.

FlyoverInfo

Zawiera informacje o przelotach wzdłuż linii łamanej.

Pola
flyover_presence

RoadFeatureState

Tylko dane wyjściowe. Wskazuje, czy dla danego odcinka linii łamanej istnieje przelot.
polyline_point_index

PolylinePointIndex

Lokalizacja informacji związanych z przelotem wzdłuż linii łamanej.

NarrowRoadInfo

Zawiera informacje o wąskich drogach wzdłuż linii łamanej.

Pola
narrow_road_presence

RoadFeatureState

Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej znajduje się wąska droga.
polyline_point_index

PolylinePointIndex

Lokalizacja informacji o wąskiej drodze wzdłuż linii łamanej.

PolylinePointIndex

Zawiera indeksy początku i końca szczegółu linii łamanej. Jeśli dane odpowiadają jednemu punktowi, wartości start_index i end_index będą równe.

Pola
start_index

int32

Indeks początkowy tego szczegółu w linii łamanej.
end_index

int32

Indeks końcowy tego szczegółu w linii łamanej.

RoadFeatureState

Zawiera stany obiektów drogowych wzdłuż odcinka linii łamanej.

Wartości w polu enum
ROAD_FEATURE_STATE_UNSPECIFIED Stan obiektu drogowego nie został obliczony (wartość domyślna).
EXISTS Obiekt drogi istnieje.
DOES_NOT_EXIST Obiekt drogowy nie istnieje.

PolylineEncoding

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

Wartości w polu enum
POLYLINE_ENCODING_UNSPECIFIED Nie określono preferencji dotyczących typu polilinii. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE Określa linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
GEO_JSON_LINESTRING Określa polilinię za pomocą formatu GeoJSON LineString.

PolylineQuality

Zbiór wartości określających jakość polilinii.

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości polilinii. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa polilinię wysokiej jakości, która składa się z większej liczby punktów niż OVERVIEW, co zwiększa rozmiar odpowiedzi. Użyj tej wartości, gdy potrzebujesz większej precyzji.
OVERVIEW Określa linię łamaną podsumowania, która składa się z niewielkiej liczby punktów. Używaj tej wartości podczas wyświetlania podsumowania trasy. Korzystanie z tej opcji wiąże się z krótszym czasem oczekiwania na żądanie niż w przypadku opcji HIGH_QUALITY.

Trasa

Zawiera trasę, która składa się z połączonych odcinków dróg łączących początkowy, końcowy i pośrednie punkty trasy.

Pola
route_labels[]

RouteLabel

Etykiety dla Route, które pomagają identyfikować określone właściwości trasy w celu porównania ich z innymi.
legs[]

RouteLeg

Zbiór odcinków (segmentów ścieżki między punktami pośrednimi), które składają się na trasę. Każdy etap odpowiada podróży między 2 miejscami, które nie są via Waypoints. Na przykład trasa bez pośrednich punktów na trasie ma tylko 1 odcinek. Trasa, która zawiera 1 nievia pośredni punkt na trasie, ma 2 odcinki. Trasa, która zawiera 1 via pośredni punkt na trasie, ma 1 etap. Kolejność odcinków trasy odpowiada kolejności punktów pośrednich: origin, intermediates, destination.
distance_meters

int32

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

Duration

czas potrzebny na pokonanie trasy. Jeśli ustawisz wartość 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ść zostanie obliczona z uwzględnieniem warunków drogowych.
static_duration

Duration

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

Polyline

Ogólna linia łamana trasy. Ta linia łamana jest połączoną linią łamaną wszystkich legs.
description

string

Opis trasy.
warnings[]

string

Tablica ostrzeżeń, które mają się wyświetlać podczas wyświetlania trasy.
viewport

Viewport

Ramka ograniczająca widoczny obszar linii łamanej.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.
optimized_intermediate_waypoint_index[]

int32

Jeśli ustawisz wartość optimize_waypoint_order na true, to pole będzie zawierać zoptymalizowaną kolejność pośrednich punktów na trasie. W przeciwnym razie to pole jest puste. Jeśli na przykład podasz dane wejściowe: Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York; a zoptymalizowana kolejność pośrednich punktów przelotowych to Phoenix, Dallas, Bangor, to to pole będzie zawierać wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego pośredniego punktu trasy podanego na wejściu.
localized_values

RouteLocalizedValues

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

string

Nieprzezroczysty token, który można przekazać do Navigation SDK, aby odtworzyć trasę podczas nawigacji i w przypadku zmiany trasy uwzględnić pierwotny zamiar, gdy trasa została utworzona. Traktuj ten token jako nieprzejrzystą strukturę danych. Nie porównuj jego wartości w różnych żądaniach, ponieważ może się ona zmieniać, nawet jeśli usługa zwraca dokładnie tę samą trasę.

UWAGA: usługa Route.route_token jest dostępna tylko w przypadku żądań, w których parametr ComputeRoutesRequest.routing_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Route.route_token nie jest obsługiwany w przypadku żądań zawierających punkty pośrednie.
polyline_details

PolylineDetails

Zawiera informacje o szczegółach wzdłuż polilinii.

RouteLocalizedValues

Tekstowe reprezentacje niektórych usług.

Pola
distance

LocalizedText

Długość trasy w formie tekstowej.
duration

LocalizedText

Czas trwania w formie tekstowej, zlokalizowany w regionie zapytania. Uwzględnia warunki na drodze. Uwaga: jeśli nie zażądasz informacji o ruchu, ta wartość będzie taka sama jak wartość static_duration.
static_duration

LocalizedText

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

LocalizedText

Cena transportu publicznego w formie tekstowej.

RouteLabel

Etykiety dla Route, które pomagają identyfikować określone właściwości trasy w celu porównania ich z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślne – nieużywane.
DEFAULT_ROUTE Domyślna „najlepsza” trasa zwracana w wyniku obliczeń.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnej „najlepszej” trasy. Trasy takie jak ta będą zwracane, gdy podany jest parametr compute_alternative_routes.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem parametrów ekologicznych, takich jak zużycie paliwa.
SHORTER_DISTANCE trasa o krótszym dystansie do pokonania. To funkcja eksperymentalna.

RouteLeg

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

Pola
distance_meters

int32

Odległość do pokonania na danym odcinku trasy w metrach.
duration

Duration

Czas potrzebny na pokonanie odcinka. Jeśli wartość route_preference to TRAFFIC_UNAWARE, ta wartość jest taka sama jak static_duration. Jeśli route_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków drogowych.
static_duration

Duration

Czas trwania podróży na danym odcinku, obliczony bez uwzględnienia warunków drogowych.
polyline

Polyline

Ogólna linia łamana dla tego etapu, która obejmuje linię łamaną każdego .step
start_location

Location

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

Location

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

RouteLegStep

Tablica kroków oznaczających segmenty w tym etapie. Każdy krok to jedna instrukcja nawigacyjna.
travel_advisory

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

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

StepsOverview

Informacje ogólne o krokach w tym RouteLeg. To pole jest wypełniane tylko w przypadku tras TRANSPORTU PUBLICZNEGO.

RouteLegLocalizedValues

Tekstowe reprezentacje niektórych usług.

Pola
distance

LocalizedText

Długość trasy w formie tekstowej.
duration

LocalizedText

Czas trwania w formie tekstowej, zlokalizowany w regionie zapytania. Uwzględnia warunki na drodze. Uwaga: jeśli nie zażądasz informacji o ruchu, ta wartość będzie taka sama jak static_duration.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drogach, przedstawiony w formie tekstowej.

StepsOverview

Zawiera informacje ogólne o liście RouteLegStep.

Pola
multi_modal_segments[]

MultiModalSegment

Podsumowane informacje o różnych segmentach multimodalnych RouteLeg.steps. To pole nie jest wypełniane, jeśli w krokach RouteLeg nie ma żadnych segmentów multimodalnych.

MultiModalSegment

Zawiera podsumowane informacje o różnych segmentach multimodalnych RouteLeg.steps. Segment multimodalny to co najmniej 1 sąsiadujący ze sobą RouteLegStep, które mają ten sam RouteTravelMode. To pole nie jest wypełniane, jeśli w krokach RouteLeg nie ma żadnych segmentów multimodalnych.

Pola
navigation_instruction

NavigationInstruction

NavigationInstruction dla segmentu multimodalnego.
travel_mode

RouteTravelMode

Środek transportu w segmencie multimodalnym.
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 RouteLeg. Krok odpowiada pojedynczej instrukcji nawigacyjnej. Odcinki trasy składają się z etapów.

Pola
distance_meters

int32

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

Duration

Czas trwania podróży na tym etapie 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 użytkownik powinien być poinformowany, np. o możliwych ograniczeniach strefy ruchu na danym etapie podróży.
localized_values

RouteLegStepLocalizedValues

Tekstowe reprezentacje właściwości 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 reprezentacje niektórych usług.

Pola
distance

LocalizedText

Długość trasy w formie tekstowej.
static_duration

LocalizedText

Czas trwania bez uwzględnienia warunków na drogach, przedstawiony w formie tekstowej.

RouteLegStepTransitDetails

Dodatkowe informacje dla RouteLegStep dotyczące tras TRANSIT.

Pola
stop_details

TransitStopDetails

Informacje o przystankach przyjazdu i odjazdu w danym kroku.
localized_values

TransitDetailsLocalizedValues

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

string

Określa kierunek, w którym należy podróżować tą linią, zgodnie z oznaczeniem na pojeździe lub na przystanku początkowym. Kierunek to często stacja końcowa.
headway

Duration

Określa oczekiwany czas jako okres między odjazdami z tego samego przystanku w tym czasie. Jeśli na przykład wartość headway seconds wynosi 600, w przypadku spóźnienia się na autobus musisz poczekać 10 minut.
transit_line

TransitLine

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

int32

Liczba przystanków od przystanku początkowego do przystanku docelowego. Ta liczba obejmuje przystanek docelowy, ale nie obejmuje przystanku początkowego. Jeśli na przykład trasa zaczyna się na przystanku A, przebiega przez przystanki B i C, a kończy się na przystanku D,

stop_count

zwraca 3.
trip_short_text

string

Tekst, który pojawia się w harmonogramach i na tablicach informacyjnych, aby zidentyfikować przejazd środkiem transportu publicznego dla pasażerów. Tekst powinien jednoznacznie identyfikować przejazd w ramach dnia obsługi. Na przykład „538” to trip_short_text pociągu Amtrak, który w dni powszednie o 15:10 odjeżdża z San Jose w Kalifornii do Sacramento w Kalifornii.

TransitDetailsLocalizedValues

Zlokalizowane opisy wartości dla parametru RouteTransitDetails.

Pola
arrival_time

LocalizedTime

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

LocalizedTime

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

TransitStopDetails

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

Pola
arrival_stop

TransitStop

Informacje o przystanku docelowym w przypadku danego kroku.
arrival_time

Timestamp

Szacowany czas dotarcia na miejsce.
departure_stop

TransitStop

Informacje o przystanku początkowym kroku.
departure_time

Timestamp

Szacowany czas wylotu w przypadku tego etapu.

RouteLegStepTravelAdvisory

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

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole nie jest obecnie wypełnione.

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien być poinformowany na etapie podróży, np. o możliwych ograniczeniach w strefie ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach za przejazd na konkretnym RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się, że na trasie RouteLeg będą pobierane opłaty, a w żądaniu ComputeRoutesRequest.extra_computations znajduje się parametr TOLLS. Jeśli to pole jest ustawione, ale pole podrzędne estimated_price nie jest wypełnione, oznacza to, że na drodze są pobierane opłaty, ale nie znamy szacunkowej ceny. Jeśli toll_info nie istnieje, na RouteLeg nie ma opłaty.
speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkiego odczytu wskazujące gęstość ruchu. To pole jest wypełniane tylko w przypadku żądań, które mają wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, a w parametrze ComputeRoutesRequest.extra_computations znajduje się wartość TRAFFIC_ON_POLYLINE. Przedziały obejmują całą linię łamaną RouteLeg bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:

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

RouteMatrixDestination

Pojedyncze miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagany. Docelowy punkt pośredni

RouteMatrixElement

Zawiera informacje o trasie obliczone dla pary punkt początkowy/docelowy w interfejsie ComputeRouteMatrix API. Ten protokół można przesyłać strumieniowo 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ść do pokonania na trasie w metrach.
duration

Duration

czas potrzebny na pokonanie trasy. Jeśli ustawisz wartość 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ść zostanie obliczona z uwzględnieniem warunków drogowych.
static_duration

Duration

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

RouteTravelAdvisory

Dodatkowe informacje o trasie. Na przykład informacje o ograniczeniach i opłatach za przejazd.
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy z uwzględnieniem podanych preferencji dla danej pary punktów początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używany jest tryb rezerwowy, to pole zawiera szczegółowe informacje o odpowiedzi rezerwowej. W przeciwnym razie to pole nie jest ustawione.
localized_values

LocalizedValues

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

int32

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

int32

Indeks miejsca docelowego w żądaniu liczony od zera.

LocalizedValues

Tekstowe reprezentacje niektórych usług.

Pola
distance

LocalizedText

Długość trasy w formie tekstowej.
duration

LocalizedText

Czas trwania w formie tekstowej z uwzględnieniem warunków drogowych. Uwaga: jeśli informacje o ruchu nie zostały przesłane, ta wartość jest taka sama jak static_duration.
static_duration

LocalizedText

Czas trwania podany w formie tekstowej bez uwzględnienia warunków drogowych.
transit_fare

LocalizedText

Cena transportu publicznego w formie tekstowej.

RouteMatrixElementCondition

Stan zwracanej trasy.

Wartości w polu enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Używany tylko wtedy, gdy status elementu nie ma wartości OK.
ROUTE_EXISTS Znaleziono trasę i w elemencie uzupełniono odpowiednie informacje.
ROUTE_NOT_FOUND Nie udało się znaleźć trasy. Pola zawierające informacje o trasie, takie jak distance_meters czy duration, nie zostaną wypełnione w elemencie.

RouteMatrixOrigin

Pojedynczy punkt początkowy w przypadku ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagany. Punkt początkowy
route_modifiers

RouteModifiers

Opcjonalnie. Modyfikatory dla każdej trasy, która ma to miejsce jako punkt początkowy

RouteModifiers

Zawiera zestaw opcjonalnych warunków, które muszą być spełnione podczas obliczania tras.

Pola
avoid_tolls

bool

Jeśli ma wartość „true”, omija drogi płatne, gdy jest to uzasadnione, preferując trasy, które ich nie zawierają. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER RouteTravelMode.
avoid_highways

bool

Jeśli ta opcja jest ustawiona na „true”, unika autostrad, gdy jest to uzasadnione, i preferuje trasy, które ich nie zawierają. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER RouteTravelMode.
avoid_ferries

bool

Jeśli ta opcja jest ustawiona na „true”, usługa unika promów, gdy jest to uzasadnione, i preferuje trasy, które nie obejmują promów. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Jeśli ta opcja jest ustawiona na „true”, nawigacja w pomieszczeniach jest unikana, gdy jest to możliwe. Preferowane są trasy, które nie zawierają nawigacji w pomieszczeniach. Dotyczy tylko WALK RouteTravelMode.
vehicle_info

VehicleInfo

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

TollPass

Zawiera informacje o winietach. Jeśli podano winiety, interfejs API próbuje zwrócić cenę winiety. Jeśli nie podasz informacji o winietach, API uzna je za nieznane i spróbuje zwrócić cenę w gotówce. Dotyczy tylko urządzeń DRIVE i TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien wiedzieć, np. 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ą spodziewane opłaty za przejazd i w żądanym ComputeRoutesRequest.extra_computations znajduje się TOLLS. Jeśli to pole jest ustawione, ale pole podrzędne estimatedPrice nie jest wypełnione, oznacza to, że na trasie są pobierane opłaty, ale szacunkowa cena jest nieznana. Jeśli toll_info nie jest ustawiona, na trasie nie są spodziewane żadne opłaty.
speed_reading_intervals[]

SpeedReadingInterval

Przedziały szybkiego odczytu wskazujące gęstość ruchu. To pole jest wypełniane tylko w przypadku żądań, które mają wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, a w parametrze ComputeRoutesRequest.extra_computations znajduje się wartość TRAFFIC_ON_POLYLINE. Przedziały obejmują całą polilinię trasy bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:

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

int64

Prognozowane zużycie paliwa w mikrolitrach. To pole jest wypełniane tylko wtedy, gdy w polu ComputeRoutesRequest.extra_computations żądania znajduje się wartość FUEL_CONSUMPTION.
route_restrictions_partially_ignored

bool

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

Money

Jeśli występuje, zawiera całkowity koszt przejazdu lub 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 opłatach za wszystkie etapy transportu publicznego.

RouteTravelMode

Zestaw wartości służących do określania środka transportu. UWAGA: trasy WALK, BICYCLE i TWO_WHEELER są w wersji beta i czasami mogą nie mieć wyraźnych chodników, ścieżek dla pieszych lub ścieżek rowerowych. Musisz wyświetlać to ostrzeżenie użytkownikowi w przypadku wszystkich tras pieszych, rowerowych i dla pojazdów dwukołowych, które wyświetlasz w swojej aplikacji.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu. Domyślna wartość to DRIVE.
DRIVE Podróżowanie samochodem osobowym.
BICYCLE Podróżowanie rowerem.
WALK podróżować pieszo;
TWO_WHEELER Dwukołowy pojazd silnikowy. Na przykład motocykl. Pamiętaj, że różni się on od BICYCLE, czyli środka transportu napędzanego siłą ludzkich mięśni.
TRANSIT Podróżuj trasami transportu publicznego, jeśli są dostępne.

RoutingPreference

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji dotyczących routingu. Domyślna wartość to TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania aktualnych warunków drogowych. Odpowiednie, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości zapewnia najmniejsze opóźnienie. Uwaga: w przypadku RouteTravelMode DRIVE i TWO_WHEELER wybrana trasa i czas trwania są oparte na sieci dróg i średnich warunkach ruchu niezależnych od czasu, a nie na bieżących warunkach na drodze. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki danego żądania mogą się zmieniać z czasem ze względu na zmiany w sieci dróg, zaktualizowane średnie warunki ruchu i rozproszony charakter usługi. Wyniki mogą się też różnić w przypadku niemal identycznych tras w dowolnym momencie lub z dowolną częstotliwością.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem aktualnych warunków na drodze. W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje są stosowane w celu znacznego zmniejszenia opóźnienia.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy z uwzględnieniem aktualnych warunków ruchu, ale bez stosowania większości optymalizacji wydajności. Użycie tej wartości powoduje największe opóźnienie.

SpeedReadingInterval

Wskaźnik gęstości ruchu na ciągłym odcinku polilinii lub ścieżki. W przypadku ścieżki z punktami P_0, P_1, ..., P_N (indeksowanie od zera) parametr SpeedReadingInterval definiuje przedział i opisuje ruch w nim za pomocą tych kategorii:

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału na polilinii.
end_polyline_point_index

int32

Indeks końcowy tego przedziału w linii łamanej.
Pole unii speed_type. Rodzaj prędkości w tym przedziale. speed_type może mieć tylko jedną z tych wartości:
speed

Speed

Prędkość ruchu w tym przedziale.

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ść, brak opóźnień w ruchu.
SLOW Wykryto spowolnienie, średnie natężenie ruchu.
TRAFFIC_JAM Opóźnienia w ruchu.

TollInfo

Zawiera informacje o opłatach na urządzeniu Route lub RouteLeg.

Pola
estimated_price[]

Money

Wartość pieniężna opłat za przejazd w przypadku odpowiedniego Route lub RouteLeg. Ta lista zawiera kwotę w każdej walucie, która ma zostać pobrana przez punkty poboru opłat. Zazwyczaj ta lista zawiera tylko 1 element w przypadku tras z opłatami w jednej walucie. W przypadku przejazdów międzynarodowych lista może zawierać kilka pozycji, aby odzwierciedlać opłaty w różnych walutach.

TollPass

Lista winiet z całego świata, które obsługujemy.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nie używane. Jeśli ta wartość zostanie użyta, żądanie się nie powiedzie.
AU_ETOLL_TAG winieta w Sydney, Więcej informacji znajdziesz na https://www.myetoll.com.au.
AU_EWAY_TAG winieta w Sydney, Więcej informacji znajdziesz na https://www.tollpay.com.au.
AU_LINKT Winieta obowiązująca w całej Australii. Więcej informacji znajdziesz na 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, Dodatkowe informacje 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 stronie https://movemais.com.
BR_PASSA_RAPIDO winieta w Brazylii, Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR winieta w Brazylii, Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY winieta w Brazylii, Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE winieta w Brazylii, Dodatkowe informacje znajdziesz na stronie https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD przejście graniczne między Kanadą a Stanami Zjednoczonymi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD przejście graniczne między Kanadą a Stanami Zjednoczonymi.
CA_US_BLUE_WATER_EDGE_PASS Przejście graniczne między Ontario w Kanadzie a Michigan w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne między Ontario w Kanadzie a Michigan w Stanach Zjednoczonych.
CA_US_NEXUS_CARD przejście graniczne między Kanadą a Stanami Zjednoczonymi.
ID_E_TOLL Indonezja. Karta elektroniczna udostępniana przez wiele banków, służąca do płacenia za przejazdy autostradą. Wszystkie karty elektroniczne wydawane przez banki są obciążane w ten sam sposób, więc wystarczy jedna wartość wyliczeniowa. Np. Bank Mandiri https://www.bankmandiri.co.id/e-money, BCA https://www.bca.co.id/flazz, BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indie.
IN_LOCAL_HP_PLATE_EXEMPT Indie, zwolnienie z obowiązku rejestracji w stanie HP.
JP_ETC Japonia ETC. Elektroniczny system bezprzewodowy do pobierania opłat za przejazd. https://www.go-etc.jp/
JP_ETC2 Japonia ETC2.0. Nowa wersja ETC z dodatkowym rabatem i dwukierunkową komunikacją między urządzeniami w pojazdach a antenami na drodze. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksykański identyfikator opłat drogowych. https://iave.capufe.gob.mx/#/
MX_PASE Meksyk https://www.pase.com.mx
MX_QUICKPASS Meksyk https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Meksyk
MX_TAG_TELEVIA firma zajmująca się winietami w Meksyku; Jedna z wielu działających w Meksyku. Więcej informacji znajdziesz na stronie https://www.televia.com.mx.
MX_TELEVIA firma zajmująca się winietami w Meksyku; Jedna z wielu działających w Meksyku. https://www.televia.com.mx
MX_VIAPASS winieta w Meksyku, Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że kierowca ma dowolny karnet FasTrak oprócz naklejki DMV Clean Air Vehicle (CAV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
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. Wycofany, 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, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS NY, USA.
US_NY_EZPASSNY NY, USA.
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, 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 WV, Stany Zjednoczone
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

To pole określa jedno z założeń, które należy zastosować podczas obliczania czasu podróży w warunkach drogowych. Są one wymienione w poniższych wyliczeniach. W zależności od wybranego wyliczenia pole duration w odpowiedzi TrafficModel będzie się różnić. Wartość zawiera przewidywany czas dotarcia do miejsca docelowego w ruchu drogowym na podstawie średnich wartości historycznych. TrafficModel jest dostępna tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode ma wartość DRIVE.

Wartości w polu enum
TRAFFIC_MODEL_UNSPECIFIED Nieużywane. Jeśli podasz tu jakąś wartość, domyślnie zostanie użyta wartość BEST_GUESS.
BEST_GUESS Wskazuje, że zwrócona wartość duration powinna być najlepszym oszacowaniem czasu podróży na podstawie historycznych i bieżących informacji o natężeniu ruchu. Im bliżej teraźniejszości jest departure_time, tym większe znaczenie ma ruch na żywo.
PESSIMISTIC Oznacza, że zwrócony czas trwania powinien być dłuższy niż rzeczywisty czas podróży w większości dni, chociaż w niektóre dni, gdy warunki drogowe są szczególnie złe, może być dłuższy.
OPTIMISTIC Wskazuje, że zwrócony czas trwania powinien być krótszy niż rzeczywisty czas podróży w większości dni, chociaż w niektóre dni, gdy warunki drogowe są szczególnie dobre, podróż może trwać krócej niż ta wartość.

TransitAgency

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

Pola
name

string

Nazwa tego przewoźnika.
phone_number

string

Numer telefonu agencji transportu publicznego w formacie odpowiednim dla danego regionu.
uri

string

Identyfikator URI przewoźnika.

TransitLine

Zawiera informacje o linii transportu publicznego użytej na tym etapie.

Pola
agencies[]

TransitAgency

Przewoźnik (lub przewoźnicy) obsługujący tę linię transportu publicznego.
name

string

Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”.
uri

string

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

string

Kolor powszechnie używany w oznaczeniach tej linii. Reprezentowane w formacie szesnastkowym.
icon_uri

string

Identyfikator URI ikony powiązanej z tym wierszem.
name_short

string

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

string

Kolor powszechnie używany w tekście na oznakowaniu tej linii. Reprezentowane w formacie szesnastkowym.
vehicle

TransitVehicle

Rodzaj pojazdu, który kursuje na tej linii transportu publicznego.

TransitPreferences

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

Pola
allowed_travel_modes[]

TransitTravelMode

Zestaw środków transportu, które mają być używane podczas wyznaczania TRANSIT trasy. Domyślnie są to wszystkie obsługiwane środki transportu.
routing_preference

TransitRoutingPreference

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

TransitRoutingPreference

Określa preferencje routingu dla tras transportu publicznego.

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

TransitTravelMode

Zestaw wartości służący 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óżuj metrem.
TRAIN Podróżowanie pociągiem.
LIGHT_RAIL Podróżuj koleją miejską lub tramwajem.
RAIL Podróżowanie koleją. Jest to odpowiednik połączenia SUBWAY, TRAIN i LIGHT_RAIL.

TransitStop

Informacje o przystanku transportu publicznego.

Pola
name

string

Nazwa przystanku.
location

Location

Lokalizacja przystanku wyrażona za pomocą 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

rodzaj używanego pojazdu;
icon_uri

string

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

string

Identyfikator URI ikony powiązanej z tym typem pojazdu na podstawie lokalnych znaków transportowych.

TransitVehicleType

Rodzaj pojazdów na trasach transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywane.
BUS autobus.
CABLE_CAR Pojazd poruszający się po kablu, zwykle po ziemi. Koleje linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY promem,
FUNICULAR Pojazd wciągany na strome wzniesienie za pomocą liny. Kolejka linowo-terenowa składa się zwykle z 2 wagonów, z których każdy stanowi przeciwwagę dla drugiego.
GONDOLA_LIFT kolejka gondolowa,
HEAVY_RAIL Kolej dużych prędkości.
HIGH_SPEED_TRAIN Pociąg szybkobieżny.
INTERCITY_BUS Autobus dalekobieżny.
LONG_DISTANCE_TRAIN Pociąg dalekobieżny.
METRO_RAIL Kolej miejska.
MONORAIL kolej jednoszynowa,
OTHER Wszystkie inne pojazdy.
RAIL kolejową,
SHARE_TAXI Taksówka współdzielona to rodzaj autobusu, który może wysadzać i zabierać pasażerów w dowolnym miejscu na trasie.
SUBWAY Podziemna kolej miejska.
TRAM Kolej miejska naziemna.
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 wywnioskowana z żądania.
METRIC Jednostki miary w systemie metrycznym.
IMPERIAL Jednostki imperialne (angielskie).

VehicleEmissionType

Zestaw wartości opisujących typ emisji 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 zasilany benzyną.
ELECTRIC Pojazd zasilany energią elektryczną.
HYBRID pojazd hybrydowy (np. benzynowy i elektryczny);
DIESEL Pojazd z silnikiem Diesla.

VehicleInfo

Zawiera informacje o pojeździe, np. typ emisji.

Pola
emission_type

VehicleEmissionType

Opisuje typ emisji pojazdu. Dotyczy tylko DRIVE RouteTravelMode.

Punkt pośredni

Zawiera punkt pośredni. Punkty pośrednie wyznaczają początek i koniec trasy oraz obejmują przystanki pośrednie.

Pola
via

bool

Oznacza ten punkt jako punkt orientacyjny, a nie miejsce docelowe. W przypadku każdego punktu pośredniego w żądaniu, który nie jest punktem przelotowym, odpowiedź dodaje wpis do tablicy legs, aby podać szczegóły postojów na tym etapie podróży. Ustaw tę wartość na „true”, jeśli chcesz, aby trasa przebiegała przez ten punkt pośredni bez zatrzymywania się. Punkty pośrednie nie powodują dodania wpisu do tablicy legs, ale wyznaczają trasę podróży przez ten punkt. Tę wartość możesz ustawić tylko w przypadku pośrednich punktów trasy. Jeśli ustawisz to pole w przypadku punktów końcowych, żądanie się nie powiedzie. Jeśli pole ComputeRoutesRequest.optimize_waypoint_order ma wartość „true”, tego pola nie można ustawić na „true”. W przeciwnym razie żądanie zakończy się niepowodzeniem.
vehicle_stopover

bool

Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, które mają się w nim zatrzymać w celu odbioru lub wysadzenia pasażerów. Jeśli ustawisz tę wartość, obliczona trasa nie będzie obejmować punktów pośrednich innych niż via na drogach, które nie nadają się do odbioru i wysadzania pasażerów. Ta opcja działa tylko w przypadku trybów podróży DRIVE i TWO_WHEELER oraz gdy location_type ma wartość Location.
side_of_road

bool

Wskazuje, że lokalizacja tego punktu trasy ma preferencję, aby pojazd zatrzymał się po określonej stronie drogi. Gdy ustawisz tę wartość, trasa będzie przebiegać przez daną lokalizację, aby pojazd mógł zatrzymać się po stronie drogi, w kierunku której jest ona przesunięta od środka drogi. Ta opcja działa tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.
Pole unii location_type. Różne sposoby przedstawiania lokalizacji. location_type może mieć tylko jedną z tych wartości:
location

Location

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

string

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

string

Adres w formie czytelnej dla człowieka lub kod Plus Code. Więcej informacji znajdziesz na https://plus.codes.