Package google.maps.routing.v2

Indeks

Trasy

Interfejs Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Możesz podać maskę pola odpowiedzi, używając parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (patrz dostępne parametry i nagłówki URL). Wartość to lista ścieżek pól rozdzielona przecinkami. Zapoznaj się z szczegółową dokumentacją dotyczącą tworzenia ścieżek pól.

Na przykład w tej metodzie:

  • Maska pól wszystkich dostępnych pól (do ręcznej kontroli): X-Goog-FieldMask: *
  • Maska pola z czasami trwania trasy, odległościami, stanem i warunkami elementu oraz indeksami elementów (przykładowe ustawienie produkcyjne): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Ważne jest, aby w masce pola uwzględnić status, ponieważ w przeciwnym razie wszystkie wiadomości będą wyświetlane jako OK. Google nie zaleca używania maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wynik z mniejszym opóźnieniem.
  • Wybranie tylko tych pól, których potrzebujesz w produkcyjnym zadaniu, zapewnia stabilną wartość opóźnienia. W przyszłości możemy dodać więcej pól odpowiedzi, a to może wydłużyć czas obliczeń. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować pogorszenie wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje mniejszy rozmiar odpowiedzi, a co za tym idzie, większą przepustowość sieci.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Zwraca główną trasę wraz z opcjonalnymi trasami alternatywnymi, biorąc pod uwagę zestaw punktów docelowych i punktów pośrednich.

UWAGA: ta metoda wymaga podania w danych wejściowych maski pola odpowiedzi. Możesz podać maskę pola odpowiedzi, używając parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (patrz dostępne parametry i nagłówki URL). Wartość to lista ścieżek pól rozdzielona przecinkami. Zapoznaj się ze szczegółową dokumentacją dotyczącą tworzenia ścieżek pól.

Na przykład w tej metodzie:

  • Maska pól wszystkich dostępnych pól (do ręcznej kontroli): X-Goog-FieldMask: *
  • Maska pól Czas trwania na poziomie trasy, Odległość i Wielokąt (przykładowa konfiguracja produkcyjna): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Nie zalecamy używania symbolu wieloznacznego (*) w masie odpowiedzi ani określania maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybranie tylko tych pól, których potrzebujesz, pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwrócić Ci wynik z mniejszym opóźnieniem.
  • Wybranie tylko tych pól, których potrzebujesz w produkcyjnym zadaniu, zapewnia stabilną wartość opóźnienia. W przyszłości możemy dodać więcej pól odpowiedzi, a to może wydłużyć czas obliczeń. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować pogorszenie wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje mniejszy rozmiar odpowiedzi, a co za tym idzie, większą przepustowość sieci.

ComputeRouteMatrixRequest

Komunikat z prośbą o obliczenie macierzy tras

Pola
origins[]

RouteMatrixOrigin

Wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. Moc zbioru źródeł i miejsc docelowych podlega kilku ograniczeniom rozmiaru:

  • Suma liczby miejsc pochodzenia + liczba miejsc docelowych podanych jako place_id lub address nie może przekraczać 50.
  • Wynik mnożenia liczby miejsc pochodzenia x liczba miejsc docelowych nie może być większy niż 625.
  • Jeśli atrybut 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 miejsc wylotu i liczba miejsc docelowych nie może być większa niż 100.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

Opcjonalnie. Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie. Określa sposób obliczania trasy. Serwer próbuje użyć wybranych preferencji routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Możesz ustawić 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 wyjazdu. Jeśli nie ustawisz tej wartości, zostanie ona domyślnie zdefiniowana jako czas wysłania żądania. UWAGA: wartość departure_time możesz określić w przeszłości 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 podać wartość departure_time lub arrival_time, ale nie obie.
language_code

string

Opcjonalnie. Kod języka BCP-47, np. „pl-PL” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator języka w standardzie Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługiwane języki. Jeśli nie podasz tej wartości, język wyświetlania zostanie wywnioskowany na podstawie lokalizacji pierwszego źródła.
region_code

string

Opcjonalnie. Kod regionu podany jako 2-znakowa wartość domeny krajowej najwyższego poziomu. Więcej informacji znajdziesz w artykule Domena krajowa 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 wykonania żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą też być określone w masce pola, aby mogły być zwracane w odpowiedzi.
traffic_model

TrafficModel

Opcjonalnie. Określa założenia stosowane podczas obliczania czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu duration w elementach RouteMatrixElement, które zawierają przewidywany czas w ruchu na podstawie średnich wartości historycznych. Opcja TrafficModel jest dostępna tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode – wartość DRIVE. Jeśli żądany jest ruch, a wartość TrafficModel nie została podana, domyślnie przyjmuje się BEST_GUESS.
transit_preferences

TransitPreferences

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

ExtraComputation

dodatkowe obliczenia do wykonania podczas realizacji prośby;

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość nie zostaną zrealizowane.
TOLLS Informacje o opłatach za elementy macierzy.

ComputeRoutesRequest

Komunikat z prośbą o obliczenie tras.

Pola
origin

Waypoint

Wymagane. Punkt początkowy.
destination

Waypoint

Wymagane. Punkt docelowy.
intermediates[]

Waypoint

Opcjonalnie. zestaw punktów pośrednich na trasie (z wyłączeniem punktów końcowych), na których można się zatrzymać lub przejeżdżać obok; Obsługiwanych jest maksymalnie 25 punktów pośrednich.
travel_mode

RouteTravelMode

Opcjonalnie. Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie. Określa sposób obliczania trasy. Serwer próbuje użyć wybranych preferencji routingu do obliczenia trasy. Jeśli preferencja routingu powoduje błąd lub wydłuża czas oczekiwania, zwracany jest błąd. Możesz ustawić 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 preferowaną jakość polilinii.
polyline_encoding

PolylineEncoding

Opcjonalnie. Określa preferowane kodowanie łańcucha wielokątów.
departure_time

Timestamp

Opcjonalnie. Godzina wyjazdu. Jeśli nie ustawisz tej wartości, zostanie ona domyślnie zdefiniowana jako czas wysłania żądania. UWAGA: wartość departure_time możesz określić w przeszłości tylko wtedy, gdy ustawienie RouteTravelMode ma wartość TRANSIT. Podróże komunikacją zbiorową są dostępne do 7 dni wstecz lub do 100 dni wprzód.
arrival_time

