Package google.maps.routing.v2

Indeks

• Routes (interfejs)
• ComputeRouteMatrixRequest (komunikat)
• ComputeRouteMatrixRequest.ExtraComputation (wyliczenie)
• ComputeRoutesRequest (komunikat)
• ComputeRoutesRequest.ExtraComputation (wyliczenie)
• ComputeRoutesRequest.ReferenceRoute (wyliczenie)
• ComputeRoutesResponse (komunikat)
• FallbackInfo (komunikat)
• FallbackReason (wyliczenie)
• FallbackRoutingMode (wyliczenie)
• GeocodedWaypoint (komunikat)
• GeocodingResults (komunikat)
• LocalizedTime (komunikat)
• Location (komunikat)
• Maneuver (wyliczenie)
• NavigationInstruction (komunikat)
• Polyline (komunikat)
• PolylineDetails (komunikat)
• PolylineDetails.BridgeInfo (komunikat)
• PolylineDetails.FlyoverInfo (komunikat)
• PolylineDetails.NarrowRoadInfo (komunikat)
• PolylineDetails.PolylinePointIndex (komunikat)
• PolylineDetails.RestrictionInfo (komunikat)
• PolylineDetails.RoadFeatureState (wyliczenie)
• PolylineDetails.SkywayInfo (komunikat)
• PolylineDetails.TunnelInfo (komunikat)
• PolylineEncoding (wyliczenie)
• PolylineQuality (wyliczenie)
• Route (komunikat)
• Route.RouteLocalizedValues (komunikat)
• RouteLabel (wyliczenie)
• RouteLeg (komunikat)
• RouteLeg.RouteLegLocalizedValues (komunikat)
• RouteLeg.StepsOverview (komunikat)
• RouteLeg.StepsOverview.MultiModalSegment (komunikat)
• RouteLegStep (komunikat)
• RouteLegStep.RouteLegStepLocalizedValues (komunikat)
• RouteLegStepTransitDetails (komunikat)
• RouteLegStepTransitDetails.TransitDetailsLocalizedValues (komunikat)
• RouteLegStepTransitDetails.TransitStopDetails (komunikat)
• RouteLegStepTravelAdvisory (komunikat)
• RouteLegTravelAdvisory (komunikat)
• RouteMatrixDestination (komunikat)
• RouteMatrixElement (komunikat)
• RouteMatrixElement.LocalizedValues (komunikat)
• RouteMatrixElementCondition (wyliczenie)
• RouteMatrixOrigin (komunikat)
• RouteModifiers (komunikat)
• RouteTravelAdvisory (komunikat)
• RouteTravelMode (wyliczenie)
• RoutingPreference (wyliczenie)
• SpeedReadingInterval (komunikat)
• SpeedReadingInterval.Speed (wyliczenie)
• TollInfo (komunikat)
• TollPass (wyliczenie)
• TrafficModel (wyliczenie)
• TransitAgency (komunikat)
• TransitLine (komunikat)
• TransitPreferences (komunikat)
• TransitPreferences.TransitRoutingPreference (wyliczenie)
• TransitPreferences.TransitTravelMode (wyliczenie)
• TransitStop (komunikat)
• TransitVehicle (komunikat)
• TransitVehicle.TransitVehicleType (wyliczenie)
• Units (wyliczenie)
• VehicleEmissionType (wyliczenie)
• VehicleInfo (komunikat)
• VehicleInfo.HazardousGoodsType (wyliczenie)
• VehicleInfo.TrailerInfo (komunikat)
• Waypoint (komunikat)

