Package google.maps.routes.v1

Indeks

RoutesPreferred

Preferowany interfejs API tras.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Na podstawie zestawu punktów końcowych i pośrednich oraz celu trasy oblicza najlepszą trasę dla jej celu. Zwraca również najszybszą i najkrótszą trasę jako trasy referencyjne.

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

Na przykład w tej metodzie:

  • Maska pola wszystkich dostępnych pól (do sprawdzenia ręcznego): X-Goog-FieldMask: *
  • Maska pola z odległościami i czasem trwania trasy oraz informacjami o tokenach i opłatach: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Odradzamy stosowanie maski pola odpowiedzi z symbolem wieloznacznym (*) oraz określanie maski pola na najwyższym poziomie (routes), ponieważ:

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

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Na przykład w tej metodzie:

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

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

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

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Na przykład w tej metodzie:

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

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

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

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ComputeCustomRoutesRequest

Komunikat żądania ComputeCustomRoutes.

Pola
origin

Waypoint

Wymagane. Punkt pośredni na trasie.
destination

Waypoint

Wymagane. Docelowy punkt na trasie.
intermediates[]

Waypoint

Opcjonalnie: Zestaw punktów na trasie (z wyłączeniem punktów końcowych) do zatrzymania się na lub przejechania. Obsługiwane jest maksymalnie 25 pośrednich punktów pośrednich.
travel_mode

RouteTravelMode

Opcjonalnie: Określa środek transportu. Obecnie obsługiwany jest tylko folder DYSK.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczy, aby używać innej opcji, gdy preferowana opcja nie zapewnia prawidłowego wyniku. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferencję dotyczącą jakości linii łamanej.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie linii łamanej.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie przyjęta data przesłania żądania. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.
route_modifiers

RouteModifiers

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

RouteObjective

Wymagane. Trasa, pod kątem której chcesz prowadzić optymalizację.
language_code

string

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

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole instruction w elemencie NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary stosowane dla trasy, odcinka, dystansu ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki są ustalane na podstawie lokalizacji żądania.

ComputeCustomRoutesResponse

Komunikat odpowiedzi ComputeCustomRoutes.

Pola
routes[]

CustomRoute

„najlepsze” trasy dla celu wejściowego.
fastest_route

CustomRoute

Najszybsza trasa referencyjna.
shortest_route

CustomRoute

Najkrótsza trasa referencyjna.
fallback_info

FallbackInfo

Informacje zastępcze o trasach niestandardowych.

FallbackInfo

Obejmuje informacje o wartościach zastępczych dla ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 typy kreacji zastępczych:

  1. Jeśli nie będzie w stanie obliczyć trasy z użyciem parametru routingu_preference wymaganego przez klienta, system przełączy się na inny tryb routingu. W takim przypadku do przekazywania informacji o użytym trybie routingu awaryjnego oraz informacji o przyczynie działania kreacji zastępczej używane są parametry Fallback_routing_mode i route_mode_fallback_reason.

  2. Jeśli nie może obliczyć „najlepszego”, na cel trasy określony przez klienta, może skorzystać z innego celu. Fallback_route_objective jest używany do przekazywania celu trasy zastępczej.

Pola
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackRouteObjective

Cel trasy używany w odpowiedzi. Jeśli aktywowano reklamę zastępczą, cel może się różnić od celu trasy podanego w pierwotnym żądaniu klienta.

FallbackRouteObjective

Cel trasy używany w odpowiedzi.

Wartości w polu enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Cel trasy zastępczej nieokreślony.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Jeśli klient poprosi o kartę RateCard i ustawi parametr include_tolls na wartość true, a Google nie ma danych o cenie opłat za przejazd na trasie, interfejs API wraca do interfejsu RateCard bez uwzględnienia wysokości opłaty drogowej.

ComputeRouteMatrixRequest

Komunikat żądania ComputeRouteMatrix

Pola
origins[]

RouteMatrixOrigin

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

  • Liczba elementów (źródła × miejsca docelowe) w żadnym przypadku nie może być większa niż 625.
  • Liczba elementów (origins × miejsca docelowe) nie może być większa niż 100, jeśli parametr routing_preference ma wartość TRAFFIC_AWARE_OPTIMAL.
  • Liczba punktów pośrednich (źródła i miejsca docelowe) podana jako place_id nie może być większa niż 50.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

