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
Routes Preferred API.
ComputeCustomRoutes |
---|
Biorąc pod uwagę zestaw końcowych i pośrednich punktów na trasie oraz cel trasy, oblicza najlepszą trasę dla tej trasy. Zwraca także najszybszą trasę 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ć za pomocą parametru URL Na przykład w tej metodzie:
Google odradza korzystanie z maski pola odpowiedzi z symbolem wieloznacznym (
|
ComputeRouteMatrix |
---|
Pobiera listę miejsc początkowych i docelowych, a następnie zwraca strumień zawierający informacje o trasie dla każdej kombinacji punktu początkowego i docelowego. UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać za pomocą parametru URL Na przykład w tej metodzie:
Ważne jest, aby w masce pola podać
|
ComputeRoutes |
---|
Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi z uwzględnieniem zestawu terminali i pośrednich punktów na trasie. UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać za pomocą parametru URL Na przykład w tej metodzie:
Odradzamy stosowanie maski pola odpowiedzi z symbolem wieloznacznym (
|
ComputeCustomRoutesRequest
Komunikat żądania ComputeCustomRoutes.
Pola | |
---|---|
origin |
To pole jest wymagane. Punkt na trasie początkowy. |
destination |
To pole jest wymagane. Docelowy punkt na trasie. |
intermediates[] |
Opcjonalnie. Zestaw punktów pośrednich na trasie (bez punktów końcowych) do zatrzymania się lub przejechania. Obsługiwanych jest do 25 pośrednich punktów pośrednich. |
travel_mode |
Opcjonalnie. Określa środek transportu. Obecnie obsługiwany jest tylko DYSK. |
routing_preference |
Opcjonalnie. Określa sposób obliczania trasy. Serwer próbuje użyć wybranych preferencji routingu do obliczenia trasy. Jeśli ustawienie routingu skutkuje błędem lub bardzo długim czasem oczekiwania, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy |
polyline_quality |
Opcjonalnie. Określa preferencje dotyczące 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 zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się. |
route_modifiers |
Opcjonalnie. Zestaw warunków, które mają wpływ na sposób obliczania tras. |
route_objective |
To pole jest wymagane. Cel trasy, pod którego kątem należy optymalizować kampanię. |
language_code |
Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „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 określany na podstawie lokalizacji żądania trasy. |
units |
Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Dotyczy to też pola |
ComputeCustomRoutesResponse
Komunikat odpowiedzi ComputeCustomRoutes.
Pola | |
---|---|
routes[] |
„Najlepsze” trasy dla celu trasy wejściowej. |
fastest_route |
Najszybsza trasa referencyjna. |
shortest_route |
Najkrótsza trasa referencyjna. |
fallback_info |
Informacje zastępcze dla tras niestandardowych. |
FallbackInfo
Obejmuje informacje o zastępstwie ComputeCustomRoutes. ComputeCustomRoutes wykonuje 2 typy wartości zastępczych:
Jeśli nie może obliczyć trasy przy użyciu parametru routing_preference, o który prosi klient, przełączy się na inny tryb routingu. W tym przypadku do przekazania informacji o użytym trybie awaryjnego oraz o przyczynie awaryjnego sposobu korzystania z usługi fallback_routing_mode i Routing_mode_fallback_reason są używane informacje o użyciu zastępczego trybu routingu.
Jeśli nie może obliczyć „najlepszej” trasy dla celu trasy wyznaczonego przez klienta, może zostać użyta inna trasa. Zmienna fallback_route_objective służy do przekazywania celu trasy zastępczej.
Pola | |
---|---|
routing_mode |
Tryb routingu używany w odpowiedzi. Jeśli tak, tryb może się różnić od preferencji routingu określonych w pierwotnym żądaniu klienta. |
routing_mode_reason |
Przyczyna użycia odpowiedzi zastępczej zamiast pierwotnej odpowiedzi. To pole jest wypełniane tylko po uruchomieniu trybu awaryjnego i zwróceniu odpowiedzi zastępczej. |
route_objective |
Cel trasy użyty w odpowiedzi. Jeśli uruchomiono reklamę zastępczą, cel może się różnić od celu trasy wskazanego w pierwotnym żądaniu klienta. |
FallbackRouteObjective
Cel RouteTarget 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 wysyła żądanie RateCard i ustawia ustawienie include_tolls na true, a Google nie ma informacji o cenach opłat za daną trasę, interfejs API przełącza się na kartę RateCard bez uwzględniania wysokości opłat za przejazd. |
ComputeRouteMatrixRequest
Komunikat żądania ComputeRouteMatrix
Pola | |
---|---|
origins[] |
To pole jest wymagane. Tablica źródeł, która określa wiersze macierzy odpowiedzi. W przypadku mocy zbioru miejsc wylotu i przylotu obowiązują pewne ograniczenia dotyczące rozmiaru:
|
destinations[] |
To pole jest 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ć wybranych preferencji routingu do obliczenia trasy. Jeśli ustawienia routingu spowodują błąd lub bardzo długi czas oczekiwania, zostanie zwrócony błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy |
departure_time |
Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się. |
ComputeRoutesRequest
Komunikat żądania ComputeRoutes.
Pola | |
---|---|
origin |
To pole jest wymagane. Punkt na trasie początkowy. |
destination |
To pole jest wymagane. Docelowy punkt na trasie. |
intermediates[] |
Opcjonalnie. Zestaw punktów pośrednich na trasie (bez punktów końcowych) do zatrzymania się lub przejechania. Obsługiwanych jest do 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ć wybranych preferencji routingu do obliczenia trasy. Jeśli ustawienie routingu skutkuje błędem lub bardzo długim czasem oczekiwania, zwracany jest błąd. W przyszłości możemy wdrożyć mechanizm zastępczego, aby użyć innej opcji, jeśli preferowana opcja nie daje prawidłowego wyniku. Możesz określić tę opcję tylko wtedy, gdy |
polyline_quality |
Opcjonalnie. Określa preferencje dotyczące 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 zostanie użyta godzina przesłania żądania. Jeśli ustawisz tę wartość na czas, który już występuje, żądanie nie powiedzie się. |
compute_alternative_routes |
Określa, czy oprócz trasy mają być obliczane trasy alternatywne. |
route_modifiers |
Opcjonalnie. Zestaw warunków, które mają wpływ na sposób obliczania tras. |
language_code |
Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „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 określany na podstawie lokalizacji żądania trasy. |
units |
Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Dotyczy to też pola |
optimize_waypoint_order |
Jeśli parametr OptimizeWaypointOrder ma wartość true (prawda), podejmowana jest próba zmiany kolejności określonych pośrednich punktów pośrednich w celu zminimalizowania ogólnego kosztu trasy. Jeśli którykolwiek z pośrednich punktów pośrednich prowadzi przez punkt pośredni, żądanie kończy się niepowodzeniem. Użyj ComputeRoutesResponse.Routes.Optimized_and_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku |
ComputeRoutesResponse
ComputeRoutes zwraca komunikat z odpowiedzią.
Pola | |
---|---|
routes[] |
Zawiera tablicę obliczonych tras (maksymalnie 3), gdy podasz compute_alternatives_routes, a jeśli nie, zawiera tylko 1 trasę. 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źć żadnej trasy. |
fallback_info |
W niektórych przypadkach, gdy serwer nie jest w stanie obliczyć trasy na podstawie wszystkich ustawień wejściowych, może skorzystać z innego sposobu obliczania. W przypadku użycia trybu awaryjnego to pole zawiera szczegółowe informacje o odpowiedzi kreacji zastępczej. W przeciwnym razie to pole jest nieskonfigurowane. |
CustomRoute
Obejmuje trasę niestandardową obliczoną na podstawie celu trasy określonego przez klienta. CustomRoute 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 |
Trasa uznana za „najlepszą” w przypadku celu trasy wejściowej. |
token |
Bezpieczny w internecie token trasy zakodowany w standardzie base64, który można przekazać do pakietu NavSDK. Umożliwia on odtworzenie trasy podczas nawigacji, a w przypadku zmiany trasy może uwzględniać pierwotną intencję, gdy wywoływane jest wywołanie RoutesPreferred ComputeCustomRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob. |
FallbackInfo
Informacje o sposobie i sposobie wykorzystania wyniku kreacji zastępczej. Jeśli to pole jest skonfigurowane, oznacza to, że serwer użył jako ustawienia awaryjnego trybu routingu innego niż preferowany.
Pola | |
---|---|
routing_mode |
Tryb routingu używany w odpowiedzi. Jeśli tak, tryb może się różnić od preferencji routingu określonych w pierwotnym żądaniu klienta. |
reason |
Przyczyna użycia odpowiedzi zastępczej zamiast pierwotnej odpowiedzi. To pole jest wypełniane tylko po uruchomieniu trybu awaryjnego i zwróceniu odpowiedzi zastępczej. |
FallbackReason
Powody korzystania z odpowiedzi zastępczej.
Wartości w polu enum | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
Nie podano przyczyny awaryjnej. |
SERVER_ERROR |
Podczas obliczania tras przy użyciu preferowanego trybu routingu wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony w innym trybie. |
LATENCY_EXCEEDED |
Nie udało nam się ukończyć obliczeń z wykorzystaniem preferowanego trybu trasy na czas, ale udało nam się zwrócić wynik obliczony przez tryb alternatywny. |
FallbackRoutingMode
Rzeczywisty tryb routingu używany w przypadku zwróconej odpowiedzi zastępczej.
Wartości w polu enum | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Niewykorzystywany. |
FALLBACK_TRAFFIC_UNAWARE |
Wskazuje, że do obliczenia odpowiedzi użyto trybu routingu „TRAFFIC_UNAWARE”. |
FALLBACK_TRAFFIC_AWARE |
Wskazuje, że do obliczenia odpowiedzi użyto trybu routingu „TRAFFIC_AWARE”. |
Lokalizacja
Obejmuje lokalizację (punkt geograficzny i opcjonalny nagłówek).
Pola | |
---|---|
lat_lng |
Współrzędne geograficzne punktu pośredniego. |
heading |
Kierunek kompasu powiązany z kierunkiem ruchu. Ta wartość służy do określenia strony drogi na potrzeby odbioru i zwrotu. Wartości nagłówka mogą przyjmować wartość z zakresu od 0 do 360, gdzie 0 oznacza kierunek północny, 90 wskazuje kierunek na wschód itd. Tego pola można używać tylko w przypadku trybów podróży |
Ruch
Zestaw wartości określających działanie nawigacyjne w danym kroku (np. skręt w lewo, scalanie, prosto itd.).
Wartości w polu enum | |
---|---|
MANEUVER_UNSPECIFIED |
Niewykorzystywany. |
TURN_SLIGHT_LEFT |
Obróć się lekko w lewo. |
TURN_SHARP_LEFT |
Ostro w lewo. |
UTURN_LEFT |
Zawróć w lewo. |
TURN_LEFT |
Obróć się w lewo. |
TURN_SLIGHT_RIGHT |
Obróć się lekko w prawo. |
TURN_SHARP_RIGHT |
Ostro w prawo. |
UTURN_RIGHT |
Zawróć w prawo. |
TURN_RIGHT |
Obróć się w prawo. |
STRAIGHT |
Idź prosto. |
RAMP_LEFT |
Skorzystaj z lewej pochylni. |
RAMP_RIGHT |
Skorzystaj z właściwego zjazdu. |
MERGE |
Scal w ruch. |
FORK_LEFT |
Otwórz lewy rozwidlenie. |
FORK_RIGHT |
Trzymaj właściwy rozwidlenie. |
FERRY |
Wybierz prom. |
FERRY_TRAIN |
Wybierz pociąg prowadzący do promu. |
ROUNDABOUT_LEFT |
Na rondzie skręć w lewo. |
ROUNDABOUT_RIGHT |
Na rondzie skręć w prawo. |
Linia łamana
Obejmuje 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 łamanego za pomocą algorytmu kodowania wiersza łamanego, |
geo_json_linestring |
Wskazuje linię łamaną w formacie linii GeoJSON |
PolylineEncoding
Określa preferowany typ linii łamanej, która ma zostać zwrócona.
Wartości w polu enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Nie określono preferencji typu linii łamanej. Domyślna wartość to ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Określa linię łamaną zakodowaną za pomocą algorytmu kodowania wiersza łamanego. |
GEO_JSON_LINESTRING |
Wskazuje linię łamaną w formacie linii GeoJSON |
PolylineQuality
Zestaw wartości określających jakość linii łamanej.
Wartości w polu enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Nie określono preferencji dotyczących jakości linii łamanych. 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 większego rozmiaru odpowiedzi. Użyj tej wartości, gdy potrzebujesz większej precyzji. |
OVERVIEW |
Określa ogólną linię łamaną, która składa się z małej liczby punktów. Użyj tej wartości przy wyświetlaniu opisu trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie w porównaniu do opcji HIGH_QUALITY . |
Trasa
Obejmuje trasę, która składa się z szeregu połączonych fragmentów drogi łączących początek, koniec i pośrednie punkty na trasie.
Pola | |
---|---|
legs[] |
Zbiór odcinków (odcinków ścieżki między punktami na trasie) tworzących trasę. Każdy etap odpowiada podróży między dwoma punktami Waypoint niebędącymi |
distance_meters |
Długość trasy w metrach. |
duration |
Czas potrzebny na nawigację po trasie. Jeśli ustawisz |
static_duration |
Czas podróży po trasie bez uwzględniania warunków drogowych. |
polyline |
Ogólna linia łamana trasy. Ta linia łamana będzie połączona linią łamaną wszystkich elementów |
description |
Opis trasy. |
warnings[] |
Tablica ostrzeżeń do wyświetlenia 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 na trasie. W przeciwnym razie pole jest puste. Załóżmy np., że dane wejściowe to: Origin: LA; średniozaawansowany: Dallas, Bangor, Phoenix; miejsce docelowe: Nowy Jork; a zoptymalizowana kolejność pośrednich punktów pośrednich to: Phoenix, Dallas, Bangor. Następnie pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 dla pierwszego pośredniego punktu pośredniego. |
RouteLeg
Obejmuje segment między punktami pośrednimi innymi niż via
.
Pola | |
---|---|
distance_meters |
Długość odcinka trasy w metrach. |
duration |
Długość czasu potrzebnego na poruszanie się przez nogę. Jeśli |
static_duration |
Długość przejazdu przez dany etap obliczona bez uwzględniania warunków drogowych. |
polyline |
Ogólna linia łamana dla tej nogi. Obejmuje to też linię łamaną każdego elementu |
start_location |
Lokalizacja początkowa tego etapu. Ta wartość może się różnić od atrybutu |
end_location |
Lokalizacja końcowa tej części. Ta wartość może się różnić od atrybutu |
steps[] |
Tablica kroków oznaczających segmenty w tym etapie. Każdy krok odpowiada jednej instrukcji nawigacji. |
travel_advisory |
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp. na etapie trasy. |
RouteLegStep
Obejmuje segment elementu RouteLeg
. Krok odpowiada jednej instrukcji nawigacji. Etapy trasy składają się z schodów.
Pola | |
---|---|
distance_meters |
Odległość przebyta w tym kroku wyrażona w metrach. W niektórych przypadkach to pole może nie mieć wartości. |
static_duration |
Długość podróży na tym etapie bez uwzględniania 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 należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie etapu. |
RouteLegStepTravelAdvisory
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie etapu.
Pola | |
---|---|
speed_reading_intervals[] |
Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
RouteLegTravelAdvisory
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp. na etapie trasy.
Pola | |
---|---|
toll_info |
Zawiera informacje o opłatach w konkretnej RouteLeg. To pole jest wypełniane tylko wtedy, gdy na RouteLeg powinny być dostępne opłaty za przejazd. Jeśli to pole jest ustawione, ale pole podrzędne szacunkowej ceny nie jest wypełniane, droga będzie zawierać drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, na trasie RouteLeg nie jest pobierana opłata. |
speed_reading_intervals[] |
Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
RouteMatrixDestination
Jedno miejsce docelowe dla ComputeRouteMatrixRequest
Pola | |
---|---|
waypoint |
To pole jest wymagane. Docelowy punkt na trasie |
RouteMatrixElement
Zawiera informacje o trasie obliczone dla pary punktu początkowego i docelowego w interfejsie ComputeRouteMatrix API. Protokół ten można przesyłać strumieniowo do klienta.
Pola | |
---|---|
origin_index |
Liczony od zera indeks źródła w żądaniu. |
destination_index |
Indeks miejsca docelowego w żądaniu, który jest liczony od zera. |
status |
Kod stanu błędu tego elementu. |
condition |
Wskazuje, czy trasa została znaleziona. Niezależność od statusu. |
distance_meters |
Długość trasy w metrach. |
duration |
Czas potrzebny na nawigację po trasie. Jeśli ustawisz |
static_duration |
Czas podróży po trasie bez uwzględniania 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 może obliczyć trasy na podstawie podanych ustawień dla tej konkretnej pary miejsca docelowego i miejsca docelowego, może przełączyć się na inny tryb obliczania. W przypadku używania trybu awaryjnego to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W przeciwnym razie to pole jest nieskonfigurowane. |
RouteMatrixElementCondition
Stan zwracanej trasy.
Wartości w polu enum | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Używana tylko wtedy, gdy status elementu jest nieprawidłowy. |
ROUTE_EXISTS |
Znaleziono trasę i uzupełniono odpowiednie informacje o elemencie. |
ROUTE_NOT_FOUND |
Nie znaleziono trasy. Pola zawierające informacje o trasie, takie jak distance_meters czy duration , nie zostaną wypełnione w elemencie. |
RouteMatrixOrigin
Jedno źródło dla ComputeRouteMatrixRequest
Pola | |
---|---|
waypoint |
To pole jest wymagane. Punkt na trasie początkowy |
route_modifiers |
Opcjonalnie. Modyfikatory każdej trasy, która używa tego elementu jako punktu początkowego |
RouteModifiers
Zawiera zestaw opcjonalnych warunków do spełnienia przy obliczaniu tras.
Pola | |
---|---|
avoid_tolls |
Określa, czy w uzasadnionych przypadkach unikać dróg płatnych. Pierwszeństwo będą miały trasy, które nie zawierają dróg płatnych. Dotyczy tylko trybów podróży |
avoid_highways |
Określa, czy w uzasadnionych przypadkach należy unikać autostrad. Pierwszeństwo będą miały trasy niezawierające autostrad. Dotyczy tylko trybów podróży |
avoid_ferries |
Określa, czy w uzasadnionych przypadkach unikać przepraw promowych. Pierwszeństwo będą miały trasy, które nie obejmują podróży promami. Dotyczy tylko trybów podróży |
avoid_indoor |
Określa, czy w uzasadnionych przypadkach unikać wchodzenia w pomieszczenia. Pierwszeństwo będą miały trasy, które nie zawierają nawigacji wewnątrz budynku. Dotyczy tylko trybu podróży |
vehicle_info |
Określa informacje o pojeździe. |
toll_passes[] |
Zawiera informacje o winietach. Jeśli podasz opłaty za przejazd, interfejs API spróbuje zwrócić cenę biletu. Jeśli nie podasz informacji o opłatach, interfejs API będzie traktować tę opłatę jako nieznaną i stara się zwrócić cenę gotówką. Dotyczy tylko trybów podróży Drive i TWO_WHEELER. |
RouteObjective
Zawiera cel, pod kątem którego ma zostać zoptymalizowana optymalizacja według ComputeCustomRoutes.
Pola | |
---|---|
rate_card |
Cel Arkusz 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 należy uwzględnić opłaty za przejazd w łącznym koszcie. |
MonetaryCost
Obejmuje koszt używany w arkuszu stawek.
Pola | |
---|---|
value |
To pole jest wymagane. Wartość kosztu w walucie lokalnej wywnioskowana z żądania. |
RouteTravelAdvisory
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu itp.
Pola | |
---|---|
toll_info |
Zawiera informacje o opłatach na trasie. To pole jest wypełniane tylko wtedy, gdy na trasie spodziewane są opłaty za przejazd. Jeśli to pole jest ustawione, ale pole podrzędne szacunkowej ceny nie jest wypełniane, droga będzie zawierać drogi płatne, ale nie znamy szacunkowej ceny. Jeśli to pole nie jest ustawione, na trasie nie ma opłaty. |
speed_reading_intervals[] |
Szybkość czytania interwałów ze szczegółowym opisem gęstości ruchu. Ma zastosowanie w przypadku preferencji routingu Przykład:
|
RouteTravelMode
Zestaw wartości służących 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óżuj rowerem. |
WALK |
Podróżuj pieszo. |
TWO_WHEELER |
Jednokołowy pojazd silnikowy. Na przykład motocykl. Zwróć uwagę, że różni się to od trybu podróży BICYCLE , który obejmuje tryb obsługiwany przez człowieka. |
TAXI |
Jazda licencjonowaną taksówką, która na niektórych obszarach może pozwolić pojazdowi na korzystanie z wyznaczonych pasów taksówek. Tryb TAXI jest funkcją eksperymentalną. Jeśli klient poprosi o trasę TAXI w mieście, w którym dane o pasach taksówek nie są dostępne, zwracana jest trasa drive. |
RoutingPreference
Zestaw 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 routingu. Wartość domyślna to TRAFFIC_AWARE . |
TRAFFIC_UNAWARE |
Oblicza trasy bez uwzględniania warunków drogowych. Odpowiednie, gdy warunki drogowe nie mają znaczenia. Użycie tej wartości skutkuje najkrótszym czasem oczekiwania. |
TRAFFIC_AWARE |
Oblicza trasy, uwzględniając warunki na drodze. W odróżnieniu od TRAFFIC_AWARE_OPTIMAL niektóre optymalizacje są stosowane w celu znacznego skrócenia czasu oczekiwania. |
TRAFFIC_AWARE_OPTIMAL |
Oblicza trasy z uwzględnieniem warunków na drodze bez stosowania większości optymalizacji skuteczności. Użycie tej wartości powoduje najdłuższe 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 przedział i opisuje jego ruch według następujących kategorii.
Pola | |
---|---|
start_polyline_point_index |
Indeks początkowy tego przedziału na linii łamanej. Jeśli w formacie JSON indeks ma wartość 0, pole wydaje się niepełne. |
end_polyline_point_index |
Indeks końcowy tego przedziału na linii łamanej. Jeśli w formacie JSON indeks ma wartość 0, pole wydaje się niepełne. |
speed |
Prędkość ruchu w tym interwale. |
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ść, korek nie jest wykrywany. |
SLOW |
Wykryto korek, ale nie utworzono korka. |
TRAFFIC_JAM |
Wykryto korek. |
TollInfo
Zawiera informacje o opłatach na stronie Route
lub RouteLeg
.
Pola | |
---|---|
estimated_price[] |
Wartość pieniężna opłat za określoną trasę lub RouteLeg. Ta lista zawiera kwoty dla każdej waluty, która ma zostać pobrana przez stacje opłat. Zwykle lista zawiera tylko jeden element dla tras z opłatami za przejazd w jednej walucie. W przypadku wyjazdów międzynarodowych lista może zawierać kilka elementów, które odzwierciedlają opłaty za przejazd w różnych walutach. |
TollPass
Lista obsługiwanych przez nas winiet na całym świecie.
Wartości w polu enum | |
---|---|
TOLL_PASS_UNSPECIFIED |
Niewykorzystywany. Jeśli ta wartość zostanie użyta, żądanie nie powiedzie się. |
AU_ETOLL_TAG |
Jeden z wielu dostawców winietów w Sydney. https://www.myetoll.com.au |
AU_EWAY_TAG |
Jeden z wielu dostawców winietów w Sydney. https://www.tollpay.com.au/ |
AU_LINKT |
Opłata za przejazd w całej Australii Więcej informacji znajdziesz na stronie https://www.linkt.com.au/. |
AR_TELEPASE |
Opłata za przejazd w Argentynie. Dodatkowe informacje znajdziesz na https://telepase.com.ar. |
BR_AUTO_EXPRESO |
Brazylijska opłata za przejazd Dodatkowe informacje znajdziesz na https://www.autoexpreso.com. |
BR_CONECTCAR |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na https://conectcar.com. |
BR_MOVE_MAIS |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na https://movemais.com. |
BR_PASSA_RAPIDO |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://pasorapido.gob.do/. |
BR_SEM_PARAR |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://www.semparar.com.br. |
BR_TAGGY |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://taggy.com.br. |
BR_VELOE |
Brazylijska opłata za przejazd Więcej informacji znajdziesz na stronie https://veloe.com.br/site/onde-usar. |
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD |
Przejście graniczne z Kanady do Stanów Zjednoczonych. |
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD |
Przejście graniczne z Kanady do Stanów Zjednoczonych. |
CA_US_BLUE_WATER_EDGE_PASS |
Przejście graniczne przez Ontario w Kanadzie – Michigan. |
CA_US_CONNEXION |
Przejście graniczne przez Ontario w Kanadzie – Michigan. |
CA_US_NEXUS_CARD |
Przejście graniczne z Kanady do Stanów Zjednoczonych. |
ID_E_TOLL |
Indonezja. Karta elektroniczna wydawana przez kilka banków używana do płacenia za przejazdy. Wszystkie karty elektroniczne w bankach są rozliczane tak samo, więc potrzeba tylko jednej wartości wyliczeniowej. 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 tablicy stanowej HP. |
MX_TAG_IAVE |
Meksyk. |
MX_TAG_TELEVIA |
Meksykański biuro podróży. Jeden z wielu działających w mieście Meksyk. Dodatkowe informacje znajdziesz na https://www.televia.com.mx. |
MX_VIAPASS |
Meksyk. Więcej informacji znajdziesz na stronie https://www.viapass.com.mx/viapass/web_home.aspx. |
US_AL_FREEDOM_PASS |
Alabama, Stany Zjednoczone. |
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS |
Alaska, Stany Zjednoczone. |
US_CA_FASTRAK |
Kalifornia, Stany Zjednoczone. |
US_CA_FASTRAK_CAV_STICKER |
Wskazuje, że oprócz naklejki na pojazd z czystym powietrzem (CAV) wydany przez DMV kierowca ma dowolny bilet. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml |
US_CO_EXPRESSTOLL |
Kolorado, USA. |
US_CO_GO_PASS |
Kolorado, USA. |
US_DE_EZPASSDE |
Niemcy, Stany Zjednoczone. |
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 |
Illinois, Stany Zjednoczone. |
US_IL_IPASS |
Illinois, Stany Zjednoczone. |
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, Stany Zjednoczone. |
US_LA_GEAUXPASS |
Luizjana, Stany Zjednoczone. |
US_LA_TOLL_TAG |
Luizjana, Stany Zjednoczone. |
US_MA_EZPASSMA |
Massachusetts, USA. |
US_MD_EZPASSMD |
MD, USA. |
US_ME_EZPASSME |
ME, Stany Zjednoczone. |
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD |
MI, Stany Zjednoczone. |
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
MI, Stany Zjednoczone. |
US_MI_IQ_PROX_CARD |
MI, Stany Zjednoczone. |
US_MI_MACKINAC_BRIDGE_MAC_PASS |
MI, Stany Zjednoczone. |
US_MI_NEXPRESS_TOLL |
MI, Stany Zjednoczone. |
US_MN_EZPASSMN |
MN, Stany Zjednoczone. |
US_NC_EZPASSNC |
Karolina Północna, Stany Zjednoczone. |
US_NC_PEACH_PASS |
Karolina Północna, Stany Zjednoczone. |
US_NC_QUICK_PASS |
Karolina Północna, Stany Zjednoczone. |
US_NH_EZPASSNH |
NH, Stany Zjednoczone. |
US_NJ_DOWNBEACH_EXPRESS_PASS |
NJ, Stany Zjednoczone. |
US_NJ_EZPASSNJ |
NJ, Stany Zjednoczone. |
US_NY_EXPRESSPASS |
Nowy Jork, Stany Zjednoczone. |
US_NY_EZPASSNY |
Nowy Jork, Stany Zjednoczone. |
US_OH_EZPASSOH |
Ohio, Stany Zjednoczone. |
US_PA_EZPASSPA |
Pensylwania, Stany Zjednoczone. |
US_RI_EZPASSRI |
Rzym, Stany Zjednoczone. |
US_SC_PALPASS |
Karolina Południowa, Stany Zjednoczone. |
US_TX_BANCPASS |
Teksas, Stany Zjednoczone. |
US_TX_DEL_RIO_PASS |
Teksas, Stany Zjednoczone. |
US_TX_EFAST_PASS |
Teksas, Stany Zjednoczone. |
US_TX_EAGLE_PASS_EXPRESS_CARD |
Teksas, Stany Zjednoczone. |
US_TX_EPTOLL |
Teksas, Stany Zjednoczone. |
US_TX_EZ_CROSS |
Teksas, Stany Zjednoczone. |
US_TX_EZTAG |
Teksas, Stany Zjednoczone. |
US_TX_LAREDO_TRADE_TAG |
Teksas, Stany Zjednoczone. |
US_TX_PLUSPASS |
Teksas, Stany Zjednoczone. |
US_TX_TOLLTAG |
Teksas, Stany Zjednoczone. |
US_TX_TXTAG |
Teksas, Stany Zjednoczone. |
US_TX_XPRESS_CARD |
Teksas, Stany Zjednoczone. |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
UT, Stany Zjednoczone. |
US_VA_EZPASSVA |
Wirginia, Stany Zjednoczone. |
US_WA_BREEZEBY |
Waszyngton, USA. |
US_WA_GOOD_TO_GO |
Waszyngton, USA. |
US_WV_EZPASSWV |
WV, Stany Zjednoczone. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, Stany Zjednoczone. |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV, Stany Zjednoczone. |
Jednostki
Zestaw wartości określających jednostkę miary używaną na wyświetlaczu.
Wartości w polu enum | |
---|---|
UNITS_UNSPECIFIED |
Nie określono jednostek miary. Domyślnie jest to jednostka miary określona na podstawie żądania. |
METRIC |
Jednostki miary. |
IMPERIAL |
Imperialne (angielskie) jednostki miary. |
VehicleEmissionType
Zestaw wartości opisujących typ emisji dwutlenku węgla. Dotyczy to tylko trybu podróży DYSK.
Wartości w polu enum | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
Nie określono typu emisji. Domyślnie GASOLINE. |
GASOLINE |
Pojazd napędzany paliwem benzynowym lub benzynowym. |
ELECTRIC |
Pojazd napędzany prądem. |
HYBRID |
Pojazd z napędem hybrydowym (np. benzynowym lub elektrycznym). |
VehicleInfo
Zawiera informacje o pojeździe, takie jak ostatni znak na tablicy rejestracyjnej.
Pola | |
---|---|
emission_type |
Opisuje typ emisji zanieczyszczeń pojazdu. Dotyczy to tylko trybu podróży DYSK. |
Punkt pośredni
Obejmuje punkt pośredni. Punkty pośrednie wyznaczają zarówno początek, jak i koniec trasy, a także pośrednie przystanki na trasie.
Pola | |
---|---|
via |
Oznacza ten punkt na drodze jako etap, a nie punkt pośredni. W przypadku każdego punktu pośredniego nieprzeznaczonego w żądaniu, odpowiedź dołącza wpis do tablicy |
vehicle_stopover |
Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów do zatrzymania się i tam, gdzie mogą mieć przystanek lub wysyłkę. Gdy ustawisz tę wartość, obliczona trasa nie będzie obejmować punktów pośrednich innych niż |
side_of_road |
Wskazuje, że lokalizacja tego punktu pośredniego ma pierwszeństwo przy zatrzymaniu się po określonej stronie drogi. Po ustawieniu tej wartości trasa biegnie przez daną lokalizację, dzięki czemu pojazd może się zatrzymać na stronie drogi, na którą kierowana jest ta lokalizacja, od jej środka. Ta opcja działa tylko w przypadku trybów podróży „Drive” i „TWO_WHEELER” oraz gdy parametr „location_type” ma wartość „location”. |
Pole sumy location_type . Różne sposoby prezentowania lokalizacji. location_type może mieć tylko jedną z tych wartości: |
|
location |
Punkt określony za pomocą współrzędnych geograficznych, wraz z opcjonalnym nagłówkiem. |
place_id |
Identyfikator miejsca POI powiązany z punktem pośrednim. |