Timestamp

Opcjonalnie. Godzina przyjazdu. UWAGA: można ustawić tylko wtedy, gdy ustawienie RouteTravelMode ma wartość TRANSIT. Możesz podać wartość departure_time lub arrival_time, ale nie obie. Podróże komunikacją zbiorową są dostępne do 7 dni wstecz lub do 100 dni wprzód.
compute_alternative_routes

bool

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

RouteModifiers

Opcjonalnie. Zestaw warunków, które należy spełnić, a które wpływają na sposób obliczania tras.
language_code

string

Opcjonalnie. Kod języka BCP-47, np. „pl-PL” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator języka w standardzie Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługiwane języki. Jeśli nie podasz tej wartości, język wyświetlania zostanie wywnioskowany na podstawie lokalizacji żądania trasy.
region_code

string

Opcjonalnie. Kod regionu podany jako 2-znakowa wartość domeny krajowej najwyższego poziomu. Więcej informacji znajdziesz w artykule Domena krajowa najwyższego poziomu.
units

Units

Opcjonalnie. Określa jednostki miary dla pól wyświetlania. Te pola obejmują pole instruction w sekcji NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary używane w przypadku trasy, etapu, odległości kroku i czasu trwania. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną wywnioskowane na podstawie lokalizacji pierwszego punktu początkowego.
optimize_waypoint_order

bool

Opcjonalnie. Jeśli ta opcja ma wartość Prawda, usługa próbuje zminimalizować całkowity koszt trasy przez zmianę kolejności podanych punktów pośrednich. Żądanie nie powiedzie się, jeśli któryś z punktów pośrednich jest punktem docelowym via. Aby znaleźć nową kolejność, użyj ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index. Jeśli w nagłówku X-Goog-FieldMask nie ma informacji o ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli opcja optimize_waypoint_order ma wartość Fałsz, opcja ComputeRoutesResponse.optimized_intermediate_waypoint_index będzie pusta.
requested_reference_routes[]

ReferenceRoute

Opcjonalnie. Określa, jakie trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa, która ma inny cel obliczenia niż trasa domyślna. Na przykład obliczenie trasy referencyjnej FUEL_EFFICIENT uwzględnia różne parametry, które pozwoliłyby wygenerować optymalną trasę o niskim zużyciu paliwa. Podczas korzystania z tej funkcji sprawdź, czy na uzyskanych trasach jest widoczna ikona route_labels.
extra_computations[]

ExtraComputation

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

TrafficModel

Opcjonalnie. Określa założenia stosowane podczas obliczania czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu Czas trwania w elementach Route i RouteLeg, która zawiera przewidywany czas trwania ruchu na podstawie średnich historycznych. Opcja TrafficModel jest dostępna tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode – wartość DRIVE. Jeśli żądany jest ruch, a wartość TrafficModel nie została podana, domyślnie przyjmuje się BEST_GUESS.
transit_preferences

TransitPreferences

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

ExtraComputation

dodatkowe obliczenia do wykonania podczas realizacji prośby;

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość nie zostaną zrealizowane.
TOLLS informacje o opłatach za przejazd na trasie lub trasach;
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasie.
TRAFFIC_ON_POLYLINE Odcinki polilinii uwzględniające natężenie ruchu na trasie.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions przedstawiony jako sformatowany ciąg tekstowy w formacie HTML. Te treści są przeznaczone do odczytu w postaci, w której zostały przesłane. Są one przeznaczone wyłącznie do wyświetlania. Nie analizuj go programowo.
FLYOVER_INFO_ON_POLYLINE informacje o przelocie nad trasą lub trasami. Aby zwrócić te informacje, musisz podać maskę pola routes.polyline_details.flyover_info. Obecnie te dane będą wypełniane tylko w przypadku niektórych aglomeracji w Indiach. Ta funkcja jest eksperymentalna, a cena może ulec zmianie.
NARROW_ROAD_INFO_ON_POLYLINE informacje o drogach na wybranych odcinkach trasy, Aby zwrócić te informacje, musisz podać maskę pola routes.polyline_details.narrow_road_info. Obecnie te dane będą wypełniane tylko w przypadku niektórych aglomeracji w Indiach. Ta funkcja jest eksperymentalna, a cena może ulec zmianie.

ReferenceRoute

Obsługiwana trasa referencyjna w ComputeRoutesRequest.

Wartości w polu enum
REFERENCE_ROUTE_UNSPECIFIED Nieużywane. Prośby zawierające tę wartość nie są realizowane.
FUEL_EFFICIENT Trasa z najniższym spalaniem.
SHORTER_DISTANCE

Trasa o krótszym dystansie. To funkcja eksperymentalna.

W przypadku żądań DRIVE ta funkcja stawia na pierwszym miejscu krótszą odległość, a nie na komforcie jazdy. Może na przykład preferować drogi lokalne zamiast autostrad, wybierać drogi gruntowe, omijać parkingi itp. Ta funkcja nie zwraca żadnych manewrów, które według Map Google są nielegalne.

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

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

ComputeRoutesResponse

Oblicza trasy dla wiadomości zwrotnej.

Pola
routes[]

Route

Jeśli podasz parametr compute_alternatives_routes, zawiera tablicę obliczonych tras (maksymalnie 3), a jeśli nie, zawiera tylko jedną trasę. Jeśli tablica zawiera wiele wpisów, pierwszy 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 może obliczyć trasy z uwzględnieniem wszystkich preferencji, może użyć innego sposobu obliczeń. Gdy używany jest tryb zapasowy, to pole zawiera szczegółowe informacje o odpowiednich odpowiedziach. W przeciwnym razie to pole nie jest ustawione.
geocoding_results

GeocodingResults

Zawiera informacje o odpowiedzi na geokodowanie dla punktów kontrolnych podanych jako adresy.

FallbackInfo

Informacje o tym, jak i dlaczego użyto wyniku zastępczego. Jeśli to pole jest ustawione, oznacza to, że serwer użył innego trybu kierowania niż preferowany jako tryb domyślny.

Pola
routing_mode

FallbackRoutingMode

Tryb routingu użyty na potrzeby odpowiedzi. Jeśli został uruchomiony tryb awaryjny, może on być inny niż preferencja routingu ustawiona w pierwotnym żądaniu klienta.
reason