Opcjonalnie: Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczy, aby używać innej opcji, gdy preferowana opcja nie zapewnia prawidłowego wyniku. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie przyjęta zostanie godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.

ComputeRoutesRequest

Komunikat żądania ComputeRoutes.

Pola
origin

Waypoint

Wymagane. Punkt pośredni na trasie.
destination

Waypoint

Wymagane. Docelowy punkt na trasie.
intermediates[]

Waypoint

Opcjonalnie: Zestaw punktów na trasie (z wyłączeniem punktów końcowych) do zatrzymania się na lub przejechania. Obsługiwane jest maksymalnie 25 pośrednich punktów pośrednich.
travel_mode

RouteTravelMode

Opcjonalnie: Określa środek transportu.
routing_preference

RoutingPreference

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje użyć wybranego ustawienia routingu do obliczenia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczy, aby używać innej opcji, gdy preferowana opcja nie zapewnia prawidłowego wyniku. Tę opcję możesz określić tylko wtedy, gdy travel_mode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie nie zostanie zrealizowane.
polyline_quality

PolylineQuality

Opcjonalnie: Określa preferencję dotyczącą jakości linii łamanej.
polyline_encoding

PolylineEncoding

Opcjonalnie: Określa preferowane kodowanie linii łamanej.
departure_time

Timestamp

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie przyjęta data przesłania żądania. Jeśli ustawisz tę wartość na czas, który już minął, żądanie zakończy się niepowodzeniem.
compute_alternative_routes

bool

Określa, czy oprócz trasy obliczać trasy alternatywne.
route_modifiers

RouteModifiers

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

string

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

Units

Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole instruction w elemencie NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary stosowane dla trasy, odcinka, dystansu ani czasu trwania. Jeśli nie podasz tej wartości, wyświetlane jednostki są ustalane na podstawie lokalizacji żądania.
optimize_waypoint_order

bool

Jeśli parametr OptimizeWaypointOrder ma wartość true (prawda), podejmuje się próbę zmiany kolejności określonych pośrednich punktów pośrednich w celu zminimalizowania całkowitego kosztu trasy. Jeśli dowolny z pośrednich punktów pośrednich jest punkt pośredni, żądanie nie powiedzie się. Użyj ComputeRoutesResponse.Routes.Optimized_average_waypoint_index, aby znaleźć nowe sortowanie. Jeśli w nagłówku X-Goog-FieldMask nie jest wysyłane żądanie addresses.Optimized_average_waypoint_index, żądanie zakończy się niepowodzeniem. Jeśli parametr OptimizeWaypointOrder ma wartość false (fałsz), parametr ComputeRoutesResponse.Optimized_average_waypoint_index jest pusty.

ComputeRoutesResponse

ComputeRoute zarządza komunikatem z odpowiedzią.

Pola
routes[]

Route

Zawiera tablicę obliczonych tras (maksymalnie 3), jeśli określono atrybut compute_alternatives_routes, i zawiera tylko jedną trasę, jeśli nie jest podana. Jeśli ta tablica zawiera wiele wpisów, pierwsza z nich jest najbardziej zalecaną trasą. Jeśli tablica jest pusta, oznacza to, że nie udało się znaleźć trasy.
fallback_info

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć wyników trasy przy wszystkich podanych preferencjach wejściowych, może użyć innego sposobu obliczeń. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.

CustomRoute

Obejmuje niestandardową trasę obliczoną na podstawie celu trasy określonego przez klienta. Trasa niestandardowa zawiera trasę i token trasy, które można przekazać do pakietu NavSDK w celu zrekonstruowania trasy niestandardowej na potrzeby nawigacji zakręt po zakręcie.

Pola
route

Route

Droga uznana za „najlepszą” dla docelowej trasy wejściowej.
token

string

Zakodowany w internecie token trasy zakodowany w base64, który można przekazać do NavSDK. Umożliwia on zrekonstruowanie trasy podczas nawigacji, a w przypadku zmiany trasy uwzględnia pierwotną intencję, gdy wywoływane jest RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob.

