- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Trasa
- RouteLabel
- RouteLeg
- Linia łamana
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Widoczny obszar
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Zwraca trasę podstawową wraz z opcjonalnymi trasami alternatywnymi z określonym zestawem 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ć przy użyciu parametru adresu URL $fields
lub fields
albo nagłówka HTTP/gRPC X-Goog-FieldMask
(zobacz dostępne parametry i nagłówki adresu URL). Wartość jest rozdzielaną przecinkami listą ścieżek pól. Zapoznaj się ze szczegółową dokumentacją tworzenia ścieżek pól.
Na przykład w tej metodzie:
- Maska wszystkich dostępnych pól (do sprawdzenia ręcznej):
X-Goog-FieldMask: *
- Maska pola z czasem trwania, odległością i linią łamaną na poziomie trasy (przykładowa konfiguracja produkcyjna):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google odradza korzystanie z maski pola odpowiedzi z symbolem wieloznacznym (*
) i określanie maski pola na najwyższym poziomie (routes
), ponieważ:
- Zaznaczenie tylko tych pól, które są Ci potrzebne, pozwala naszemu serwerowi skrócić cykle obliczeniowe, a przez to zwracać Ci wyniki z mniejszym opóźnieniem.
- Wybór tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilność czasu oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać więcej czasu na obliczenia. Jeśli zaznaczysz wszystkie pola lub wybierzesz wszystkie pola na najwyższym poziomie, może nastąpić spadek wydajności, ponieważ każde dodane przez nas nowe pole zostanie automatycznie uwzględnione w odpowiedzi.
- Wybranie tylko tych pól, które są potrzebne, zmniejsza rozmiar odpowiedzi i większą przepustowość sieci.
Żądanie HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
Adres URL używa składni transkodowania gRPC.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "origin": { object ( |
Pola | |
---|---|
origin |
To pole jest wymagane. Punkt 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. |
travelMode |
Opcjonalnie. Określa środek transportu. |
routingPreference |
Opcjonalnie. Określa sposób obliczania trasy. Serwer próbuje wyznaczyć trasę, korzystając z wybranego ustawienia routingu. Jeśli ustawienie routingu prowadzi do błędu lub długiego czasu oczekiwania, zwracany jest błąd. Możesz określić tę opcję tylko wtedy, gdy |
polylineQuality |
Opcjonalnie. Określa preferencję dotyczącą jakości linii łamanej. |
polylineEncoding |
Opcjonalnie. Określa preferowane kodowanie linii łamanej. |
departureTime |
Opcjonalnie. Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślną wartością będzie czas przesłania żądania. UWAGA: w przeszłości można było określić Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
arrivalTime |
Opcjonalnie. Godzina przyjazdu. UWAGA: to ustawienie można ustawić tylko wtedy, gdy Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
computeAlternativeRoutes |
Opcjonalnie. Określa, czy oprócz trasy mają być obliczane trasy alternatywne. W przypadku żądań z pośrednimi punktami na trasie nie są zwracane trasy alternatywne. |
routeModifiers |
Opcjonalnie. Zbiór warunków, które muszą spełniać warunki wpływające na sposób obliczania tras. |
languageCode |
Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Lokalny identyfikator Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język wyświetlania zostanie określony na podstawie lokalizacji żądania trasy. |
regionCode |
Opcjonalnie. Kod regionu, podany jako dwuznakowa wartość domeny najwyższego poziomu (ccTLD). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu. |
units |
Opcjonalnie. Określa jednostki miary wyświetlane w polach wyświetlania. Te pola obejmują pole |
optimizeWaypointOrder |
Opcjonalnie. Jeśli zasada ma wartość Prawda, usługa próbuje zminimalizować ogólny koszt trasy przez zmianę kolejności określonych pośrednich punktów pośrednich. Żądanie nie powiedzie się, jeśli dowolny z pośrednich punktów pośrednich jest punktem na trasie |
requestedReferenceRoutes[] |
Opcjonalnie. Określa, które trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa, której cel wyznaczania trasy jest inny niż trasa domyślna. Na przykład wynikowe obliczanie trasy z uwzględnieniem |
extraComputations[] |
Opcjonalnie. Lista dodatkowych obliczeń, które mogą zostać użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w masce pola, aby zostały zwrócone w odpowiedzi. |
trafficModel |
Opcjonalnie. Określa założenia do obliczenia czasu w ruchu. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w polach |
transitPreferences |
Opcjonalnie. Określa preferencje, które mają wpływ na zwracaną trasę dla tras |
Treść odpowiedzi
v2.computeRoutes zwraca wiadomość z odpowiedzią.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "routes": [ { object ( |
Pola | |
---|---|
routes[] |
Zawiera tablicę obliczonych tras (maksymalnie 3), gdy podasz |
fallbackInfo |
W niektórych przypadkach, gdy serwer nie może obliczyć wyników trasy przy użyciu wszystkich danych wejściowych, może w zastępstwie użyć innej metody 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. |
geocodingResults |
Zawiera odpowiedź geokodowania dla punktów na trasie określonych jako adresy. |
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ększenia rozmiaru odpowiedzi. Użyj tej wartości, gdy 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 przy wyświetlaniu opisu trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie niż opcja HIGH_QUALITY . |
PolylineEncoding
Określa preferowany typ linii łamanej do zwrócenia.
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 linii łamanej. |
GEO_JSON_LINESTRING |
Określa linię łamaną w formacie linii GeoJSON |
ReferenceRoute
Obsługiwana trasa odniesienia w ComputeRoutesRequest.
Wartości w polu enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Nieużywany. Żądania zawierające tę wartość kończą się niepowodzeniem. |
FUEL_EFFICIENT |
Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem takich parametrów jak zużycie paliwa. |
ExtraComputation
Dodatkowe obliczenia do wykonania podczas realizacji żądania.
Wartości w polu enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Nieużywany. Żądania zawierające tę wartość będą kończyć się niepowodzeniem. |
TOLLS |
Informacje o opłatach na trasach. |
FUEL_CONSUMPTION |
Szacunkowe zużycie paliwa na trasach. |
TRAFFIC_ON_POLYLINE |
linie łamane na trasach z odpowiednim natężeniem ruchu; |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions przedstawiony jako sformatowany ciąg tekstowy HTML. Treść jest przeznaczona tylko do wyświetlania. Nie analizuj ich automatycznie. |
Trasa
Obejmuje trasę, która składa się z szeregu połączonych fragmentów drogi łączących się z punktami na trasie (początkowy, końcowy i pośredni).
Zapis JSON |
---|
{ "routeLabels": [ enum ( |
Pola | |
---|---|
routeLabels[] |
Etykiety |
legs[] |
Zespół ścieżek (odcinków ścieżek między punktami na trasie), które tworzą trasę. Każdy etap odpowiada podróży między 2 elementami |
distanceMeters |
Długość trasy w metrach. |
duration |
Długość czasu potrzebnego na pokonanie trasy. Jeśli ustawisz Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
staticDuration |
Długość przejazdu wzdłuż trasy bez uwzględniania warunków drogowych. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
polyline |
Całkowita linia łamana trasy. Ta linia łamana jest 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. |
travelAdvisory |
dodatkowe informacje o trasie, |
optimizedIntermediateWaypointIndex[] |
Jeśli ustawisz |
localizedValues |
Reprezentacje tekstowe właściwości obiektu |
routeToken |
Bezpieczny w internecie token trasy zakodowany w base64, który można przekazać do pakietu SDK Navigation SDK, który umożliwia zrekonstruowanie trasy podczas nawigacji, a w przypadku zmiany trasy musi uwzględniać pierwotny cel utworzony podczas tworzenia trasy przez wywołanie metody v2.computeRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob. Nie służy do odczytywania tekstu ani wprowadzania mutacji. UWAGA: |
RouteLabel
Etykiety
umożliwiające identyfikację konkretnych właściwości trasy, które można porównać z innymi.Route
Wartości w polu enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Domyślny – nieużywany. |
DEFAULT_ROUTE |
Przy obliczaniu trasy została zwrócona domyślna „najlepsza” trasa. |
DEFAULT_ROUTE_ALTERNATE |
Alternatywa dla domyślnej „najlepszej” trasy. Takie trasy będą zwracane po określeniu . |
FUEL_EFFICIENT |
Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem parametrów Eko, takich jak zużycie paliwa. |
RouteLeg
Zawiera segment między punktami na trasie spoza via
.
Zapis JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Pola | |
---|---|
distanceMeters |
Odległość pokonywania odcinka trasy w metrach. |
duration |
Długość czasu potrzebnego na poruszanie się nogą. Jeśli Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
staticDuration |
Długość przejazdu przez odcinek, obliczona bez uwzględniania warunków drogowych. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
polyline |
Ogólna linia łamana tej odnogi obejmująca linię łamaną każdego elementu |
startLocation |
Lokalizacja początkowa tego etapu. Ta lokalizacja może się różnić od podanej lokalizacji |
endLocation |
Lokalizacja końcowa tego etapu. Ta lokalizacja może się różnić od podanej lokalizacji |
steps[] |
Tablica kroków oznaczających segmenty w tym odcinku. Każdy krok odpowiada jednej instrukcji nawigacji. |
travelAdvisory |
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na danym etapie trasy. |
localizedValues |
Reprezentacje tekstowe właściwości obiektu |
stepsOverview |
Omówienie czynności, które musisz wykonać w tym artykule ( |
Linia łamana
Obejmuje zakodowaną linię łamaną.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy polyline_type . Obejmuje typ linii łamanej. Domyślnie jest to zakodowana_łamana. polyline_type może być tylko jedną z tych wartości: |
|
encodedPolyline |
Kodowanie ciągu łamanego linii łamanej za pomocą algorytmu kodowania linii łamanej |
geoJsonLinestring |
Wskazuje linię łamaną w formacie linii GeoJSON. |
RouteLegStep
Zawiera segment elementu
. Krok odpowiada jednej instrukcji nawigacji. Etapy trasy składają się z schodów.RouteLeg
Zapis JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Pola | |
---|---|
distanceMeters |
Odległość pokonywania tego kroku wyrażona w metrach. W pewnych okolicznościach to pole może nie mieć wartości. |
staticDuration |
Czas podróży na tym etapie bez uwzględniania warunków drogowych. W pewnych okolicznościach to pole może nie mieć wartości. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
polyline |
Linia łamana powiązana z tym krokiem. |
startLocation |
Lokalizacja początkowa tego kroku. |
endLocation |
Lokalizacja końcowa tego kroku. |
navigationInstruction |
Instrukcje nawigacji. |
travelAdvisory |
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie. |
localizedValues |
Reprezentacje tekstowe właściwości obiektu |
transitDetails |
Szczegóły dotyczące tego kroku, jeśli tryb podróży to |
travelMode |
Środek transportu użyty w tym kroku. |
Ruch
Zestaw wartości określających działanie nawigacyjne, które należy wykonać na bieżącym kroku (np. skręć w lewo, scal lub prosto).
Wartości w polu enum | |
---|---|
MANEUVER_UNSPECIFIED |
Nieużywany. |
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 prawą rampę. |
MERGE |
Scal w ruch. |
FORK_LEFT |
Skręć w lewy rozwidlenie. |
FORK_RIGHT |
Weź właściwy rozwidlenie. |
FERRY |
Wybierzcie się promem. |
FERRY_TRAIN |
Wsiądź do pociągu prowadzącego na prom. |
ROUNDABOUT_LEFT |
Skręć w lewo na rondzie. |
ROUNDABOUT_RIGHT |
Skręć w prawo na rondzie. |
DEPART |
Początkowy manewr. |
NAME_CHANGE |
Służy do wskazywania zmiany nazwy ulicy. |
RouteLegStepTravelAdvisory
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie.
Zapis JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Pola | |
---|---|
speedReadingIntervals[] |
UWAGA: to pole nie jest obecnie wypełnione. |
RouteLegStepLocalizedValues
Reprezentacje tekstowe określonych właściwości.
Zapis JSON |
---|
{ "distance": { object ( |
Pola | |
---|---|
distance |
Długość podróży przedstawiona w formie tekstowej. |
staticDuration |
Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej. |
RouteLegStepTransitDetails
Dodatkowe informacje o RouteLegStep
związane z trasami TRANSIT
.
Zapis JSON |
---|
{ "stopDetails": { object ( |
Pola | |
---|---|
stopDetails |
Informacje o przystankach na czas przyjazdu i odjazdu na danym etapie. |
localizedValues |
Reprezentacje tekstowe właściwości obiektu |
headsign |
Określa kierunek jazdy na tej linii zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdu. Kierunek to często stacja docelowa. |
headway |
Określa oczekiwany czas jako czas między odjazdem z tego samego przystanku o danej porze. Jeśli na przykład ustawisz wartość 600 sekund na trasie przejazdu, w razie spóźnienia na autobus musisz czekać 10 minut. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
transitLine |
Informacje o linii transportu publicznego użytej w tym kroku. |
stopCount |
Liczba przesiadek od odjazdu do przystanku przyjazdu. Liczba ta obejmuje przystanek przylotów, ale nie uwzględnia przystanku odlotu. Jeśli na przykład trasa rozpoczyna się ze przystanku A, mija przystanki B i C i dociera do przystanku D, stopCount zwróci wartość 3. |
tripShortText |
Tekst widoczny w rozkładach jazdy i na tablicach informacyjnych dla pasażerów, którzy chcą skorzystać z transportu publicznego. Tekst powinien jednoznacznie identyfikować podróż w ramach dnia usługi. Na przykład „538” to |
TransitStopDetails
Szczegółowe informacje o przystankach: RouteLegStep
.
Zapis JSON |
---|
{ "arrivalStop": { object ( |
Pola | |
---|---|
arrivalStop |
Informacje o przystanku na danym etapie. |
arrivalTime |
Szacowany czas dotarcia na miejsce. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
departureStop |
Informacje o przystanku odjazdu dla tego kroku. |
departureTime |
Szacowany czas odjazdu danego kroku. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
TransitStop
Informacje o przystanku.
Zapis JSON |
---|
{
"name": string,
"location": {
object ( |
Pola | |
---|---|
name |
Nazwa przystanku. |
location |
Lokalizacja przystanku wyrażona we współrzędnych szerokości i długości geograficznej. |
TransitDetailsLocalizedValues
Zlokalizowane opisy wartości dla parametru RouteTransitDetails
.
Zapis JSON |
---|
{ "arrivalTime": { object ( |
Pola | |
---|---|
arrivalTime |
Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową. |
departureTime |
Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową. |
LocalizedTime
Zlokalizowany opis czasu.
Zapis JSON |
---|
{
"time": {
object ( |
Pola | |
---|---|
time |
Czas podany jako ciąg znaków w danej strefie czasowej. |
timeZone |
Zawiera strefę czasową. Ta wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”. |
TransitLine
Zawiera informacje o linii transportu publicznego użytej w tym kroku.
Zapis JSON |
---|
{ "agencies": [ { object ( |
Pola | |
---|---|
agencies[] |
Przewoźnik (lub przewoźnika), który obsługuje tę linię transportu publicznego. |
name |
Pełna nazwa tej linii transportu publicznego, na przykład „ul. Lokalna 8”. |
uri |
identyfikator URI dla tej linii transportu publicznego podany przez przewoźnika. |
color |
Kolor często używany na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym. |
iconUri |
Identyfikator URI ikony powiązanej z tym wierszem. |
nameShort |
Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer wiersza, np. „M7” lub „355”. |
textColor |
Kolor często używany w tekście na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym. |
vehicle |
Typ pojazdu poruszającego się na tej linii transportu publicznego. |
TransitAgency
Przewoźnik, który obsługuje linię transportu publicznego.
Zapis JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Pola | |
---|---|
name |
Nazwa tego przewoźnika. |
phoneNumber |
Numer telefonu przewoźnika w zależności od regionu. |
uri |
Identyfikator URI przewoźnika. |
TransitVehicle
Informacje o pojeździe używanym na trasach transportu publicznego.
Zapis JSON |
---|
{ "name": { object ( |
Pola | |
---|---|
name |
Nazwa pojazdu pisana wielkimi literami. |
type |
Typ używanego pojazdu. |
iconUri |
Identyfikator URI ikony powiązanej z tym typem pojazdu. |
localIconUri |
Identyfikator URI ikony powiązanej z tym typem pojazdu na podstawie lokalnego znaku transportowego. |
TransitVehicleType
Rodzaj pojazdów na trasach transportu publicznego.
Wartości w polu enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Nieużywane. |
BUS |
Autobus. |
CABLE_CAR |
Pojazd na kablu, zazwyczaj znajdujący się na ziemi. Kolejki linowe mogą należeć do typu GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kolej podmiejska. |
FERRY |
Promem |
FUNICULAR |
Pojazd ciągnięty linią po stromym wzniesieniu. Kolejka linowa zwykle składa się z 2 samochodów, z których każdy stanowi przeciwwagę dla drugiego. |
GONDOLA_LIFT |
Kolejka linowa. |
HEAVY_RAIL |
Ciężka kolej. |
HIGH_SPEED_TRAIN |
Szybki pociąg. |
INTERCITY_BUS |
Autobus dalekobieżny. |
LONG_DISTANCE_TRAIN |
Pociąg dalekobieżny. |
METRO_RAIL |
Transport kolejowy. |
MONORAIL |
Kolej jednoszynowa. |
OTHER |
Pozostałe pojazdy. |
RAIL |
Kolej. |
SHARE_TAXI |
Taksówka zbiorowa to typ autobusu umożliwiający zaparkowanie i podwiezienie pasażerów w dowolnym miejscu na trasie. |
SUBWAY |
Podziemna kolejka. |
TRAM |
Kolej linowa naziemna. |
TROLLEYBUS |
Trolejbus. |
RouteLegTravelAdvisory
Zawiera dodatkowe informacje, o których należy poinformować użytkownika na danym etapie, np. możliwe ograniczenia w strefach ruchu.
Zapis JSON |
---|
{ "tollInfo": { object ( |
Pola | |
---|---|
tollInfo |
Zawiera informacje o opłatach na poszczególnych obszarach |
speedReadingIntervals[] |
Interwały odczytu określające gęstość ruchu. Ma zastosowanie w przypadku ustawień routingu Przykład:
|
RouteLegLocalizedValues
Reprezentacje tekstowe określonych właściwości.
Zapis JSON |
---|
{ "distance": { object ( |
Pola | |
---|---|
distance |
Długość podróży przedstawiona w formie tekstowej. |
duration |
Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie wysyłasz żądań informacji o ruchu, ta wartość będzie taka sama jak wartość staticDuration. |
staticDuration |
Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej. |
StepsOverview
Zawiera ogólne informacje o liście elementów RouteLegStep
.
Zapis JSON |
---|
{
"multiModalSegments": [
{
object ( |
Pola | |
---|---|
multiModalSegments[] |
Podsumowanie informacji o różnych multimodalnych segmentach elementu |
MultiModalSegment
Zawiera podsumowanie informacji o różnych multimodalnych segmentach interfejsu RouteLeg.steps
. Segment wielomodalny to co najmniej 1 przylegający do siebie segment RouteLegStep
, który ma taki sam parametr RouteTravelMode
. To pole nie jest wypełniane, jeśli RouteLeg
nie zawiera żadnych segmentów multimodalnych w krokach.
Zapis JSON |
---|
{ "navigationInstruction": { object ( |
Pola | |
---|---|
navigationInstruction |
Instrukcja nawigacji dla segmentu multimodalnego. |
travelMode |
Środek transportu segmentu multimodalnego. |
stepStartIndex |
Odpowiedni indeks |
stepEndIndex |
Odpowiedni indeks |
Widoczny obszar
Widoczny obszar o długości i szerokości geograficznej wyrażony jako 2 punkty po przekątnej naprzeciwko low
i high
. Widoczny obszar jest traktowany jako obszar zamknięty, czyli obejmuje swoją granicę. Granice szerokości geograficznej muszą się mieścić w przedziale od -90 do 90 stopni włącznie, a długość geograficzna – z zakresu od -180 do 180 stopni włącznie. Różne przypadki to m.in.:
Jeśli
low
=high
, widoczny obszar składa się z tego pojedynczego punktu.Jeśli
low.longitude
>high.longitude
, zakres długości geograficznej jest odwrócony (widoczny obszar przecina linię długości 180 stopni).Jeśli
low.longitude
= -180 stopni,high.longitude
= 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.Jeśli
low.longitude
= 180 stopni,high.longitude
= -180 stopni, zakres długości geograficznej jest pusty.Jeśli
low.latitude
>high.latitude
, zakres szerokości geograficznej jest pusty.
Musisz wypełnić zarówno pole low
, jak i high
, a pole reprezentowane nie może być puste (zgodnie z definicjami powyżej). Jeśli widoczny obszar jest pusty, wystąpi błąd.
Na przykład ten widoczny obszar w pełni obejmuje Nowy Jork:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Zapis JSON |
---|
{ "low": { object ( |
Pola | |
---|---|
low |
To pole jest wymagane. Najniższa pozycja widocznego obszaru. |
high |
To pole jest wymagane. Najwyższy punkt widocznego obszaru. |
RouteLocalizedValues
Reprezentacje tekstowe określonych właściwości.
Zapis JSON |
---|
{ "distance": { object ( |
Pola | |
---|---|
distance |
Długość podróży przedstawiona w formie tekstowej. |
duration |
Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie prosiłeś o informacje o natężeniu ruchu, ta wartość będzie taka sama jak wartość |
staticDuration |
Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej. |
transitFare |
Opłata za transport w formie tekstowej. |
GeocodingResults
Zawiera
dla punktów początkowych, docelowych i pośrednich. Pole wypełnione tylko w przypadku punktów na trasie.GeocodedWaypoints
Zapis JSON |
---|
{ "origin": { object ( |
Pola | |
---|---|
origin |
Geokodowany punkt na trasie początkowy. |
destination |
Geokodowany punkt na trasie docelowy. |
intermediates[] |
Lista pośrednich geokodowanych punktów pośrednich, z których każdy zawiera pole indeksu odpowiadające zerowej pozycji punktu pośredniego w kolejności, w jakiej zostały one określone w żądaniu. |
GeocodedWaypoint
Szczegółowe informacje o lokalizacjach używanych jako punkty na trasie. Pole wypełnione tylko w przypadku punktów na trasie. Zawiera szczegółowe informacje dotyczące wyników geokodowania na potrzeby określania, na co adres został zakodowany geokod.
Zapis JSON |
---|
{
"geocoderStatus": {
object ( |
Pola | |
---|---|
geocoderStatus |
Wskazuje kod stanu wynikający z operacji geokodowania. |
type[] |
Typy wyniku w postaci 0 lub większej liczby tagów typu. Obsługiwane typy: typy adresów i typy komponentów adresu. |
partialMatch |
Wskazuje, że geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, chociaż udało mu się dopasować część żądanego adresu. Warto sprawdzić pierwotne żądanie pod kątem błędów z błędami lub niekompletnego adresu. |
placeId |
Identyfikator miejsca powiązany z tym wynikiem. |
intermediateWaypointRequestIndex |
Indeks odpowiedniego pośredniego punktu pośredniego w żądaniu. Pole wypełnione tylko wtedy, gdy odpowiedni punkt na trasie jest pośrednim punktem na trasie. |