Indeks
RoutesPreferred
(interfejs)ComputeCustomRoutesRequest
(komunikat)ComputeCustomRoutesResponse
(komunikat)ComputeCustomRoutesResponse.FallbackInfo
(komunikat)ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective
(wyliczenie)ComputeRouteMatrixRequest
(komunikat)ComputeRoutesRequest
(komunikat)ComputeRoutesResponse
(komunikat)CustomRoute
(komunikat)FallbackInfo
(komunikat)FallbackReason
(wyliczenie)FallbackRoutingMode
(wyliczenie)Location
(komunikat)Maneuver
(wyliczenie)NavigationInstruction
(komunikat)Polyline
(komunikat)PolylineEncoding
(wyliczenie)PolylineQuality
(wyliczenie)Route
(komunikat)RouteLeg
(komunikat)RouteLegStep
(komunikat)RouteLegStepTravelAdvisory
(komunikat)RouteLegTravelAdvisory
(komunikat)RouteMatrixDestination
(komunikat)RouteMatrixElement
(komunikat)RouteMatrixElementCondition
(wyliczenie)RouteMatrixOrigin
(komunikat)RouteModifiers
(komunikat)RouteObjective
(komunikat)RouteObjective.RateCard
(komunikat)RouteObjective.RateCard.MonetaryCost
(komunikat)RouteTravelAdvisory
(komunikat)RouteTravelMode
(wyliczenie)RoutingPreference
(wyliczenie)SpeedReadingInterval
(komunikat)SpeedReadingInterval.Speed
(wyliczenie)TollInfo
(komunikat)TollPass
(wyliczenie)Units
(wyliczenie)VehicleEmissionType
(wyliczenie)VehicleInfo
(komunikat)Waypoint
(komunikat)
RoutesPreferred
Preferowany interfejs API tras.
ComputeCustomRoutes |
---|
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 Na przykład w tej metodzie:
Odradzamy stosowanie maski pola odpowiedzi z symbolem wieloznacznym (
|
ComputeRouteMatrix |
---|
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 Na przykład w tej metodzie:
Bardzo ważne jest, aby do maski pola dodać atrybut
|
ComputeRoutes |
---|
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 Na przykład w tej metodzie:
Google odradza korzystanie z maski pola odpowiedzi z symbolem wieloznacznym (
|
ComputeCustomRoutesRequest
Komunikat żądania ComputeCustomRoutes.
Pola | |
---|---|
origin |
Wymagane. Punkt pośredni na trasie. |
destination |
Wymagane. Docelowy punkt na trasie. |
intermediates[] |
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 |
Opcjonalnie: Określa środek transportu. Obecnie obsługiwany jest tylko folder DYSK. |
routing_preference |
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 |
polyline_quality |
Opcjonalnie: Określa preferencję dotyczącą jakości linii łamanej. |
polyline_encoding |
Opcjonalnie: Określa preferowane kodowanie linii łamanej. |
departure_time |
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 |
Opcjonalnie: Zestaw warunków, które wpływają na sposób obliczania tras. |
route_objective |
Wymagane. Trasa, pod kątem której chcesz prowadzić optymalizację. |
language_code |
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 |
Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole |
ComputeCustomRoutesResponse
Komunikat odpowiedzi ComputeCustomRoutes.
Pola | |
---|---|
routes[] |
„najlepsze” trasy dla celu wejściowego. |
fastest_route |
Najszybsza trasa referencyjna. |
shortest_route |
Najkrótsza trasa referencyjna. |
fallback_info |
Informacje zastępcze o trasach niestandardowych. |
FallbackInfo
Obejmuje informacje o wartościach zastępczych dla ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 typy kreacji zastępczych:
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.
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 |
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 |
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 |
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[] |
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:
|
destinations[] |
Wymagane. Tablica miejsc docelowych, która określa kolumny macierzy odpowiedzi. |
travel_mode |
Opcjonalnie: Określa środek transportu. |
routing_preference |
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 |
departure_time |
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 |
Wymagane. Punkt pośredni na trasie. |
destination |
Wymagane. Docelowy punkt na trasie. |
intermediates[] |
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 |
Opcjonalnie: Określa środek transportu. |
routing_preference |
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 |
polyline_quality |
Opcjonalnie: Określa preferencję dotyczącą jakości linii łamanej. |
polyline_encoding |
Opcjonalnie: Określa preferowane kodowanie linii łamanej. |
departure_time |
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 |
Określa, czy oprócz trasy obliczać trasy alternatywne. |
route_modifiers |
Opcjonalnie: Zestaw warunków, które wpływają na sposób obliczania tras. |
language_code |
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 |
Opcjonalnie: Określa jednostki miary dla pól wyświetlanych. Obejmuje to pole |
optimize_waypoint_order |
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 |
ComputeRoutesResponse
ComputeRoute zarządza komunikatem z odpowiedzią.
Pola | |
---|---|
routes[] |
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 |
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 |
Droga uznana za „najlepszą” dla docelowej trasy wejściowej. |
token |
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 |
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 |
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 |
Współrzędne geograficzne punktu pośredniego. |
heading |
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 |
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. |
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 |
Kodowanie ciągu znaków w linii łamanej za pomocą algorytmu kodowania linii łamanej |
geo_json_linestring |
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[] |
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 |
distance_meters |
Odległość przebyta trasa w metrach. |
duration |
Czas potrzebny na nawigowanie po trasie. Jeśli ustawisz |
static_duration |
Długość trasy bez uwzględnienia warunków drogowych. |
polyline |
Linia łamana całej trasy. Ta linia łamana będzie połączona linią łamaną ze wszystkich elementów typu |
description |
Opis trasy. |
warnings[] |
Tablica ostrzeżeń wyświetlanych przy wyświetlaniu trasy. |
viewport |
Ramka ograniczająca widoczny obszar linii łamanej. |
travel_advisory |
Dodatkowe informacje o trasie. |
optimized_intermediate_waypoint_index[] |
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 |
Odległość pokonanego odcinka trasy w metrach. |
duration |
Czas potrzebny na poruszanie się po nodze. Jeśli |
static_duration |
Długość danego odcinka obliczona bez uwzględniania warunków na drodze. |
polyline |
Ogólna linia łamana dla tej nogi. Obejmuje to również linię łamaną każdej |
start_location |
Lokalizacja początkowa tego odcinka. Może się on różnić od podanego |
end_location |
Lokalizacja końcowa tego odcinka. Może się on różnić od podanego |
steps[] |
Tablica kroków oznaczająca segmenty w tym etapie. Każdy krok odpowiada jednej instrukcji nawigacji. |
travel_advisory |
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 |
Długość tego kroku w metrach. W niektórych przypadkach to pole może nie mieć wartości. |
static_duration |
Długość tej drogi bez uwzględnienia warunków drogowych. W niektórych przypadkach to pole może nie mieć wartości. |
polyline |
Linia łamana powiązana z tym krokiem. |
start_location |
Lokalizacja początkowa tego kroku. |
end_location |
Lokalizacja końcowa tego kroku. |
navigation_instruction |
Instrukcje nawigacji. |
travel_advisory |
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[] |
Interwały szybkiego odczytywania z informacjami o gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
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 |
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[] |
Interwały szybkiego odczytywania z informacjami o gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
RouteMatrixDestination
Jedno miejsce docelowe dla ComputeRouteMatrixRequest
Pola | |
---|---|
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 |
Indeks liczony od zera dla punktu początkowego w żądaniu. |
destination_index |
Indeks liczony od zera dla miejsca docelowego w żądaniu. |
status |
Kod stanu błędu tego elementu. |
condition |
Wskazuje, czy trasa została znaleziona czy nie. Niezależny od stanu. |
distance_meters |
Odległość przebyta trasa w metrach. |
duration |
Czas potrzebny na nawigowanie po trasie. Jeśli ustawisz |
static_duration |
Długość trasy bez uwzględnienia warunków drogowych. |
travel_advisory |
Dodatkowe informacje o trasie. Na przykład: informacje o ograniczeniach i opłatach |
fallback_info |
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 |
Wymagane. Punkt początkowy |
route_modifiers |
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 |
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 |
avoid_highways |
Określa, czy w uzasadnionych przypadkach unikać autostrad. Priorytet będą miały trasy niezawierające autostrad. Dotyczy tylko środków transportu |
avoid_ferries |
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 |
avoid_indoor |
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 |
vehicle_info |
Określa informacje o pojeździe. |
toll_passes[] |
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 |
Cel arkusza stawek. |
RateCard
Obejmuje cel trasy RateCard.
Pola | |
---|---|
cost_per_minute |
Opcjonalnie: Koszt za minutę. |
cost_per_km |
Opcjonalnie: Koszt za kilometr. |
include_tolls |
Opcjonalnie: Określa, czy w całkowitym koszcie uwzględnić koszt opłat drogowych. |
MonetaryCost
Zawiera koszt użyty w arkuszu stawek.
Pola | |
---|---|
value |
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 |
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[] |
Interwały szybkiego odczytywania z informacjami o gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
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 |
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 |
Indeks końcowy tego przedziału na linii łamanej. Jeśli indeks w pliku JSON wynosi 0, pole wydaje się być puste. |
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[] |
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_KY_RIVERLINK |
Kentucky, USA. |
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 |
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 |
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 |
vehicle_stopover |
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ż |
side_of_road |
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 |
Punkt określony za pomocą współrzędnych geograficznych, w tym opcjonalny nagłówek. |
place_id |
Identyfikator miejsca POI powiązany z punktem pośrednim. |