FallbackInfo

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

Pola
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

Powody używania odpowiedzi zastępczej.

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

FallbackRoutingMode

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

Wartości w polu enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Nieużywane.
FALLBACK_TRAFFIC_UNAWARE Wskazuje parametr „TRAFFIC_UNAWARE” do obliczenia odpowiedzi użyto trybu routingu.
FALLBACK_TRAFFIC_AWARE Wskazuje parametr „TRAFFIC_AWARE” do obliczenia odpowiedzi użyto trybu routingu.

Lokalizacja

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

Pola
lat_lng

LatLng

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

Int32Value

Nagłówek kompasu powiązany z kierunkiem ruchu. Ta wartość służy do określania strony drogi na potrzeby odbioru i dostawy. Wartości nagłówka mogą należeć do zakresu od 0 do 360, gdzie 0 oznacza kierunek północny, 90 oznacza kierunek drogi wschodniej itd. Tego pola możesz używać tylko w przypadku trybów podróży DRIVE i TWO_WHEELER.

Skręt

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

Wartości w polu enum
MANEUVER_UNSPECIFIED Nieużywane.
TURN_SLIGHT_LEFT Obróć się lekko w lewo.
TURN_SHARP_LEFT Skręć ostro w lewo.
UTURN_LEFT Zawróć w lewo.
TURN_LEFT Skręć w lewo.
TURN_SLIGHT_RIGHT Obróć się lekko w prawo.
TURN_SHARP_RIGHT Skręć ostro w prawo.
UTURN_RIGHT Zawróć w prawo.
TURN_RIGHT Skręć w prawo.
STRAIGHT Idź prosto.
RAMP_LEFT Skręć w lewą rampę.
RAMP_RIGHT Skręć w w prawo.
MERGE Scalanie w ruch.
FORK_LEFT Skręć w lewy rozwidlenie.
FORK_RIGHT Skręć w prawy widelec.
FERRY Przeprawa promowa.
FERRY_TRAIN Wsiądź do pociągu kursującego na prom.
ROUNDABOUT_LEFT Skręć w lewo na rondzie.
ROUNDABOUT_RIGHT Skręć w prawo na rondzie.
Pola
maneuver

Maneuver

Obejmuje instrukcje nawigacji dotyczące bieżącego kroku (np. skręć w lewo, scal, prosto itp.). To pole określa, która ikona ma być wyświetlana.
instructions

string

Instrukcje dotyczące poruszania się po tym kroku.

Linia łamana

Oznacza zakodowaną linię łamaną.

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

string

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

Struct

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

PolylineEncoding

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

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

PolylineQuality

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

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

Trasa

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

Pola
legs[]

RouteLeg

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

int32

Odległość przebyta trasa w metrach.
duration

Duration

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

Duration

Długość trasy bez uwzględnienia warunków drogowych.
polyline

Polyline

Linia łamana całej trasy. Ta linia łamana będzie połączona linią łamaną ze wszystkich elementów typu legs.
description

string

Opis trasy.
warnings[]

string

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

Viewport

Ramka ograniczająca widoczny obszar linii łamanej.
travel_advisory

RouteTravelAdvisory

Dodatkowe informacje o trasie.
optimized_intermediate_waypoint_index[]

int32

Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość true (prawda), to pole zawiera zoptymalizowaną kolejność pośrednich punktów pośrednich. W przeciwnym razie pole jest puste. Załóżmy na przykład, że dane wejściowe to Origin: LA; Dla średnio zaawansowanych: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork; a zoptymalizowana kolejność pośrednich punktów pośrednich to: Phoenix, Dallas, Bangor. To pole zawiera wartości [2, 0, 1]. Indeks rozpoczyna się od 0 dla pierwszego pośredniego punktu pośredniego.

RouteLeg

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

Pola
distance_meters

int32

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

Duration

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

Duration

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

Polyline

Ogólna linia łamana dla tej nogi. Obejmuje to również linię łamaną każdej step.
start_location

Location

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

Location

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

RouteLegStep