Trasy

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement) Przyjmuje listę miejsc początkowych i docelowych oraz zwraca strumień zawierający informacje o trasach dla każdej kombinacji miejsca początkowego i 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 OK. Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*), ponieważ: Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, co pozwala nam zwracać wyniki z mniejszym opóźnieniem. Wybranie 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 powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym zwiększenie przepustowości sieci.

ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse) Zwraca główną trasę wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu punktów końcowych i pośrednich. 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ładowa konfiguracja produkcyjna): 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, co pozwala nam zwracać wyniki z mniejszym opóźnieniem. Wybranie 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 powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym zwiększenie przepustowości sieci.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]	RouteMatrixOrigin Wymagane. Tablica punktów początkowych, która określa wiersze macierzy odpowiedzi. W przypadku mocy zbioru miejsc docelowych i źródeł 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 wylotu i miejsc docelowych nie może w żadnym przypadku przekraczać 625. Jeśli parametr 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 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 obliczyć trasę przy użyciu wybranej preferencji routingu. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo długie opóźnienie, zwracany jest błąd. Tę opcję można określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
departure_time	Timestamp Opcjonalnie. godzinę 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 standardzie 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 przejazdu 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 wysyłana jest prośba o ruch, 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 prośby.

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 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), w których można się zatrzymać lub przez które można przejechać. 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 obliczyć trasę przy użyciu wybranej preferencji routingu. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo długie opóźnienie, zwracany jest błąd. Tę opcję można 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 linii łamanej.
polyline_encoding	PolylineEncoding Opcjonalnie. Określa preferowane kodowanie polilinii.
departure_time	Timestamp Opcjonalnie. godzinę 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. Przejazdy transportem publicznym są dostępne do 7 dni wstecz lub 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. Przejazdy transportem publicznym są dostępne do 7 dni wstecz lub 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 muszą zostać spełnione i które wpływają na sposób obliczania tras.
language_code	string Opcjonalnie. Kod języka w standardzie 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. Ta wartość nie ma wpływu na jednostki miary używane w przypadku trasy, odcinka, odległości kroku i czasu trwania. 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 punktów pośrednich jest punktem 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 ComputeRoutesResponse.routes.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 generują optymalną trasę pod względem zużycia paliwa. Gdy korzystasz z tej funkcji, szukaj ikony route_labels na wyznaczonych trasach.
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óra zawiera przewidywany czas w ruchu na podstawie średnich wartości historycznych. Wartość 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 wysyłana jest prośba o ruch, 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 prośby. W przyszłości możemy dodać kolejne wartości.

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 trasy uwzględniające natężenie ruchu;
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstruction przedstawione jako sformatowany ciąg tekstowy HTML. Te treści mają być odczytywane w takiej formie, w jakiej są. Służą one wyłącznie do wyświetlania. 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 miejskich 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 miejskich w Indiach. Ta funkcja jest eksperymentalna, a kod SKU lub opłata mogą ulec zmianie.
TUNNEL_INFO_ON_POLYLINE	Informacje o tunelach na trasie. Aby zwrócić te informacje, musisz określić routes.polyline_details.tunnel_info fieldmask.
BRIDGE_INFO_ON_POLYLINE	Informacje o mostach na trasie. Aby zwrócić te informacje, musisz określić routes.polyline_details.bridge_info fieldmask.
SKYWAY_INFO_ON_POLYLINE	Informacje o drogach Skyway na trasie. Aby zwrócić te informacje, musisz określić routes.polyline_details.skyway_info fieldmask.

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, które Mapy Google uznają za nielegalne. 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 zostaną zrealizowane. Możesz jednak używać go z dowolnym routing_preference.

ComputeRoutesResponse

ComputeRoutes wiadomość z odpowiedzią.

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 awaryjny, tryb może się różnić od preferencji dotyczących routingu ustawionych 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 kreacji zastępczych i zostanie zwrócona odpowiedź kreacji zastępczej.

FallbackReason

Przyczyny użycia odpowiedzi rezerwowej.

Wartości w polu enum
FALLBACK_REASON_UNSPECIFIED	Nie podano powodu kreacji zastępczej.
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 wyznaczania trasy 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 dotyczące lokalizacji używanych jako punkty pośrednie. Wartość podawana tylko w przypadku punktów pośrednich adresu. Zawiera szczegółowe informacje o wynikach geokodowania, które pomagają określić, do jakiego adresu został przypisany kod geograficzny.

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 trasy jest punktem pośrednim.

GeocodingResults

Zawiera GeocodedWaypoints dla miejsca początkowego, docelowego i punktów pośrednich. Wartość podawana tylko w przypadku punktów pośrednich 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 pośrednich z geokodowaniem, z których każdy zawiera pole indeksu odpowiadające pozycji punktu pośredniego 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.

manewrowanie,