FallbackReason

powód, dla którego zamiast pierwotnej odpowiedzi użyto odpowiedzi zastępczej. To pole jest wypełniane tylko wtedy, gdy zostanie uruchomiony tryb zastępczy i zwrócona zostanie odpowiedź zastępcza.

FallbackReason

Powody stosowania odpowiedzi zastępczej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED Nie podano powodu korzystania z tego rozwiązania.
SERVER_ERROR Podczas obliczania trasy w preferowanym trybie nawigacji 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 ukończyć obliczeń w preferowanym trybie kierowania, ale udało się uzyskać wynik obliczony w trybie alternatywnym.

FallbackRoutingMode

Rzeczywisty tryb kierowania użyty do zwróconej odpowiedzi zastępczej.

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

GeocodedWaypoint

Szczegóły dotyczące lokalizacji używanych jako punkty pośrednie. Wartość jest podawana tylko w przypadku punktów adresowych. Zawiera szczegółowe informacje o wynikach geokodowania w celu określenia, do czego adres został zakodowany.

Pola
geocoder_status

Status

Wskazuje kod stanu z operacji geokodowania.
type[]

string

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

bool

Wskazuje, że geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, ale udało mu się dopasować część adresu. Warto sprawdzić pierwotne żądanie pod kątem literówek lub niepełnego adresu.
place_id

string

Identyfikator miejsca odpowiadający temu wynikowi.
intermediate_waypoint_request_index

int32

Indeks odpowiedniego punktu pośredniego w żądaniu. Jest wypełnione tylko wtedy, gdy odpowiadający punkt drogi jest punktem drogi pośrednim.

GeocodingResults

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

Pola
origin

GeocodedWaypoint

Punkt kontrolny z geokodowaniem źródłowym.
destination

GeocodedWaypoint

Miejsce docelowe z geokodowanym punktem kontrolnym.
intermediates[]

GeocodedWaypoint

Lista pośrednich zgeokodowanych punktów drogi, z których każdy zawiera pole indeksu odpowiadające pozycji punktu drogi liczonej od zera w kolejności podanej w żądaniu.

LocalizedTime

Zlokalizowany opis czasu.

Pola
time

LocalizedText

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

string

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

Lokalizacja

Zawiera lokalizację (punkt geograficzny i opcjonalnie kierunek).

Pola
lat_lng

LatLng

Współrzędne geograficzne punktu drogi.
heading

Int32Value

Kierunek kompasu związany z kierunkiem ruchu. Ta wartość określa stronę drogi, po której odbywa się odbiór i odwożenie. Wartości kierunku mogą się wahać od 0 do 360, gdzie 0 oznacza kierunek na północ, 90 – na wschód itd. Z tego pola możesz korzystać tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.

Manewr

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

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywane.
TURN_SLIGHT_LEFT Obróć się lekko w lewo.
TURN_SHARP_LEFT Ostre skręcenie w lewo.
UTURN_LEFT Skręć w lewo.
TURN_LEFT Skręć w lewo.
TURN_SLIGHT_RIGHT Skręć lekko w prawo.
TURN_SHARP_RIGHT Ostre skręcenie w prawo.
UTURN_RIGHT wykonać skręt w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Jedź prosto.
RAMP_LEFT Skręć w lewo.
RAMP_RIGHT Skręć w prawo.
MERGE Włączanie się do ruchu.
FORK_LEFT Skręć w lewo.
FORK_RIGHT Skręć w prawo.
FERRY Promem.
FERRY_TRAIN Weź pociąg na prom.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
DEPART Manewr początkowy.
NAME_CHANGE Służy do wskazania zmiany nazwy ulicy.

Zawiera instrukcje nawigacji do RouteLegStep.

Pola
maneuver

Maneuver