Tablica kroków oznaczająca segmenty w tym etapie. Każdy krok odpowiada jednej instrukcji nawigacji.
travel_advisory

RouteLegTravelAdvisory

Obejmuje dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak ewentualne ograniczenia dotyczące strefy ruchu itp. na danym etapie trasy.

RouteLegStep

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

Pola
distance_meters

int32

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

Duration

Długość tej drogi bez uwzględnienia warunków drogowych. W niektórych przypadkach to pole może nie mieć wartości.
polyline

Polyline

Linia łamana powiązana z tym krokiem.
start_location

Location

Lokalizacja początkowa tego kroku.
end_location

Location

Lokalizacja końcowa tego kroku.
navigation_instruction

NavigationInstruction

Instrukcje nawigacji.
travel_advisory

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak możliwe ograniczenie strefy ruchu na etapie etapu.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak możliwe ograniczenie strefy ruchu na etapie etapu.

Pola
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

RouteLegTravelAdvisory

Obejmuje dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak ewentualne ograniczenia dotyczące strefy ruchu itp. na danym etapie trasy.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach na konkretnej trasie RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd na RouteLeg. Jeśli to pole jest skonfigurowane, ale pole podrzędne suggested_price nie jest wypełnione, można oczekiwać, że na drodze są opłaty, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, opłata nie jest pobierana na RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

RouteMatrixDestination

Jedno miejsce docelowe dla ComputeRouteMatrixRequest

Pola
waypoint

Waypoint

Wymagane. Docelowy punkt na trasie

RouteMatrixElement

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

Pola
origin_index

int32

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

int32

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

Status

Kod stanu błędu tego elementu.
condition

RouteMatrixElementCondition

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

int32

Odległość przebyta trasa w metrach.
duration

Duration

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

Duration

Długość trasy bez uwzględnienia warunków drogowych.
travel_advisory

RouteTravelAdvisory

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

FallbackInfo

W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy przy określonych preferencjach dla danej pary punktu początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane.

RouteMatrixElementCondition

Stan zwracanej trasy.

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

RouteMatrixOrigin

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

Pola
waypoint

Waypoint

Wymagane. Punkt początkowy
route_modifiers

RouteModifiers

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

RouteModifiers

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

Pola
avoid_tolls

bool

Określa, czy w uzasadnionych przypadkach unikać dróg płatnych. Preferowane będą trasy, które nie zawierają dróg płatnych. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_highways

bool

Określa, czy w uzasadnionych przypadkach unikać autostrad. Priorytet będą miały trasy niezawierające autostrad. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_ferries

bool

Określa, czy w uzasadnionych sytuacjach unikać przepraw promowych. Pierwszeństwo będą miały trasy, które nie będą obejmować podróży promami. Dotyczy tylko środków transportu DRIVE i TWO_WHEELER.
avoid_indoor

bool

Określa, czy w uzasadnionych przypadkach unikać przechodzenia do wnętrz. Preferowane będą trasy niezawierające nawigacji wewnątrz budynków. Dotyczy tylko środka transportu WALK.
vehicle_info

VehicleInfo

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

TollPass

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

RouteObjective

Obejmuje cel optymalizacji przez ComputeCustomRoutes.

Pola
rate_card

RateCard

Cel arkusza stawek.

RateCard

Obejmuje cel trasy RateCard.

Pola
cost_per_minute

MonetaryCost

Opcjonalnie: Koszt za minutę.
cost_per_km

MonetaryCost

Opcjonalnie: Koszt za kilometr.
include_tolls

bool

Opcjonalnie: Określa, czy w całkowitym koszcie uwzględnić koszt opłat drogowych.

MonetaryCost

Zawiera koszt użyty w arkuszu stawek.

Pola
value

double

Wymagane. Wartość kosztu w walucie lokalnej określona na podstawie żądania.

RouteTravelAdvisory

Obejmuje dodatkowe informacje, o których należy poinformować użytkownika, takie jak możliwe ograniczenia w strefie ruchu itp.

Pola
toll_info

TollInfo