Zestaw wartości określających działanie nawigacyjne, które należy wykonać w bieżącym kroku (np. skręć w lewo, wjedź na pas 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 wjazd 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.

NavigationInstruction

Zawiera instrukcje nawigacji dla RouteLegStep.

Pola
maneuver	Maneuver Zawiera instrukcje nawigacyjne dotyczące bieżącego kroku (np. skręć w lewo, wjedź na pas 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 zbiorcze 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 linię łamaną w formacie GeoJSON LineString.

PolylineDetails

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

Pola
tunnel_info[]	TunnelInfo Szczegóły tunelu wzdłuż polilinii. To pole jest wypełniane, jeśli w żądaniu określono modyfikator trasy avoid_tunnels, a wynikowa trasa nie pozwala uniknąć tych elementów LUB jeśli w parametrze extra_computations określono TUNNEL_INFO_ON_POLYLINE, a trasa zawiera tunele.
restriction_info[]	RestrictionInfo Szczegóły ograniczenia wzdłuż linii łamanej. To pole jest wypełniane tylko wtedy, gdy żądanie zawiera modyfikator trasy vehicle_info, a wynikowa trasa zawiera odpowiednie ograniczenie. W przeciwnym razie to pole nie jest używane.
flyover_info[]	FlyoverInfo Szczegóły przelotu wzdłuż linii łamanej.
narrow_road_info[]	NarrowRoadInfo Szczegóły wąskiej drogi wzdłuż linii łamanej.
bridge_info[]	BridgeInfo Szczegóły mostu wzdłuż linii łamanej.
skyway_info[]	SkywayInfo Szczegóły Skyway wzdłuż linii łamanej.

BridgeInfo

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

Pola
bridge_presence	RoadFeatureState Określa, czy na danym odcinku linii łamanej znajduje się most.
polyline_point_index	PolylinePointIndex Lokalizacja informacji o moście 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 polilinii. 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.

RestrictionInfo

Zawiera informacje o różnych ograniczeniach wzdłuż linii łamanej.

Pola
restriction_presence	RoadFeatureState Tylko dane wyjściowe. Określa, czy w danym odcinku polilinii obowiązuje ograniczenie.
polyline_point_index	PolylinePointIndex Lokalizacja informacji związanych z ograniczeniem wzdłuż linii łamanej.
Pole zbiorcze restriction. Zawiera typy ograniczeń, które można zastosować do danego odcinka polilinii. restriction może mieć tylko jedną z tych wartości:
restricted_height_mm	int64 Limit wysokości w milimetrach. To pole jest wypełniane, gdy ograniczona wysokość uniemożliwia przejazd lub powoduje mały prześwit dla określonego pojazdu.
restricted_weight_kg	int64 Limit wagi w kilogramach. To pole jest wypełniane, gdy ograniczenie wagi uniemożliwia przejazd lub jest zbliżone do wagi określonego pojazdu.
hazardous_goods	bool To pole ma wartość „true”, gdy przewóz towarów niebezpiecznych jest ograniczony.
trucks_prohibited	bool To pole ma wartość „true”, gdy ciężarówki są niedozwolone.

RoadFeatureState

Zawiera stany obiektów na drodze 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 na drodze istnieje.
DOES_NOT_EXIST	Obiekt drogowy nie istnieje.

SkywayInfo

Zawiera informacje o drogach nadziemnych wzdłuż linii łamanej.

Pola
skyway_presence	RoadFeatureState Określa, czy na danym odcinku linii łamanej znajduje się kładka.
polyline_point_index	PolylinePointIndex Lokalizacja informacji o drodze powietrznej wzdłuż linii łamanej.

TunnelInfo

Zawiera informacje o tunelach wzdłuż linii.

Pola
tunnel_presence	RoadFeatureState Wskazuje, czy na danym odcinku linii łamanej znajduje się tunel.
polyline_point_index	PolylinePointIndex Lokalizacja informacji związanych z tunelem wzdłuż linii łamanej.

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 linii łamanej. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE	Określa linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
GEO_JSON_LINESTRING	Określa linię łamaną za pomocą formatu 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 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 polilinię podsumowania, która składa się z niewielkiej liczby punktów. Użyj tej wartości, gdy wyświetlasz podsumowanie trasy. Korzystanie z tej opcji wiąże się z mniejszym opóźnieniem żądania niż w przypadku opcji HIGH_QUALITY.

Trasa

Zawiera trasę, która składa się z 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 pomagają identyfikować konkretne właściwości trasy, aby porównać je 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 przejazdowi między 2 miejscami, które nie są via Waypoints. Na przykład trasa bez punktów pośrednich ma tylko 1 odcinek. Trasa, która zawiera 1 punkt pośredni inny niż via, ma 2 odcinki. Trasa, która zawiera 1 punkt pośredni via, ma 1 etap. Kolejność odcinków trasy odpowiada kolejności punktów pośrednich: origin, intermediates, destination.
distance_meters	int32 Długość trasy 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 wartość routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków na drodze.
static_duration	Duration Czas podróży po trasie bez uwzględnienia warunków na drodze.
polyline	Polyline Ogólna linia łamana trasy. Ta linia łamana jest połączeniem wszystkich linii łamanych 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 trasy to Phoenix, Dallas, Bangor, to to pole będzie zawierać wartości [2, 0, 1]. Indeks zaczyna się od 0 dla 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, a w przypadku zmiany trasy uwzględnić pierwotny zamiar, gdy trasa została utworzona. Traktuj ten token jako nieprzezroczystą 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ż linii łamanej.

RouteLocalizedValues

Tekstowe reprezentacje niektórych właściwości.

Pola
distance	LocalizedText Odległość podróży 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ć konkretne właściwości trasy, aby porównać je 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ść podróży na 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 atrybut route_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków na drodze.
static_duration	Duration Czas trwania podróży na danym odcinku, obliczony bez uwzględnienia warunków na drodze.
polyline	Polyline Ogólna linia łamana tego etapu, która zawiera 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 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 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 nawigacji.
travel_advisory	RouteLegTravelAdvisory Zawiera dodatkowe informacje, o których użytkownik powinien być poinformowany, np. o możliwych ograniczeniach w strefie ruchu na danym etapie 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 właściwości.

Pola
distance	LocalizedText Odległość podróży 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 ogólne informacje 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 RouteLeg nie zawiera w krokach ż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 RouteLeg nie zawiera w krokach ż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. Etapy trasy składają się z krokó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 na drodze. W niektórych przypadkach to pole może nie mieć wartości.
polyline	Polyline Linia łamana powiązana z tym krokiem.
start_location	Location Lokalizacja początkowa tego kroku.
end_location	Location Lokalizacja końcowa tego kroku.
navigation_instruction	NavigationInstruction instrukcje nawigacji,
travel_advisory	RouteLegStepTravelAdvisory Zawiera dodatkowe informacje, o których użytkownik powinien być poinformowany na etapie podróży, np. o możliwych ograniczeniach strefy ruchu.
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 właściwości.

Pola
distance	LocalizedText Odległość podróży 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 przypadku danego kroku.
localized_values	TransitDetailsLocalizedValues Tekstowe reprezentacje właściwości RouteLegStepTransitDetails.
headsign	string Określa kierunek, w którym należy się poruszać na tej linii, 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 należy się spodziewać 10-minutowego oczekiwania.
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. Obejmuje to 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, funkcja stop_count zwraca wartość 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 usługi. Na przykład „538” to trip_short_text pociągu Amtrak, który w dni powszednie o 15:10 wyjeżdża z San Jose w Kalifornii i jedzie 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 w przypadku tego kroku.
departure_stop	TransitStop Informacje o przystanku początkowym kroku.
departure_time	Timestamp Szacowany czas wylotu na tym etapie.

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 wybranej 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ę 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, oznacza to, że na drodze RouteLeg nie ma opłat.
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 Wymagane. Docelowy punkt pośredni

RouteMatrixElement

Zawiera informacje o trasie obliczone dla pary punkt początkowy/docelowy w interfejsie ComputeRouteMatrix API. Ten protokół może być przesyłany 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 Długość trasy 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 wartość routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków na drodze.
static_duration	Duration Czas podróży po trasie bez uwzględnienia warunków na drodze.
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 Odległość podróży 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 w żądaniu, 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 jest 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 Wymagane. 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 ta wartość jest ustawiona na „true”, usługa unika dróg płatnych, gdy jest to uzasadnione, i preferuje trasy, które nie zawierają dróg płatnych. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode.
avoid_highways	bool Jeśli ta opcja jest ustawiona na „true”, aplikacja unika autostrad, gdy jest to możliwe, i preferuje trasy, które ich nie zawierają. Dotyczy tylko 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 ich nie obejmują. 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 spró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 DRIVE i TWO_WHEELER RouteTravelMode.
avoid_tunnels	bool Opcjonalnie. Jeśli ta opcja jest ustawiona na „true”, unika tuneli, jeśli to możliwe, i preferuje trasy bez tuneli. Dotyczy tylko DRIVE i TWO_WHEELER RouteTravelMode. Wartość RoutingPreference musi być ustawiona na TRAFFIC_AWARE_OPTIMAL. To pole nie jest obsługiwane w przypadku ComputeRouteMatrix.

RouteTravelAdvisory

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

Pola
toll_info	TollInfo Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie spodziewane są opłaty za przejazd i w żądaniu ComputeRoutesRequest.extra_computations znajduje się parametr 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 parametr toll_info nie jest ustawiony, 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łą linię łamaną 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żący 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 środka transportu, który obejmuje środki transportu napędzane siłą ludzkich mięśni.
TRUCK	ciężarówka, która może podlegać ograniczeniom prawnym lub fizycznym; Musisz wypełnić atrybuty pojazdu w wiadomości VehicleInfo.
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 ruchu. 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 podróży są oparte na sieci dróg i średnich warunkach ruchu niezależnych od czasu, a nie na aktualnych 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 na drodze i rozproszony charakter usługi. Wyniki mogą się też różnić w przypadku niemal identycznych tras w dowolnym czasie lub z dowolną częstotliwością.
TRAFFIC_AWARE	wyznacza 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 natężenia 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) SpeedReadingInterval określa przedział i opisuje ruch w nim za pomocą tych kategorii:

Pola
start_polyline_point_index	int32 Indeks początkowy tego przedziału w linii łamanej.
end_polyline_point_index	int32 Indeks końcowy tego przedziału na polilinii.
Pole zbiorcze 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 Kwota 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 obsługiwanych przez nas winiet z całego świata.

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 stronie https://www.myetoll.com.au.
AU_EWAY_TAG	winieta w Sydney, Więcej informacji znajdziesz na https://www.tollpay.com.au.
AU_LINKT	Winieta obowiązująca w całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE	winieta w Argentynie, Więcej informacji znajdziesz na stronie https://telepase.com.ar
BR_AUTO_EXPRESO	winieta w Brazylii; Dodatkowe informacje znajdziesz na stronie 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 stronie 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 wydawana przez wiele banków, która służy 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	Meksykańska firma zajmująca się winietami. Jedna z wielu działających w Meksyku. Więcej informacji znajdziesz na stronie https://www.televia.com.mx.
MX_TELEVIA	Meksykańska firma zajmująca się winietami. Jedna z wielu firm 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_KY_RIVERLINK	KY, 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_BREAKAWAY	MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	MI, USA.
US_MI_IQ_PROX_CARD	MI, USA. Wycofano, ponieważ ten typ karty już nie istnieje. Ten element został wycofany.
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, Stany Zjednoczone.
US_WV_MEMORIAL_BRIDGE_TICKETS	WV, Stany Zjednoczone.
US_WV_MOV_PASS	WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET	WV, Stany Zjednoczone.

TrafficModel

To pole określa jedno z tych założeń, które należy zastosować podczas obliczania czasu podróży w warunkach na drodze. Są one podane w wyliczeniach poniżej. 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ść, zostanie użyta wartość domyślna BEST_GUESS.
BEST_GUESS	Wskazuje, że zwrócona wartość duration powinna być najlepszym oszacowaniem czasu podróży na podstawie historycznych warunków na drodze i aktualnego natężenia ruchu. Im bliżej teraźniejszości jest departure_time, tym większe znaczenie ma aktualne natężenie ruchu.
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 na drodze 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 na drodze 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. Wartość szesnastkowa.
icon_uri	string Identyfikator URI ikony powiązanej z tym wierszem.
name_short	string Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer 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 obsługuje tę linię transportu publicznego.

TransitPreferences

Ustawienia 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 trybu 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 transportu publicznego.

TransitVehicleType

Rodzaj pojazdów na trasach transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED	Nieużywane.
BUS	magistrala.
CABLE_CAR	Pojazd poruszający się po kablu, zwykle po ziemi. Koleje linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN	kolej podmiejska,
FERRY	Prom.
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 naziemna.
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 zbiorowa 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	Jednostki miary nie są określone. Domyślnie jest to jednostka miary wywnioskowana z żądania.
METRIC	Jednostki miary w systemie metrycznym.
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 określono typu emisji. Domyślna wartość to GASOLINE.
GASOLINE	Pojazd zasilany benzyną.
ELECTRIC	Pojazd zasilany energią elektryczną.
HYBRID	pojazd hybrydowy (np. benzynowy + 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.
total_height_mm	int64 Wysokość pojazdu, w tym wysokość przyczep. Aby aktywować tę funkcję, musisz ustawić ją na transport ciężarowy lub holowanie. To pole nie jest obsługiwane w przypadku funkcji ComputeRouteMatrix, gdy wartość parametru RouteTravelMode to DRIVE.
total_length_mm	int64 długość pojazdu, w tym długość przyczep; Aby aktywować tę funkcję, musisz ustawić ją na transport ciężarowy lub holowanie. To pole nie jest obsługiwane w przypadku funkcji ComputeRouteMatrix, gdy wartość parametru RouteTravelMode to DRIVE.
total_width_mm	int64 Szerokość pojazdu, w tym szerokość przyczep. Aby aktywować tę funkcję, musisz ustawić ją na transport ciężarowy lub holowanie. To pole nie jest obsługiwane w przypadku funkcji ComputeRouteMatrix, gdy wartość parametru RouteTravelMode to DRIVE.
total_weight_kg	int64 Waga pojazdu, w tym waga przyczep. Waga w tym kontekście odnosi się do rzeczywistej wagi, a nie do wartości znamionowej. Aby aktywować tę funkcję, musisz ustawić ją na transport ciężarowy lub holowanie. To pole nie jest obsługiwane w przypadku funkcji ComputeRouteMatrix, gdy wartość parametru RouteTravelMode to DRIVE.
trailer_info[]	TrailerInfo Zawiera po jednej pozycji na każdy zwiastun. Jeśli podano informacje o zwiastunie, parametr RoutingPreference musi mieć wartość TRAFFIC_AWARE_OPTIMAL. To pole nie jest obsługiwane w przypadku funkcji ComputeRouteMatrix, gdy wartość parametru RouteTravelMode to DRIVE.
hazardous_goods_types[]	HazardousGoodsType Lista materiałów niebezpiecznych przewożonych w pojeździe (jeśli takie są).

HazardousGoodsType

Rodzaje różnych materiałów niebezpiecznych.

Wartości w polu enum
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	Nie określono typu towarów niebezpiecznych.
EXPLOSIVES	materiały wybuchowe,
GASES	gazy,
FLAMMABLE	materiały łatwopalne,
COMBUSTIBLE	materiały łatwopalne,
ORGANIC	produkty ekologiczne,
POISON	Produkty trujące.
RADIOACTIVE	towary radioaktywne;
CORROSIVE	Towary żrące.
ASPIRATION_HAZARD	Towary niebezpieczne, które mogą być szkodliwe w przypadku połknięcia i dostania się do dróg oddechowych.
ENVIRONMENTAL_HAZARD	towary niebezpieczne dla środowiska;
OTHER	inne rodzaje towarów.

TrailerInfo

Informacje o poszczególnych przyczepach podłączonych do pojazdu. W przypadku transportu ciężarowego należy podać długość wszystkich przyczep. Pozostałe atrybuty są opcjonalne. Atrybuty łączne muszą obejmować atrybuty wszystkich przyczep. Na przykład total_height_mm musi być zawsze większa lub równa trailer_info.height_mm.

Pola
height_mm	int64 Wysokość zwiastuna.
length_mm	int64 Długość zwiastuna.
width_mm	int64 Szerokość przyczepy.
weight_kg	int64 Waga przyczepy. Waga w tym kontekście odnosi się do rzeczywistej wagi, a nie do oceny wagi.

Punkt pośredni

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

Pola
via	bool Oznacza ten punkt jako kamień milowy, a nie punkt zatrzymania. W przypadku każdego punktu pośredniego w żądaniu, który nie jest punktem przesiadkowym, odpowiedź dodaje wpis do tablicy legs, aby podać szczegóły postojów na danym 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 kierują podróż 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 nie powiedzie się. 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. Gdy ustawisz tę wartość, obliczona trasa nie będzie obejmować punktów pośrednich innych niż via na drogach, które nie nadają się do odbioru i 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 lokalizację, aby pojazd mógł zatrzymać się po stronie drogi, w kierunku której jest przesunięta lokalizacja względem środka drogi. Ta opcja działa tylko w przypadku DRIVE i TWO_WHEELER RouteTravelMode.
Pole zbiorcze location_type. Różne sposoby przedstawiania lokalizacji. location_type może mieć tylko jedną z tych wartości:
location	Location Punkt określony za pomocą współrzędnych geograficznych, w tym opcjonalnego kierunku.
place_id	string Identyfikator miejsca POI powiązany z punktem pośrednim.
address	string Zrozumiały dla człowieka adres lub kod Plus Code. Więcej informacji znajdziesz na stronie https://plus.codes.
navigation_point_token	string Token identyfikujący NavigationPoint uzyskany z metody SearchDestinations interfejsu Geocoding API.