Zawiera instrukcje nawigacyjne dotyczące bieżącego kroku (np. skręć w lewo, włącz się do głównej drogi 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 łamany. Wartość domyślna to encoded_polyline. polyline_type może być tylko jednym z tych elementów:
encoded_polyline

string

Kodowanie ciągu znaków linii łamanej za pomocą algorytmu kodowania linii łamanej
geo_json_linestring

Struct

Określa wielokąt w formacie GeoJSON LineString.

PolylineDetails

Szczegóły odpowiadające danemu indeksowi lub ciągłemu segmentu ścieżki wielopunktowej. W przypadku łamany z punktami P_0, P_1,…, P_N (indeksowany od zera) element PolylineDetails definiuje przedział i powiązane z nim metadane.

Pola
flyover_info[]

FlyoverInfo

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

NarrowRoadInfo

szczegóły wąskich dróg wzdłuż polilinii;

FlyoverInfo

Zawiera informacje o przelotach wzdłuż polilinii.

Pola
flyover_presence

RoadFeatureState

Tylko dane wyjściowe. Wskazuje, czy w przypadku danego odcinka polilinii istnieje widok z lotu.
polyline_point_index

PolylinePointIndex

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

NarrowRoadInfo

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

Pola
narrow_road_presence

RoadFeatureState

Tylko dane wyjściowe. Wskazuje, czy na danym odcinku ścieżki wielokąta występuje wąska droga.
polyline_point_index

PolylinePointIndex

Lokalizacja informacji o wąskich drogach wzdłuż linii łamanej.

PolylinePointIndex

Zawiera indeksy początkowy i końcowy szczegółu ścieżki wielokąta. W przypadku danych odpowiadających pojedynczemu punktowi wartości start_index i end_index będą takie same.

Pola
start_index

int32

Indeks początkowy tego elementu w wielokącie.
end_index

int32

Wskazuje koniec tego elementu w wielokącie.

RoadFeatureState

Zawiera stany obiektów drogowych na odcinku linii łamanej.

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

PolylineEncoding

Określa preferowany typ wielokąta do zwrócenia.

Wartości w polu enum
POLYLINE_ENCODING_UNSPECIFIED Nie określono preferowanego typu łańcucha wielokątów. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE Określa linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanej.
GEO_JSON_LINESTRING Określa wielokąt w formacie GeoJSON LineString.

PolylineQuality

Zestaw wartości określających jakość polilinii.

Wartości w polu enum
POLYLINE_QUALITY_UNSPECIFIED Nie określono preferencji dotyczących jakości ścieżki wielopunktowej. Domyślna wartość to OVERVIEW.
HIGH_QUALITY Określa wielobok wysokiej jakości, który jest tworzony z większą liczbą punktów niż OVERVIEW, co powoduje zwiększenie rozmiaru odpowiedzi. Użyj tej wartości, gdy potrzebujesz większej precyzji.
OVERVIEW Określa ścieżkę ogólną, która jest zbudowana z małej liczby punktów. Użyj tej wartości, aby wyświetlić ogólny widok trasy. W przypadku tej opcji czas oczekiwania na żądanie jest krótszy niż w przypadku opcji HIGH_QUALITY.

Trasa

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

Pola
route_labels[]

RouteLabel

Etykiety dla Route, które są przydatne do identyfikowania konkretnych właściwości trasy do porównania z innymi.
legs[]

RouteLeg

zbiór odcinków (segmentów ścieżki między punktami orientacyjnymi), które tworzą trasę; Każdy etap odpowiada przejazdowi między dwoma stacjami, które nie są stacjami via.Waypoints Na przykład trasa bez pośrednich punktów kontrolnych ma tylko 1 etap. Trasa, która zawiera 1 punkt pośredni inny niż via, ma 2 odcinki. Trasa zawierająca 1 punkt pośredni via ma 1 etap. Kolejność odcinków odpowiada kolejności punktów pośrednich od origin do intermediates do destination.
distance_meters

int32

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

Duration

Czas potrzebny na przejechanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, będzie ona taka sama jak wartość static_duration. Jeśli ustawisz wartość routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, zostanie ona obliczona z uwzględnieniem warunków ruchu.
static_duration

Duration

Czas przejazdu trasy bez uwzględniania warunków na drodze.
polyline

Polyline

Linia łamana całej trasy. Ta polilinia jest połączoną polilinią wszystkich legs.
description

string

Opis trasy.
warnings[]

string

Tablica ostrzeżeń wyświetlanych 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 optimize_waypoint_order na Prawda, to pole będzie zawierać zoptymalizowane uporządkowanie punktów pośrednich. W przeciwnym razie to pole jest puste. Jeśli np. podasz następujące dane: „Pochodzenie: Los Angeles”, „Punkty pośrednie: Dallas, Bangor, Phoenix”, „Cel: Nowy Jork”, a zoptymalizowany porządek punktów pośrednich to „Phoenix, Dallas, Bangor”, to to pole będzie zawierać wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego podanego w danych punktu pośredniego.
localized_values

RouteLocalizedValues

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

string

Nieprzezroczysty token, który można przekazać do Navigation SDK w celu odtworzenia trasy podczas nawigacji. W przypadku zmiany trasy token ten zachowuje pierwotny zamiar podczas tworzenia trasy. Traktuj ten token jako nieprzejrzysty blok danych. Nie porównuj wartości w różnych żądaniach, ponieważ może się ona zmieniać, nawet jeśli usługa zwróci dokładnie tę samą trasę.

UWAGA: 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ługiwana w przypadku żądań z punktami pośrednimi.
polyline_details

PolylineDetails

Zawiera informacje o szczegółach na ścieżce poliliniowej.

RouteLocalizedValues

tekstowe reprezentacje niektórych właściwości;

Pola
distance

LocalizedText

Odległość do pokonania w postaci tekstu.
duration

LocalizedText

Czas trwania, reprezentowany w formie tekstowej i zlokalizowany pod kątem regionu zapytania. Uwzględnia warunki na drodze. Uwaga: jeśli nie poprosisz o informacje o ruchu, ta wartość będzie taka sama jak static_duration.
static_duration

LocalizedText

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

LocalizedText

Opłata za przejazd w formie tekstu.

RouteLabel

Etykiety dla Route, które są przydatne do identyfikowania konkretnych właściwości trasy do porównania z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślnie – nieużywane.
DEFAULT_ROUTE Domyślna „najlepsza” trasa zwrócona w wyniku obliczenia trasy.
DEFAULT_ROUTE_ALTERNATE alternatywa dla domyślnej „najlepszej” trasy; Gdy podasz parametr compute_alternative_routes, zostaną zwrócone takie trasy.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są optymalizowane pod kątem parametrów ekologicznych, takich jak zużycie paliwa.
SHORTER_DISTANCE Trasa o krótszej długości. To funkcja eksperymentalna.

RouteLeg

zawiera segment między punktami pośrednimi innymi niż via;

Pola
distance_meters

int32

Odległość do przebycia na etapie trasy w metrach.
duration

Duration

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

Duration

Czas przejazdu na danej trasie, obliczony bez uwzględnienia warunków na drodze.
polyline

Polyline

Całkowita linia łamana tego etapu, która obejmuje linie łamane poszczególnych step.
start_location

Location

Lokalizacja początkowa tego etapu. Ta lokalizacja może być inna niż podana w formularzu origin. Jeśli na przykład podany punkt origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.
end_location

Location

Miejsce docelowe tego etapu. Ta lokalizacja może być inna niż podana w formularzu 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 danym etapie. Każdy krok odpowiada jednej instrukcji nawigacji.
travel_advisory

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. o możliwych ograniczeniach w strefach ruchu, na etapie trasy.
localized_values

RouteLegLocalizedValues

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

StepsOverview

Informacje o krokach w RouteLeg. To pole jest wypełniane tylko w przypadku tras transportu publicznego.

RouteLegLocalizedValues

tekstowe reprezentacje niektórych właściwości;

Pola
distance

LocalizedText

Odległość do pokonania w postaci tekstu.
duration

LocalizedText

Czas trwania, reprezentowany w formie tekstowej i zlokalizowany pod kątem regionu zapytania. Uwzględnia warunki na drodze. Uwaga: jeśli nie żądasz informacji o ruchu, ta wartość jest taka sama jak wartość static_duration.
static_duration

LocalizedText

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

StepsOverview

Zawiera informacje ogólne o liście RouteLegStep.

Pola
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

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

Pola
navigation_instruction

NavigationInstruction

NawigacjaInstrukcja dotycząca segmentu multimodalnego.
travel_mode

RouteTravelMode

Środek transportu w przypadku segmentu multimodalnego.
step_start_index

int32

Odpowiadający mu indeks RouteLegStep, który jest początkiem segmentu multimodalnego.
step_end_index

int32

Odpowiadający mu indeks RouteLegStep, który jest końcem segmentu multimodalnego.

RouteLegStep

Zawiera segment ciągu RouteLeg. Krok odpowiada pojedynczej instrukcji nawigacji. Odcinki trasy składają się z etapów.

Pola
distance_meters

int32

Odległość do pokonania na tym etapie w metrach. W niektórych okolicznościach to pole może nie zawierać wartości.
static_duration

Duration

Czas przejazdu na tym etapie bez uwzględniania warunków na drodze. W niektórych okolicznościach to pole może nie zawierać wartości.
polyline

Polyline

Polilinia powiązana z tym krokiem.
start_location

Location

Lokalizacja początkowa tego kroku.
end_location

Location

Miejsce zakończenia tego kroku.
navigation_instruction

NavigationInstruction

wskazówki dotyczące nawigacji,
travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

Tekstowe reprezentacje właściwości obiektu RouteLegStep.
transit_details

RouteLegStepTransitDetails

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

RouteTravelMode

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

RouteLegStepLocalizedValues

tekstowe reprezentacje niektórych właściwości;

Pola
distance

LocalizedText

Odległość do pokonania w postaci tekstu.
static_duration

LocalizedText

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

RouteLegStepTransitDetails

Dodatkowe informacje dotyczące RouteLegStep związane z trasami TRANSIT.

Pola
stop_details

TransitStopDetails

Informacje o przystankach docelowych i odjazdowych na danym etapie.
localized_values

TransitDetailsLocalizedValues

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

string

Określa kierunek, w którym należy jechać daną linią, zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdowym. Kierunek jest często stacją końcową.
headway

Duration

Określa przewidywany czas jako czas trwania przejazdu z tego samego przystanku o tej porze. Jeśli na przykład wartość headway w sekundach wynosi 600, w przypadku spóźnienia autobusu musisz się liczyć z 10-minutowym oczekiwaniem.
transit_line

TransitLine

Informacje o linii transportu publicznego użytej na tym etapie.
stop_count

int32

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

stop_count

zwraca 3.
trip_short_text

string

Tekst wyświetlany w rozkładach i na tablicach informacyjnych, który informuje pasażerów o przejazdach tranzytowych. Tekst powinien jednoznacznie identyfikować przejazd w ramach dnia usł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 RouteTransitDetails.

Pola
arrival_time

LocalizedTime

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

LocalizedTime

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

TransitStopDetails

Szczegóły dotyczące przystanków transportu publicznego dla RouteLegStep.

Pola
arrival_stop

TransitStop

Informacje o przystanku docelowym dla danego kroku.
arrival_time

Timestamp

Szacowany czas dotarcia do miejsca docelowego.
departure_stop

TransitStop

Informacje o przystanku początkowym dla danego kroku.
departure_time

Timestamp

Szacowany czas wylotu.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. możliwe ograniczenia dotyczące stref ruchu na etapie podróży.

Pola
speed_reading_intervals[]

SpeedReadingInterval

UWAGA: to pole jest obecnie puste.

RouteLegTravelAdvisory

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

Pola
toll_info

TollInfo

Zawiera informacje o mytach na konkretnej RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd RouteLeg. Jeśli to pole jest ustawione, ale podpole estimated_price jest puste, zakładamy, że droga zawiera opłaty za przejazd, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, oznacza to, że na RouteLeg nie ma opłat.
speed_reading_intervals[]

SpeedReadingInterval

Interwały szybkości czytania określające gęstość ruchu. Dotyczy preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Interwały obejmują cały poligon RouteLeg bez nakładania się. Punkt początkowy określonego przedziału czasowego jest taki sam jak punkt końcowy poprzedniego przedziału czasowego.

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

Wymagane. Punkt docelowy

RouteMatrixElement

Zawiera informacje o trasie obliczonej dla pary miejsc pochodzenia i przeznaczenia w interfejsie ComputeRouteMatrix API. 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 przebycia na trasie w metrach.
duration

Duration

Czas potrzebny na przejechanie trasy. Jeśli ustawisz wartość routing_preference na TRAFFIC_UNAWARE, będzie ona taka sama jak wartość static_duration. Jeśli ustawisz wartość routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, zostanie ona obliczona z uwzględnieniem warunków ruchu.
static_duration

Duration

Czas przejazdu trasy bez uwzględnienia warunków na drodze.
travel_advisory

RouteTravelAdvisory

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

FallbackInfo

W niektórych przypadkach, gdy serwer nie może obliczyć trasy z uwzględnieniem podanych preferencji w przypadku danego połączenia między punktem początkowym a docelowym, może użyć innego trybu obliczeń. Gdy używany jest tryb zapasowy, to pole zawiera szczegółowe informacje o odpowiednich odpowiedziach. W przeciwnym razie to pole nie jest ustawione.
localized_values

LocalizedValues

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

int32

Źródło w żądaniu – indeks od 0.
destination_index

int32

Indeks miejsca docelowego w żądaniu liczony od zera.

LocalizedValues

tekstowe reprezentacje niektórych właściwości;

Pola
distance

LocalizedText

Odległość do pokonania w postaci tekstu.
duration

LocalizedText

Czas trwania w formie tekstowej uwzględniający warunki ruchu. Uwaga: jeśli nie przesłano żądania informacji o ruchu, ta wartość jest taka sama jak wartość static_duration.
static_duration

LocalizedText

Czas trwania w postaci tekstu bez uwzględniania warunków ruchu.
transit_fare

LocalizedText

Opłata za przejazd w formie tekstu.

RouteMatrixElementCondition

Stan zwracanej trasy.

Wartości w polu enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Używana tylko wtedy, gdy status elementu nie jest OK.
ROUTE_EXISTS Trasa została znaleziona, a odpowiednie informacje zostały wypełnione w przypadku tego elementu.
ROUTE_NOT_FOUND Nie znaleziono trasy. Pola zawierające informacje o trasie, takie jak distance_meters lub duration, nie będą wypełniane w elemencie.

RouteMatrixOrigin

Pojedyncze źródło dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

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

RouteModifiers

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

Pola
avoid_tolls

bool

Gdy ta opcja jest ustawiona na wartość true (prawda), omijanie dróg płatnych, jeśli to możliwe, na rzecz tras nieobejmujących dróg płatnych. Dotyczy tylko znaczników DRIVE i TWO_WHEELER RouteTravelMode.
avoid_highways

bool

Gdy ta opcja jest ustawiona na wartość Prawda, aplikacja omija autostrady, jeśli to możliwe, preferując trasy bez autostrad. Dotyczy tylko znaczników DRIVE i TWO_WHEELER RouteTravelMode.
avoid_ferries

bool

Jeśli ustawisz wartość prawda, aplikacja będzie unikać promów, jeśli to możliwe, i preferować trasy bez promów. Dotyczy tylko znaczników DRIVE i TWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Jeśli ustawisz wartość prawda, unikaj nawigacji w pomieszczeniach, jeśli to możliwe, preferując trasy bez nawigacji w pomieszczeniach. Dotyczy tylko WALK RouteTravelMode.
vehicle_info

VehicleInfo

Określa informacje o pojazdach.
toll_passes[]

TollPass

Zawiera informacje o winietach. Jeśli podane są winiety, interfejs API próbuje zwrócić ich cenę. Jeśli nie podasz karty, API uzna ją za nieznaną i spróbuje zwrócić cenę gotówkową. Dotyczy tylko znaczników DRIVE i TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. możliwe ograniczenia dotyczące stref ruchu.

Pola
toll_info

TollInfo

Zawiera informacje o mytach na trasie. To pole jest wypełnione tylko wtedy, gdy na trasie występują opłaty drogowe. Jeśli to pole jest ustawione, ale podpole estimatedPrice jest puste, oznacza to, że trasa zawiera opłaty za przejazd, ale szacunkowa cena jest nieznana. Jeśli to pole nie jest ustawione, na trasie nie ma żadnych opłat.
speed_reading_intervals[]

SpeedReadingInterval

Interwały szybkości czytania określające gęstość ruchu. Dotyczy preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Interwały obejmują cały poligon trasy bez nakładania się. Punkt początkowy określonego przedziału czasowego jest taki sam jak punkt końcowy poprzedniego przedziału czasowego.

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 mikrolitry.
route_restrictions_partially_ignored

bool

Zwrócona trasa może zawierać ograniczenia, które nie pasują do wybranego trybu podróży lub modyfikatorów trasy.
transit_fare

Money

W przypadku wystąpienia zawiera łączną cenę biletu na danej trasie. Ta właściwość jest zwracana tylko w przypadku żądań TRANSIT i tylko w przypadku tras, na których są dostępne informacje o cenie biletu dla wszystkich etapów przejazdu.

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 uwzględniać chodników, ścieżek dla pieszych ani ścieżek rowerowych. Musisz wyświetlać to ostrzeżenie użytkownikowi w przypadku wszystkich tras pieszych, rowerowych i dla pojazdów dwukołowych wyświetlanych w aplikacji.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie wybrano środka transportu. Domyślna wartość to DRIVE.
DRIVE podróż samochodem osobowym,
BICYCLE podróżować rowerem,
WALK Chodzenie.
TWO_WHEELER Dwukołowy pojazd mechaniczny. Na przykład motocykl. Pamiętaj, że BICYCLE to tryb podróży, który obejmuje tryb obsługiwany przez człowieka.
TRANSIT podróżować transportem publicznym (gdzie jest to możliwe).

RoutingPreference

Zestaw wartości określających czynniki, które należy wziąć pod uwagę podczas obliczania 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 rzeczywistych warunków ruchu. Odpowiedni, gdy warunki na drodze nie mają znaczenia lub nie mają zastosowania. Użycie tej wartości powoduje najniższe opóźnienie. Uwaga: w przypadku RouteTravelMode DRIVE i TWO_WHEELER wybrana trasa i czas trwania są określane na podstawie sieci drogowej i średnich warunków ruchu niezależnie od pory dnia, a nie aktualnych warunków na drodze. W związku z tym trasy mogą obejmować drogi, które są tymczasowo zamknięte. Wyniki dla danego żądania mogą się zmieniać w czasie z powodu zmian w sieci drogowej, zaktualizowanych średnich warunków ruchu i rozproszonej natury usługi. Wyniki mogą się też różnić między niemal identycznymi trasami w dowolnym czasie lub częstotliwości.
TRAFFIC_AWARE oblicza trasy, biorąc pod uwagę aktualne warunki na drodze; W przeciwieństwie do TRAFFIC_AWARE_OPTIMAL, niektóre optymalizacje są stosowane w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę warunki ruchu drogowego w czasie rzeczywistym, bez stosowania większości optymalizacji skuteczności. Użycie tej wartości powoduje największe opóźnienie.

SpeedReadingInterval

Wskaźnik gęstości ruchu na ciągłym odcinku wielokąta lub ścieżki. W przypadku ścieżki z punktami P_0, P_1, ... , P_N (indeks od 0) element SpeedReadingInterval definiuje przedział i opisuje ruch za pomocą tych kategorii.

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału w wielokącie.
end_polyline_point_index

int32

Indeks końcowy tego przedziału w wielokącie.

Pole unii speed_type.

speed_type może być tylko jednym z tych elementów:
speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

Klasyfikacja prędkości ścieżki 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ść, bez opóźnień w ruchu.
SLOW Wykryto spowolnienie, średnie natężenie ruchu.
TRAFFIC_JAM opóźnienia w ruchu,

TollInfo

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

Pola
estimated_price[]

Money

Kwota opłat za przejazd dla odpowiedniego Route lub RouteLeg. Ta lista zawiera kwoty w poszczególnych walutach, które mają być pobierane na stacjach opłat drogowych. Zazwyczaj lista zawiera tylko 1 element dla tras z opłatami drogowymi w jednej walucie. W przypadku podróży międzynarodowych lista może zawierać wiele pozycji, aby odzwierciedlać opłaty w różnych walutach.

TollPass

Lista obsługiwanych przez nas kart do opłat drogowych na całym świecie.

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywane. Jeśli ta wartość zostanie użyta, żądanie się nie powiedzie.
AU_ETOLL_TAG Winieta w Sydney. Więcej informacji znajdziesz na stronie https://www.myetoll.com.au.
AU_EWAY_TAG Winieta w Sydney. Więcej informacji znajdziesz na stronie https://www.tollpay.com.au.
AU_LINKT Winieta na terenie całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Winieta argentyńska. Więcej informacji znajdziesz na stronie https://telepase.com.ar.
BR_AUTO_EXPRESO Winieta brazylijska. Więcej informacji znajdziesz na stronie https://www.autoexpreso.com.
BR_CONECTCAR Winieta brazylijska. Więcej informacji znajdziesz na stronie https://conectcar.com.
BR_MOVE_MAIS Winieta brazylijska. Więcej informacji znajdziesz na stronie https://movemais.com.
BR_PASSA_RAPIDO Winieta brazylijska. Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR Winieta brazylijska. Więcej informacji znajdziesz na stronie https://www.semparar.com.br.
BR_TAGGY Winieta brazylijska. Więcej informacji znajdziesz na stronie https://taggy.com.br.
BR_VELOE Winieta brazylijska. Więcej informacji 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 Ontario w Kanadzie do Michigan w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne Ontario w Kanadzie do Michigan w Stanach Zjednoczonych.
CA_US_NEXUS_CARD Przejście graniczne Kanady z USA.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez wielu banków, używana do płacenia za opłaty drogowe. Wszystkie e-karty przez banki są obciążane w ten sam sposób, więc potrzebna jest tylko jedna wartość z enumeracji. Przykład: – Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indie.
IN_LOCAL_HP_PLATE_EXEMPT Indie, zwolnienie z obowiązku podatkowego w przypadku tablic rejestracyjnych stanów.
JP_ETC Japonia ETC. Bezprzewodowy system elektroniczny do pobierania opłat za przejazd autostradą. https://www.go-etc.jp/
JP_ETC2 Japonia ETC2.0. Nowa wersja ETC z dodatkowym rabatem i komunikacją dwukierunkową między urządzeniami w pojazdach a antenami na drodze. https://www.go-etc.jp/etc2/index.html
MX_IAVE Meksykancka karta do 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 Meksykańska firma zarządzająca systemem opłat drogowych. Jeden z wielu w Meksyku. Więcej informacji znajdziesz na stronie https://www.televia.com.mx.
MX_TELEVIA Meksykańska firma zarządzająca systemem opłat drogowych. Jeden z wielu operatorów w Meksyk (miasto). https://www.televia.com.mx
MX_VIAPASS Winieta meksykańska. Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, Stany Zjednoczone
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, Stany Zjednoczone.
US_CA_FASTRAK Kanada, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że kierowca ma kartę FastTrak oprócz naklejki DMV na pojazdy przyjazne środowisku. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Kolorado, Stany Zjednoczone
US_CO_GO_PASS Kolorado, Stany Zjednoczone
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floryda, Stany Zjednoczone.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floryda, Stany Zjednoczone.
US_FL_EPASS Floryda, Stany Zjednoczone.
US_FL_GIBA_TOLL_PASS Floryda, Stany Zjednoczone.
US_FL_LEEWAY Floryda, Stany Zjednoczone.
US_FL_SUNPASS Floryda, Stany Zjednoczone.
US_FL_SUNPASS_PRO Floryda, Stany Zjednoczone.
US_IL_EZPASSIL IL, Stany Zjednoczone.
US_IL_IPASS IL, Stany Zjednoczone.
US_IN_EZPASSIN IN, Stany Zjednoczone.
US_KS_BESTPASS_HORIZON KS, Stany Zjednoczone
US_KS_KTAG KS, Stany Zjednoczone
US_KS_NATIONALPASS KS, Stany Zjednoczone
US_KS_PREPASS_ELITEPASS KS, Stany Zjednoczone
US_LA_GEAUXPASS Los Angeles, Stany Zjednoczone.
US_LA_TOLL_TAG Los Angeles, Stany Zjednoczone.
US_MA_EZPASSMA MA, Stany Zjednoczone
US_MD_EZPASSMD Maryland, Stany Zjednoczone.
US_ME_EZPASSME ME, Stany Zjednoczone.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Stany Zjednoczone.
US_MI_BCPASS MI, Stany Zjednoczone.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Stany Zjednoczone.
US_MI_IQ_PROX_CARD

MI, Stany Zjednoczone. Wycofany, ponieważ ten typ dokumentu nie istnieje.
US_MI_IQ_TAG MI, Stany Zjednoczone.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Stany Zjednoczone.
US_MI_NEXPRESS_TOLL MI, Stany Zjednoczone.
US_MN_EZPASSMN MN, Stany Zjednoczone.
US_NC_EZPASSNC NC, Stany Zjednoczone.
US_NC_PEACH_PASS NC, Stany Zjednoczone.
US_NC_QUICK_PASS NC, Stany Zjednoczone.
US_NH_EZPASSNH NH, Stany Zjednoczone.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stany Zjednoczone.
US_NJ_EZPASSNJ NJ, Stany Zjednoczone.
US_NY_EXPRESSPASS Nowy Jork, Stany Zjednoczone.
US_NY_EZPASSNY Nowy Jork, Stany Zjednoczone.
US_OH_EZPASSOH Ohio, Stany Zjednoczone
US_PA_EZPASSPA Stany Zjednoczone, Pensylwania.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, Stany Zjednoczone.
US_TX_AVI_TAG Teksas, Stany Zjednoczone.
US_TX_BANCPASS Teksas, Stany Zjednoczone.
US_TX_DEL_RIO_PASS Teksas, Stany Zjednoczone.
US_TX_EFAST_PASS Teksas, Stany Zjednoczone.
US_TX_EAGLE_PASS_EXPRESS_CARD Teksas, Stany Zjednoczone.
US_TX_EPTOLL Teksas, Stany Zjednoczone.
US_TX_EZ_CROSS Teksas, Stany Zjednoczone.
US_TX_EZTAG Teksas, Stany Zjednoczone.
US_TX_FUEGO_TAG Teksas, Stany Zjednoczone.
US_TX_LAREDO_TRADE_TAG Teksas, Stany Zjednoczone.
US_TX_PLUSPASS Teksas, Stany Zjednoczone.
US_TX_TOLLTAG Teksas, Stany Zjednoczone.
US_TX_TXTAG Teksas, Stany Zjednoczone.
US_TX_XPRESS_CARD Teksas, Stany Zjednoczone.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Utah, Stany Zjednoczone.
US_VA_EZPASSVA VA, Stany Zjednoczone
US_WA_BREEZEBY WA, Stany Zjednoczone.
US_WA_GOOD_TO_GO Stany Zjednoczone, stan Waszyngton.
US_WV_EZPASSWV WV, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Stany Zjednoczone.
US_WV_MOV_PASS WV, Stany Zjednoczone
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stany Zjednoczone.

TrafficModel

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

Wartości w polu enum
TRAFFIC_MODEL_UNSPECIFIED Nieużywane. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna BEST_GUESS.
BEST_GUESS Wskazuje, że zwrócona wartość duration powinna być najlepszą estymacją czasu podróży na podstawie znanych informacji o warunkach ruchu w przeszłości i obecnym natężeniu ruchu. Im bliżej teraźniejszości, tym większy wpływ na departure_time ma ruch na żywo.
PESSIMISTIC Wskazuje, że zwrócony czas trwania powinien być dłuższy niż rzeczywisty czas podróży w większości dni, ale w niektórych dniach o szczególnie trudnych warunkach drogowych może przekroczyć tę wartość.
OPTIMISTIC Wskazuje, że zwrócony czas trwania powinien być krótszy niż rzeczywisty czas podróży w większości dni, ale w niektóre dni o szczególnie dobrych warunkach na drodze może być on krótszy niż ta wartość.

TransitAgency

Operator linii transportu publicznego.

Pola
name

string

Nazwa tego przewoźnika.
phone_number

string

Numer telefonu firmy transportowej w odpowiednim formacie dla danego regionu.
uri

string

Identyfikator URI przewoźnika.

TransitLine

Zawiera informacje o trasie 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 często używany w oznakowaniu tej linii. W formacie szesnastkowym.
icon_uri

string

Identyfikator URI ikony powiązanej z tą linią.
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 tabliczkach tej linii. W formacie szesnastkowym.
vehicle

TransitVehicle

Typ pojazdu, który obsługuje tę linię transportu publicznego.

TransitPreferences

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

Pola
allowed_travel_modes[]

TransitTravelMode

Zestaw środków transportu dostępnych podczas uzyskiwania informacji o trasie TRANSIT. Domyślnie są to wszystkie obsługiwane środki transportu.
routing_preference

TransitRoutingPreference

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

TransitRoutingPreference

Określa preferencje routingu dla tras tranzytowych.

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

TransitTravelMode

Zestaw wartości służących do określania trybu transportu.

Wartości w polu enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Nie wybrano środka transportu.
BUS Podróżowanie autobusem.
SUBWAY podróżować metrem,
TRAIN podróż pociągiem,
LIGHT_RAIL podróżować koleją miejską lub tramwajem;
RAIL podróżowanie koleją, Jest to równoważne kombinacji atrybutów SUBWAY, TRAIN i LIGHT_RAIL.

TransitStop

informacje o przystanku transportu publicznego;

Pola
name

string

Nazwa przystanku.
location

Location

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

TransitVehicle

Informacje o pojazdach używanych na trasach tranzytowych.

Pola
name

LocalizedText

Nazwa tego 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ązanej z tym typem pojazdu na podstawie lokalnych znaków drogowych.

TransitVehicleType

Typ pojazdu na trasach tranzytowych.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywane.
BUS Autobus.
CABLE_CAR Pojazd poruszający się na kablu, zwykle na ziemi. Koleje linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Prom.
FUNICULAR Pojazd ciągnięty na stromym wzniesieniu za pomocą kabla. Kolejka linowa składa się zwykle z 2 wagoników, z których każdy jest przeciwwagą dla drugiego.
GONDOLA_LIFT Kolej gondolowa.
HEAVY_RAIL Koleje ciężkie.
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 Rail.
SHARE_TAXI W ramach usługi wspólnego taksówek pasażerowie mogą wsiadać i wysiadać w dowolnym miejscu na trasie.
SUBWAY Podziemna kolej miejska.
TRAM Kolej miejska na powierzchni.
TROLLEYBUS Trolejbus.

Jednostki

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

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 metryczne.
IMPERIAL jednostki miary 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 wybrano typu emisji. Domyślnie GASOLINE.
GASOLINE Pojazd napędzany benzyną.
ELECTRIC Pojazd elektryczny.
HYBRID Pojazd hybrydowy (np. benzyna + elektryczność).
DIESEL Pojazd z silnikiem Diesla.

VehicleInfo

Zawiera informacje o pojazdach, takie jak rodzaj emisji.

Pola
emission_type

VehicleEmissionType

Opisuje rodzaj emisji pojazdu. Dotyczy tylko DRIVE RouteTravelMode.

Punkt pośredni

Zawiera punkt orientacyjny. Punkty pośrednie oznaczają początek i koniec trasy oraz zawierają przystanki pośrednie na trasie.

Pola
via

bool

Oznacza ten punkt kontrolny jako etap, a nie punkt postoju. W odpowiedzi na każdy punkt pośredni, który nie jest punktem pośrednim w ramach żądania, do tablicy legs dodawany jest wpis z informacjami o przesiadkach na tym etapie podróży. Ustaw tę wartość na „PRAWDA”, jeśli chcesz, aby trasa przebiegała przez ten punkt orientacyjny bez zatrzymywania się. Punkty pośrednie nie powodują dodania wpisu do tablicy legs, ale wyznaczają trasę przez punkt pośredni. Tę wartość możesz ustawić tylko w przypadku punktów pośrednich. Żądanie nie powiedzie się, jeśli to pole jest ustawione na punkty pośrednie terminala. Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, to pole nie może mieć wartości Prawda. W przeciwnym razie żądanie się nie powiedzie.
vehicle_stopover

bool

Wskazuje, że punkt drogi jest przeznaczony do zatrzymywania się pojazdów, gdzie zamierzają one zabrać lub wysadzić pasażerów. Po ustawieniu tej wartości obliczona trasa nie będzie zawierać punktów drogi o wartości innej niż via na drogach, które nie nadają się do zabierania 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 drogowego ma być preferowaną lokalizacją dla zatrzymania pojazdu po określonej stronie drogi. Po ustawieniu tej wartości trasa będzie przebiegać przez lokalizację, aby pojazd mógł się zatrzymać po tej stronie drogi, która jest zwrócona w stronę tej lokalizacji. 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 być tylko jednym z tych elementów:
location

Location

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

string

Identyfikator miejsca docelowego powiązany z punktem drogi.
address

string

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