Zawiera informacje o opłatach za przejazd na trasie. To pole jest wypełnione tylko wtedy, gdy przewidujemy, że na trasie będą naliczane opłaty. Jeśli to pole jest skonfigurowane, ale pole podrzędne suggested_price nie jest wypełnione, można oczekiwać, że na drodze są opłaty, ale nie znamy szacunkowej ceny. Jeśli to pole nie jest skonfigurowane, oznacza to, że trasa nie będzie płatna.
speed_reading_intervals[]

SpeedReadingInterval

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

Przykład:

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

RouteTravelMode

Zbiór wartości używanych do określenia środka transportu.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie określono środka transportu. Domyślna wartość to DRIVE.
DRIVE Podróż samochodem osobowym.
BICYCLE Podróż rowerem.
WALK Podróżuj pieszo.
TWO_WHEELER Dwukołowy pojazd silnikowy. Na przykład motocykl. Pamiętaj, że różni się to od środka transportu BICYCLE, który obejmuje tryb zasilany przez człowieka.
TAXI

Podróżuj licencjonowaną taksówką, która na niektórych obszarach może pozwolić pojazdom poruszać się wyznaczonymi pasami dla taksówek.

Tryb TAXI to funkcja eksperymentalna. Jeśli klient poprosi o trasę taksówką w mieście, w którym nie ma informacji o pasach dla taksówek, zostanie zwrócona trasa STORAGE.

RoutingPreference

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

Wartości w polu enum
ROUTING_PREFERENCE_UNSPECIFIED Nie określono preferencji routingu. Domyślna wartość to TRAFFIC_AWARE.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania warunków na drodze. Przydatny, gdy natężenie ruchu nie ma znaczenia. Użycie tej wartości pozwala zminimalizować opóźnienie.
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem warunków na drodze. W przeciwieństwie do zasady TRAFFIC_AWARE_OPTIMAL stosowane są niektóre optymalizacje w celu znacznego skrócenia czasu oczekiwania.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy, biorąc pod uwagę warunki na drodze, bez stosowania większości optymalizacji wydajności. Użycie tej wartości powoduje największe opóźnienie.

SpeedReadingInterval

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

Pola
start_polyline_point_index

int32

Indeks początkowy tego przedziału w linii łamanej. Jeśli indeks w pliku JSON wynosi 0, pole wydaje się być puste.
end_polyline_point_index

int32

Indeks końcowy tego przedziału na linii łamanej. Jeśli indeks w pliku JSON wynosi 0, pole wydaje się być puste.
speed

Speed

Prędkość ruchu w tym przedziale czasu.

Szybkość

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

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

TollInfo

Obejmuje informacje o opłatach z Route lub RouteLeg.

Pola
estimated_price[]

Money

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

TollPass

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

Wartości w polu enum
TOLL_PASS_UNSPECIFIED Nieużywane. Jeśli zostanie użyta ta wartość, żądanie zakończy się niepowodzeniem.
AU_ETOLL_TAG Jeden z wielu dostawców wpłat za przejazd w Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Jeden z wielu dostawców wpłat za przejazd w Sydney. https://www.tollpay.com.au/
AU_LINKT Winieta w całej Australii. Więcej informacji znajdziesz na stronie https://www.linkt.com.au/.
AR_TELEPASE Winieta w Argentynie. Więcej informacji znajdziesz na stronie https://telepase.com.ar.
BR_AUTO_EXPRESO winieta w Brazylii. Więcej informacji znajdziesz na https://www.autoexpreso.com.
BR_CONECTCAR winieta w Brazylii. Więcej informacji znajdziesz na https://conectcar.com.
BR_MOVE_MAIS winieta w Brazylii. Więcej informacji znajdziesz na https://movemais.com.
BR_PASSA_RAPIDO winieta w Brazylii. Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/.
BR_SEM_PARAR winieta w Brazylii. Więcej informacji znajdziesz na https://www.semparar.com.br.
BR_TAGGY winieta w Brazylii. Więcej informacji znajdziesz na https://taggy.com.br.
BR_VELOE winieta w Brazylii. Więcej informacji znajdziesz na https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
CA_US_BLUE_WATER_EDGE_PASS Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_CONNEXION Przejście graniczne z Ontario, z Kanady do Michigan, w Stanach Zjednoczonych.
CA_US_NEXUS_CARD Kanady do przejścia granicznego ze Stanami Zjednoczonymi.
ID_E_TOLL Indonezja. Karta elektroniczna wydawana przez wiele banków używanych do płacenia opłat. Wszystkie karty elektroniczne w bankach są rozliczane w taki sam sposób, więc potrzebna jest tylko jedna wartość wyliczeniowa. Na przykład: Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indie.
IN_LOCAL_HP_PLATE_EXEMPT Indie, zwolnienie z numeru rejestracyjnego HP.
MX_TAG_IAVE Winieta w Meksyku.
MX_TAG_TELEVIA Meksykański wystawca winiet. Jedna z wielu placówek działających w mieście Meksyk. Więcej informacji znajdziesz na https://www.televia.com.mx.
MX_VIAPASS Winieta w Meksyku. Więcej informacji znajdziesz na https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Wskazuje, że oprócz naklejki na pojazd czysty przez DMV (DMV) posiada też dowolny dokument FasTrak. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floryda, Stany Zjednoczone.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floryda, Stany Zjednoczone.
US_FL_EPASS Floryda, Stany Zjednoczone.
US_FL_GIBA_TOLL_PASS Floryda, Stany Zjednoczone.
US_FL_LEEWAY Floryda, Stany Zjednoczone.
US_FL_SUNPASS Floryda, Stany Zjednoczone.
US_FL_SUNPASS_PRO Floryda, Stany Zjednoczone.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN Indie, Stany Zjednoczone.
US_KS_BESTPASS_HORIZON Kansas, Stany Zjednoczone.
US_KS_KTAG Kansas, Stany Zjednoczone.
US_KS_NATIONALPASS Kansas, Stany Zjednoczone.
US_KS_PREPASS_ELITEPASS Kansas, Stany Zjednoczone.
US_LA_GEAUXPASS Los Angeles, Stany Zjednoczone.
US_LA_TOLL_TAG Los Angeles, Stany Zjednoczone.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, Stany Zjednoczone.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, Stany Zjednoczone.
US_NC_EZPASSNC Karolina Północna, USA.
US_NC_PEACH_PASS Karolina Północna, USA.
US_NC_QUICK_PASS Karolina Północna, USA.
US_NH_EZPASSNH NH, Stany Zjednoczone.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stany Zjednoczone.
US_NJ_EZPASSNJ NJ, Stany Zjednoczone.
US_NY_EXPRESSPASS Nowy Jork, Stany Zjednoczone.
US_NY_EZPASSNY Nowy Jork, Stany Zjednoczone.
US_OH_EZPASSOH Ohio, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_BANCPASS Teksas, USA.
US_TX_DEL_RIO_PASS Teksas, USA.
US_TX_EFAST_PASS Teksas, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD Teksas, USA.
US_TX_EPTOLL Teksas, USA.
US_TX_EZ_CROSS Teksas, USA.
US_TX_EZTAG Teksas, USA.
US_TX_LAREDO_TRADE_TAG Teksas, USA.
US_TX_PLUSPASS Teksas, USA.
US_TX_TOLLTAG Teksas, USA.
US_TX_TXTAG Teksas, USA.
US_TX_XPRESS_CARD Teksas, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Utah, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

Jednostki

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

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

VehicleEmissionType

Zbiór wartości opisujących typ emisji spalin pojazdu. Dotyczy tylko środka transportu Dyski twarde.

Wartości w polu enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nie określono typu emisji. Domyślnie GASOLINE.
GASOLINE Pojazd benzynowy lub benzynowy.
ELECTRIC Pojazd napędzany prądem.
HYBRID Pojazd na paliwo hybrydowe (np. benzynowy i elektryczny).

VehicleInfo

Obejmuje informacje o pojeździe, na przykład ostatni znak tablicy rejestracyjnej.

Pola
emission_type

VehicleEmissionType

Opisuje typ emisji dwutlenku węgla w pojeździe. Dotyczy tylko środka transportu Dyski twarde.

Punkt pośredni

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

Pola
via

bool

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

bool

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

bool

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

Location

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

string

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