Method: computeRoutes

Zwraca trasę główną wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu punktów końcowych i pośrednich.

UWAGA: ta metoda wymaga określenia maski pola odpowiedzi w danych wejściowych. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask (zobacz dostępne parametry adresu URL i nagłówki). Wartość to lista ścieżek pól rozdzielona przecinkami. Zapoznaj się ze szczegółową dokumentacją na temat tworzenia ścieżek pól.

Na przykład w tej metodzie:

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

Google odradza używanie maski pola odpowiedzi z symbolem wieloznacznym (*) lub określanie maski pola na najwyższym poziomie (routes), ponieważ:

  • Wybór tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, co pozwala nam zwracać wyniki z mniejszym opóźnieniem.
  • Wybieranie tylko tych pól, których potrzebujesz w zadaniu produkcyjnym, zapewnia stabilne opóźnienie. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać dodatkowego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może dojść do spadku wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje, że odpowiedź jest mniejsza, a tym samym przepustowość sieci jest większa.

Żą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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Pola
origin

object (Waypoint)

Wymagane. Punkt na trasie będący punktem początkowym.

destination

object (Waypoint)

Wymagane. Punkt na trasie miejsca docelowego.

intermediates[]

object (Waypoint)

Opcjonalnie: Zestaw punktów pośrednich na trasie (z wyjątkiem punktów końcowych), w których można się zatrzymać lub które można minąć. Obsługiwanych jest maksymalnie 25 punktów pośrednich.

travelMode

enum (RouteTravelMode)

Opcjonalnie: Określa środek transportu.

routingPreference

enum (RoutingPreference)

Opcjonalnie: Określa sposób obliczania trasy. Serwer próbuje obliczyć trasę, korzystając z wybranego ustawienia trasy. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy travelMode ma wartość DRIVE lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.

polylineQuality

enum (PolylineQuality)

Opcjonalnie: Określa preferencje dotyczące jakości linii łamanej.

polylineEncoding

enum (PolylineEncoding)

Opcjonalnie: Określa preferowane kodowanie linii łamanej.

departureTime

string (Timestamp format)

Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyty czas wysłania żądania. UWAGA: możesz określić departureTime w przeszłości tylko wtedy, gdy RouteTravelMode ma wartość TRANSIT. Przejazdy transportem publicznym są dostępne przez maksymalnie 7 dni wstecz lub 100 dni do przodu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

arrivalTime

string (Timestamp format)

Opcjonalnie: godzinę przyjazdu, UWAGA: to pole jest ignorowane, gdy żądania określają RouteTravelMode inny niż TRANSIT. Możesz podać departureTime lub arrivalTime, ale nie obie te wartości. Przejazdy transportem publicznym są dostępne przez maksymalnie 7 dni wstecz lub 100 dni do przodu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

computeAlternativeRoutes

boolean

Opcjonalnie: Określa, czy oprócz trasy mają być obliczane trasy alternatywne. W przypadku żądań, które zawierają pośrednie punkty orientacyjne, nie są zwracane żadne trasy alternatywne.

routeModifiers

object (RouteModifiers)

Opcjonalnie: Zestaw warunków, które należy spełnić, wpływających na sposób obliczania tras.

languageCode

string

Opcjonalnie: Kod języka w standardzie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator języka 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

string

Opcjonalnie: Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu.

units

enum (Units)

Opcjonalnie: Określa jednostki miary dla pól wyświetlania. Te pola obejmują pole instruction w NavigationInstruction. Ta wartość nie ma wpływu na jednostki miary używane do określania odległości i czasu trwania trasy, odcinka i kroku. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną określone na podstawie lokalizacji pierwszego punktu początkowego.

optimizeWaypointOrder

boolean

Opcjonalnie: Jeśli zasada ma wartość Prawda, usługa próbuje zminimalizować ogólny koszt trasy, zmieniając kolejność określonych punktów pośrednich. Żądanie nie powiedzie się, jeśli którykolwiek z punktów pośrednich jest punktem via. Użyj ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index, aby znaleźć nową kolejność. Jeśli w nagłówku X-Goog-FieldMask nie ma żądania ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index, żądanie się nie powiedzie. Jeśli zasada optimizeWaypointOrder ma wartość Fałsz, zasada ComputeRoutesResponse.optimized_intermediate_waypoint_index jest pusta.

requestedReferenceRoutes[]

enum (ReferenceRoute)

Opcjonalnie: Określa, jakie trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa, która ma inny cel obliczania trasy niż trasa domyślna. Na przykład obliczanie trasy referencyjnej FUEL_EFFICIENT uwzględnia różne parametry, które pozwalają wygenerować optymalną trasę z najniższym spalaniem. Podczas korzystania z tej funkcji szukaj ikony routeLabels na trasach.

extraComputations[]

enum (ExtraComputation)

Opcjonalnie: Lista dodatkowych obliczeń, które mogą być użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w masce pola, aby zostały zwrócone w odpowiedzi.

trafficModel

enum (TrafficModel)

Opcjonalnie: Określa założenia, które mają być używane podczas obliczania czasu w ruchu ulicznym. To ustawienie wpływa na wartość zwracaną w polu czasu trwania w Route i RouteLeg, które zawiera przewidywany czas w ruchu ulicznym na podstawie średnich historycznych. Parametr TrafficModel jest dostępny tylko w przypadku żądań, w których parametr RoutingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr RouteTravelMode ma wartość DRIVE. Jeśli żądane są informacje o natężeniu ruchu, a parametr TrafficModel nie jest określony, domyślnie przyjmuje się wartość BEST_GUESS.

transitPreferences

object (TransitPreferences)

Opcjonalnie: Określa preferencje, które wpływają na trasę zwracaną w przypadku tras TRANSIT. UWAGA: parametr transitPreferences możesz określić tylko wtedy, gdy parametr RouteTravelMode ma wartość TRANSIT.

Treść odpowiedzi

v2.computeRoutes – komunikat odpowiedzi.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Pola
routes[]

object (Route)

Zawiera tablicę obliczonych tras (maksymalnie 3), jeśli określisz compute_alternatives_routes, lub tylko 1 trasę, jeśli tego nie zrobisz. Jeśli ta tablica zawiera wiele wpisów, pierwszy z nich jest najbardziej zalecaną trasą. Jeśli tablica jest pusta, oznacza to, że nie udało się znaleźć żadnej trasy.

fallbackInfo

object (FallbackInfo)

W niektórych przypadkach, gdy serwer nie może obliczyć wyników trasy ze wszystkimi preferencjami wejściowymi, może użyć innego sposobu obliczania. Gdy używany jest tryb zastępczy, to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W przeciwnym razie to pole nie jest ustawione.

geocodingResults

object (GeocodingResults)

Zawiera informacje o odpowiedzi geokodowania dla punktów pośrednich określonych jako adresy.

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 ł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, co zwiększa rozmiar 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 podczas wyświetlania podsumowania trasy. Użycie tej opcji wiąże się z krótszym czasem oczekiwania na żądanie w porównaniu z opcją HIGH_QUALITY.

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 dotyczących typu linii łamanej. Domyślna wartość to ENCODED_POLYLINE.
ENCODED_POLYLINE Określa linię łamaną zakodowaną za pomocą algorytmu kodowania linii łamanych.
GEO_JSON_LINESTRING Określa linię łamaną w formacie GeoJSON LineString.

ReferenceRoute

Obsługiwana trasa referencyjna w ComputeRoutesRequest.

Wartości w polu enum
REFERENCE_ROUTE_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość nie zostaną zrealizowane.
FUEL_EFFICIENT Trasa z najniższym spalaniem.
SHORTER_DISTANCE

Trasa z krótszym czasem podróży. To funkcja eksperymentalna.

W przypadku żądań DRIVE ta funkcja traktuje priorytetowo krótszą odległość, a nie komfort jazdy. Może na przykład preferować drogi lokalne zamiast autostrad, wybierać drogi gruntowe, przejeżdżać przez parkingi itp. Ta funkcja nie zwraca żadnych manewrów, które według Map Google są nielegalne.

W przypadku żądań BICYCLE i TWO_WHEELER ta funkcja zwraca trasy podobne do tych, które są zwracane, gdy nie określisz requestedReferenceRoutes.

Ta funkcja nie jest zgodna z innymi środkami transportu, punktami pośrednimi ani z optimizeWaypointOrder. Takie żądania nie będą działać. Możesz jednak używać go z dowolnym urządzeniem routingPreference.

ExtraComputation

Dodatkowe obliczenia do wykonania podczas realizacji żądania. W przyszłości mogą zostać dodane kolejne wartości.

Wartości w polu enum
EXTRA_COMPUTATION_UNSPECIFIED Nieużywane. Żądania zawierające tę wartość będą kończyć się niepowodzeniem.
TOLLS Informacje o opłatach za przejazd na trasach.
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasach.
TRAFFIC_ON_POLYLINE linie łamane tras z uwzględnieniem natężenia ruchu,
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction przedstawiony jako sformatowany ciąg tekstowy HTML. Te treści są przeznaczone do odczytu w takiej postaci, w jakiej są. Są one przeznaczone tylko do wyświetlania. Nie analizuj go automatycznie.
FLYOVER_INFO_ON_POLYLINE Informacje o wiaduktach na trasach. Aby zwrócić te informacje, musisz określić maskę pola routes.polyline_details.flyover_info. Te dane będą obecnie wypełniane tylko w przypadku niektórych obszarów miejskich w Indiach. Ta funkcja jest eksperymentalna, a SKU i opłata mogą ulec zmianie.
NARROW_ROAD_INFO_ON_POLYLINE Informacje o wąskich drogach na trasach. Aby zwrócić te informacje, musisz określić maskę pola routes.polyline_details.narrow_road_info. Te dane będą obecnie wypełniane tylko w przypadku niektórych obszarów miejskich w Indiach. Ta funkcja jest eksperymentalna, a SKU i opłata mogą ulec zmianie.
TUNNEL_INFO_ON_POLYLINE Informacje o tunelu na trasie. Aby zwrócić te informacje, musisz określić maskę pola routes.polyline_details.tunnel_info.
BRIDGE_INFO_ON_POLYLINE Informacje o mostach na trasach. Aby zwrócić te informacje, musisz określić maskę pola routes.polyline_details.bridge_info.
SKYWAY_INFO_ON_POLYLINE Informacje o łącznikach na trasach. Aby zwrócić te informacje, musisz określić maskę pola routes.polyline_details.skyway_info.

Trasa

Zawiera trasę, która składa się z serii połączonych odcinków drogi łączących początkowe, końcowe i pośrednie punkty orientacyjne.

Zapis JSON
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Pola
routeLabels[]

enum (RouteLabel)

Etykiety Route, które są przydatne do identyfikowania konkretnych właściwości trasy w celu porównania ich z innymi.

legs[]

object (RouteLeg)

Zbiór etapów (segmentów ścieżki między punktami pośrednimi), które składają się na trasę. Każdy etap odpowiada podróży między 2 Waypoints, które nie są via. Na przykład trasa bez punktów pośrednich ma tylko jeden etap. Trasa, która obejmuje jeden punkt pośredni inny niż via, ma 2 odcinki. Trasa, która zawiera 1 via punkt pośredni, ma 1 etap. Kolejność etapów odpowiada kolejności punktów orientacyjnych od origin do intermediates i destination.

distanceMeters

integer

Odległość do pokonania na trasie w metrach.

duration

string (Duration format)

czas potrzebny na pokonanie trasy. Jeśli ustawisz parametr routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak staticDuration. Jeśli ustawisz parametr routingPreference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość będzie obliczana z uwzględnieniem warunków na drodze.

Gdy parametr routingPreference jest ustawiony na TRAFFIC_AWARE_OPTIMAL, czas trwania jest obliczany na podstawie prędkości pojazdów osobowych lub ciężarówek (dłuższy czas trwania). Prędkości ciężarówek są używane, jeśli spełniony jest jeden z tych warunków:

We wszystkich innych przypadkach używane są prędkości pojazdów osobowych, nawet jeśli w parametrze vehicleInfo podano inne wymiary lub wagę pojazdu.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

staticDuration

string (Duration format)

Czas podróży trasą bez uwzględniania warunków na drodze.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

polyline

object (Polyline)

Linia łamana całej trasy. Ta linia łamana jest połączoną linią łamaną wszystkich legs.

description

string

Opis trasy.

warnings[]

string

Tablica ostrzeżeń, które mają się wyświetlać podczas wyświetlania trasy.

viewport

object (Viewport)

Ramka ograniczająca widoczny obszar linii łamanej.

travelAdvisory

object (RouteTravelAdvisory)

Dodatkowe informacje o trasie.

optimizedIntermediateWaypointIndex[]

integer

Jeśli ustawisz parametr optimizeWaypointOrder na wartość „true”, to pole będzie zawierać zoptymalizowaną kolejność pośrednich punktów orientacyjnych. W przeciwnym razie to pole jest puste. Jeśli na przykład podasz dane wejściowe Miejsce wyjazdu: LA; Pośrednie punkty pośrednie: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork; a zoptymalizowana kolejność pośrednich punktów pośrednich to Phoenix, Dallas, Bangor, to pole będzie zawierać wartości [2, 0, 1]. Indeks zaczyna się od 0 dla pierwszego pośredniego punktu pośredniego podanego w danych wejściowych.

localizedValues

object (RouteLocalizedValues)

Tekstowe reprezentacje właściwości Route.

routeToken

string

Nieprzezroczysty token, który można przekazać do Navigation SDK, aby odtworzyć trasę podczas nawigacji, a w przypadku zmiany trasy zachować pierwotny zamiar podczas tworzenia trasy. Traktuj ten token jako nieprzezroczysty obiekt blob. Nie porównuj jej wartości w różnych żądaniach, ponieważ może się ona zmienić, nawet jeśli usługa zwróci dokładnie tę samą trasę.

UWAGA: Route.route_token jest dostępny tylko w przypadku żądań, w których parametr ComputeRoutesRequest.routing_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Route.route_token nie jest obsługiwany w przypadku żądań, które zawierają punkty pośrednie.

polylineDetails

object (PolylineDetails)

Zawiera informacje o szczegółach wzdłuż linii łamanej.

RouteLabel

Etykiety Route, które są przydatne do identyfikowania konkretnych właściwości trasy w celu porównania ich z innymi.

Wartości w polu enum
ROUTE_LABEL_UNSPECIFIED Domyślne – nieużywane.
DEFAULT_ROUTE Domyślna „najlepsza” trasa zwrócona na potrzeby obliczania trasy.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnej „najlepszej” trasy. Trasy takie jak ta będą zwracane, gdy określono computeAlternativeRoutes.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Trasy oznaczone tą wartością są zoptymalizowane pod kątem parametrów ekologicznych, takich jak zużycie paliwa.
SHORTER_DISTANCE Trasa o krótszym dystansie. To funkcja eksperymentalna.

RouteLeg

zawiera segment między punktami orientacyjnymi, które nie są punktami via.

Zapis JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Pola
distanceMeters

integer

Odległość do przebycia na danym odcinku trasy w metrach.

duration

string (Duration format)

Czas potrzebny na pokonanie odcinka. Jeśli parametr routingPreference ma wartość TRAFFIC_UNAWARE, ta wartość jest taka sama jak staticDuration. Jeśli routingPreference to TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków na drodze.

Gdy parametr routingPreference jest ustawiony na TRAFFIC_AWARE_OPTIMAL, czas trwania jest obliczany na podstawie prędkości pojazdów osobowych lub ciężarówek (dłuższy czas trwania). Prędkości ciężarówek są używane, jeśli spełniony jest jeden z tych warunków:

We wszystkich innych przypadkach używane są prędkości pojazdów osobowych, nawet jeśli w parametrze vehicleInfo podano inne wymiary lub wagę pojazdu.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

staticDuration

string (Duration format)

Czas podróży na danym etapie, obliczony bez uwzględnienia warunków na drodze.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

polyline

object (Polyline)

Ogólna linia łamana dla tego etapu, która obejmuje linię łamaną każdego elementu step.

startLocation

object (Location)

Lokalizacja początkowa tego odcinka. Ta lokalizacja może się różnić od podanej: origin. Jeśli na przykład podany parametr origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.

endLocation

object (Location)

Lokalizacja końcowa tego etapu. Ta lokalizacja może się różnić od podanej: destination. Jeśli na przykład podany parametr destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.

steps[]

object (RouteLegStep)

Tablica kroków oznaczających segmenty w ramach tego etapu. Każdy krok reprezentuje jedną instrukcję nawigacji.

travelAdvisory

object (RouteLegTravelAdvisory)

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. o możliwych ograniczeniach dotyczących stref ruchu na danym odcinku trasy.

localizedValues

object (RouteLegLocalizedValues)

Tekstowe reprezentacje właściwości RouteLeg.

stepsOverview

object (StepsOverview)

Informacje ogólne o krokach w tym: RouteLeg. To pole jest wypełniane tylko w przypadku tras TRANSIT.

Linia łamana

Obejmuje zakodowaną linię łamaną.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
Pola
Określa typ linii łamanej. Domyślna wartość to encoded_polyline. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
encodedPolyline

string

Ciąg znaków kodujący linię łamaną za pomocą algorytmu kodowania linii łamanej.

geoJsonLinestring

object (Struct format)

Określa linię łamaną w formacie GeoJSON LineString.

Koniec pól wykluczających się wzajemnie.

RouteLegStep

Zawiera segment: RouteLeg. Krok odpowiada pojedynczej instrukcji nawigacji. Odcinki trasy składają się z kroków.

Zapis JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Pola
distanceMeters

integer

Odległość do pokonania na tym etapie w metrach. W niektórych przypadkach to pole może nie mieć wartości.

staticDuration

string (Duration format)

Czas trwania podróży na tym etapie bez uwzględnienia warunków na drodze. W niektórych przypadkach to pole może nie mieć wartości.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

polyline

object (Polyline)

Łamana powiązana z tym krokiem.

startLocation

object (Location)

Lokalizacja początkowa tego kroku.

endLocation

object (Location)

Lokalizacja końcowa tego kroku.

navigationInstruction

object (NavigationInstruction)

powiadomienia nawigacji,

travelAdvisory

object (RouteLegStepTravelAdvisory)

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. o możliwych ograniczeniach strefy ruchu na danym etapie trasy.

localizedValues

object (RouteLegStepLocalizedValues)

Tekstowe reprezentacje właściwości RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Szczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT.

travelMode

enum (RouteTravelMode)

Tryb podróży używany na tym etapie.

Manewr

Zestaw wartości, które określają działanie nawigacyjne do wykonania w bieżącym kroku (np. skręć w lewo, zjedź lub jedź prosto).

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 Skieruj się na wjazd po lewej.
RAMP_RIGHT Skieruj się na wjazd po prawej.
MERGE Włącz się do ruchu.
FORK_LEFT Skręć w lewo na rozwidleniu.
FORK_RIGHT Skręć w prawo na rozwidleniu.
FERRY Popłyń promem.
FERRY_TRAIN Wsiądź do pociągu, który wjeżdża na prom.
ROUNDABOUT_LEFT Na rondzie skręć w lewo.
ROUNDABOUT_RIGHT Na rondzie skręć w prawo.
DEPART Początkowy manewr.
NAME_CHANGE Służy do wskazywania zmiany nazwy ulicy.
DESTINATION Służy do wskazywania przybycia do miejsca docelowego.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. o możliwych ograniczeniach strefy ruchu na danym etapie trasy.

Zapis JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Pola
speedReadingIntervals[]

object (SpeedReadingInterval)

UWAGA: to pole nie jest obecnie wypełnione.

RouteLegStepLocalizedValues

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

Zapis JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Pola
distance

object (LocalizedText)

Odległość podróży w formie tekstowej.

staticDuration

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, przedstawiony w formie tekstowej.

RouteLegStepTransitDetails

Dodatkowe informacje o RouteLegStep dotyczące tras TRANSIT.

Zapis JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Pola
stopDetails

object (TransitStopDetails)

Informacje o przystankach przyjazdu i odjazdu na danym etapie.

localizedValues

object (TransitDetailsLocalizedValues)

Tekstowe reprezentacje właściwości RouteLegStepTransitDetails.

headsign

string

Określa kierunek jazdy na tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku początkowym. Kierunek jest często stacją końcową.

headway

string (Duration format)

Określa oczekiwany czas jako czas między odjazdami z tego samego przystanku w tym czasie. Jeśli na przykład wartość częstotliwości wynosi 600, oznacza to, że jeśli ucieknie Ci autobus, będziesz czekać 10 minut.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

transitLine

object (TransitLine)

Informacje o linii transportu publicznego używanej na tym etapie.

stopCount

integer

Liczba przystanków od przystanku początkowego do końcowego. Ta liczba obejmuje przystanek docelowy, ale nie obejmuje przystanku początkowego. Jeśli na przykład trasa zaczyna się na przystanku A, przechodzi przez przystanki B i C, a kończy się na przystanku D, funkcja stopCount zwraca wartość 3.

tripShortText

string

Tekst, który pojawia się w rozkładach jazdy i na tablicach informacyjnych, aby ułatwić pasażerom identyfikację przejazdu transportem publicznym. Tekst powinien jednoznacznie identyfikować przejazd w ciągu dnia obsługi. Na przykład „538” to tripShortText pociągu Amtrak, który w dni powszednie odjeżdża z San Jose w Kalifornii o 15:10 do Sacramento w Kalifornii.

TransitStopDetails

Szczegóły dotyczące przystanków transportu publicznego dla: RouteLegStep.

Zapis JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Pola
arrivalStop

object (TransitStop)

Informacje o przystanku docelowym dla danego kroku.

arrivalTime

string (Timestamp format)

Szacowany czas dotarcia na miejsce w przypadku danego kroku.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

departureStop

object (TransitStop)

Informacje o przystanku początkowym dla danego kroku.

departureTime

string (Timestamp format)

Szacowany czas odjazdu dla kroku.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

TransitStop

Informacje o przystanku transportu publicznego.

Zapis JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
Pola
name

string

Nazwa przystanku.

location

object (Location)

Lokalizacja przystanku wyrażona we współrzędnych szerokości i długości geograficznej.

TransitDetailsLocalizedValues

Zlokalizowane opisy wartości dla: RouteTransitDetails.

Zapis JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Pola
arrivalTime

object (LocalizedTime)

Czas w sformatowanej reprezentacji tekstowej z odpowiednią strefą czasową.

departureTime

object (LocalizedTime)

Czas w sformatowanej reprezentacji tekstowej z odpowiednią strefą czasową.

LocalizedTime

Zlokalizowany opis czasu.

Zapis JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Pola
time

object (LocalizedText)

Czas określony jako ciąg znaków w danej strefie czasowej.

timeZone

string

Zawiera strefę czasową. Wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”.

TransitLine

Zawiera informacje o linii transportu publicznego używanej na tym etapie.

Zapis JSON
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Pola
agencies[]

object (TransitAgency)

Przewoźnik (lub przewoźnicy) obsługujący tę linię transportu publicznego.

name

string

Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”.

uri

string

identyfikator URI tej linii transportu publicznego podany przez przewoźnika.

color

string

Kolor powszechnie używany w oznakowaniu tej linii. Reprezentowany w formacie szesnastkowym.

iconUri

string

Identyfikator URI ikony powiązanej z tą linią.

nameShort

string

Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer linii, np. „M7” lub „355”.

textColor

string

Kolor często używany w tekście na znakach dotyczących tej linii. Reprezentowany w formacie szesnastkowym.

vehicle

object (TransitVehicle)

Typ pojazdu, który obsługuje tę linię transportu publicznego.

TransitAgency

Przewoźnik, który obsługuje linię transportu publicznego.

Zapis JSON
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Pola
name

string

Nazwa przewoźnika.

phoneNumber

string

Numer telefonu przewoźnika w formacie międzynarodowym.

uri

string

Identyfikator URI przewoźnika.

TransitVehicle

Informacje o pojeździe używanym na trasach transportu publicznego.

Zapis JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Pola
name

object (LocalizedText)

Nazwa tego pojazdu, pisana wielkimi literami.

type

enum (TransitVehicleType)

rodzaj użytego pojazdu;

iconUri

string

Identyfikator URI ikony powiązanej z tym typem pojazdu.

localIconUri

string

Identyfikator URI ikony powiązanej z tym typem pojazdu, na podstawie lokalnych znaków transportowych.

TransitVehicleType

Typ pojazdów na trasach transportu publicznego.

Wartości w polu enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nieużywane.
BUS Autobus.
CABLE_CAR Pojazd poruszający się po linie, zwykle na ziemi. Kolejki linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Prom.
FUNICULAR Pojazd wciągany po stromym zboczu za pomocą liny. Kolejka linowo-terenowa składa się zwykle z 2 wagoników, z których każdy działa jako przeciwwaga dla drugiego.
GONDOLA_LIFT Kolejka linowa.
HEAVY_RAIL Kolej naziemna.
HIGH_SPEED_TRAIN Pociąg szybkobieżny.
INTERCITY_BUS Autobus dalekobieżny.
LONG_DISTANCE_TRAIN Kolej dalekobieżna.
METRO_RAIL Kolej miejska.
MONORAIL Kolej jednoszynowa.
OTHER Wszystkie inne pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka zbiorowa to rodzaj autobusu, który może wysadzać i zabierać pasażerów w dowolnym miejscu na trasie.
SUBWAY Podziemna kolej miejska.
TRAM Naziemna kolej miejska.
TROLLEYBUS Trolejbus.

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany na danym etapie, np. o możliwych ograniczeniach w strefie ruchu.

Zapis JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Pola
tollInfo

object (TollInfo)

Zawiera informacje o opłatach na konkretnej trasie RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd na trasie RouteLeg, a wartość TOLLS jest uwzględniona w parametrze ComputeRoutesRequest.extra_computations żądania. Jeśli to pole jest ustawione, ale pole podrzędne estimatedPrice nie jest wypełnione, zakładamy, że droga jest płatna, ale nie znamy szacunkowej ceny. Jeśli nie ma elementu tollInfo, na drodze RouteLeg nie ma opłat.

speedReadingIntervals[]

object (SpeedReadingInterval)

Przedziały prędkości wskazujące natężenie ruchu. To pole jest wypełniane tylko w przypadku żądań, które mają wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, a TRAFFIC_ON_POLYLINE jest uwzględniony w ComputeRoutesRequest.extra_computations. Przedziały obejmują całą polilinię RouteLeg bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:

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

RouteLegLocalizedValues

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

Zapis JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Pola
distance

object (LocalizedText)

Odległość podróży w formie tekstowej.

duration

object (LocalizedText)

Czas trwania w formie tekstowej, zlokalizowany zgodnie z regionem zapytania. uwzględnia warunki na drodze; Uwaga: jeśli nie poprosisz o informacje o natężeniu ruchu, ta wartość będzie taka sama jak staticDuration.

staticDuration

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, przedstawiony w formie tekstowej.

StepsOverview

Zawiera ogólne informacje o liście RouteLegStep.

Zapis JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Pola
multiModalSegments[]

object (MultiModalSegment)

Podsumowanie informacji o różnych segmentach multimodalnych RouteLeg.steps. To pole nie jest wypełniane, jeśli RouteLeg nie zawiera żadnych segmentów multimodalnych w krokach.

MultiModalSegment

Zawiera podsumowanie informacji o różnych segmentach multimodalnych RouteLeg.steps. Segment multimodalny to co najmniej 1 przylegający element RouteLegStep, który ma ten sam element RouteTravelMode. To pole nie jest wypełniane, jeśli RouteLeg nie zawiera żadnych segmentów multimodalnych w krokach.

Zapis JSON
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Pola
navigationInstruction

object (NavigationInstruction)

NavigationInstruction dla segmentu multimodalnego.

travelMode

enum (RouteTravelMode)

Środek transportu w segmencie multimodalnym.

stepStartIndex

integer

Odpowiedni indeks RouteLegStep, który jest początkiem segmentu multimodalnego.

stepEndIndex

integer

Odpowiedni indeks RouteLegStep, który jest końcem segmentu multimodalnego.

Widoczny obszar

Widoczny obszar szerokości i długości geograficznej, reprezentowany przez 2 punkty low i high położone po przekątnej. Okno jest traktowane jako zamknięty obszar, tzn. obejmuje swoje granice. Szerokość geograficzna musi mieścić się w zakresie od -90 do 90 stopni, a długość geograficzna – od -180 do 180 stopni. Przykłady:

  • 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 przekracza linię długości geograficznej 180 stopni).

  • Jeśli low.longitude = –180 stopni, a high.longitude = 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.

  • Jeśli low.longitude = 180 stopni, a high.longitude = –180 stopni, zakres długości geograficznej jest pusty.

  • Jeśli low.latitude > high.latitude, zakres szerokości geograficznej jest pusty.

Wartości low i high muszą być podane, a reprezentowane pole nie może być puste (zgodnie z powyższymi definicjami). Pusty widoczny obszar spowoduje błąd.

Na przykład ten widoczny obszar obejmuje cały Nowy Jork:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Zapis JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Pola
low

object (LatLng)

Wymagane. Najniższy punkt widocznego obszaru.

high

object (LatLng)

Wymagane. Najwyższy punkt widocznego obszaru.

RouteLocalizedValues

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

Zapis JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Pola
distance

object (LocalizedText)

Odległość podróży w formie tekstowej.

duration

object (LocalizedText)

Czas trwania w formie tekstowej, zlokalizowany zgodnie z regionem zapytania. uwzględnia warunki na drodze; Uwaga: jeśli nie poprosisz o informacje o natężeniu ruchu, ta wartość będzie taka sama jak staticDuration.

staticDuration

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, przedstawiony w formie tekstowej.

transitFare

object (LocalizedText)

Opłata za przejazd przedstawiona w formie tekstowej.

PolylineDetails

Szczegóły odpowiadające danemu indeksowi lub ciągłemu segmentowi linii łamanej. W przypadku linii łamanej z punktami P_0, P_1, ... , P_N (indeks od zera) PolylineDetails definiuje interwał i powiązane metadane.

Zapis JSON
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
Pola
tunnelInfo[]

object (TunnelInfo)

Szczegóły tunelu wzdłuż linii łamanej. To pole jest wypełniane, jeśli żądanie określa modyfikator trasy avoidTunnels, a wynikowa trasa nie pozwala ich uniknąć, LUB jeśli w extraComputations określono TUNNEL_INFO_ON_POLYLINE, a trasa zawiera tunele.

restrictionInfo[]

object (RestrictionInfo)

Szczegóły ograniczenia wzdłuż linii łamanej. To pole jest wypełniane tylko wtedy, gdy żądanie zawiera modyfikator trasy vehicleInfo, a wynikowa trasa zawiera odpowiednie ograniczenie. W przeciwnym razie to pole nie jest używane.

flyoverInfo[]

object (FlyoverInfo)

Szczegóły przelotu wzdłuż linii łamanej.

narrowRoadInfo[]

object (NarrowRoadInfo)

Szczegóły wąskiej drogi wzdłuż linii łamanej.

bridgeInfo[]

object (BridgeInfo)

Szczegóły mostu wzdłuż linii łamanej.

skywayInfo[]

object (SkywayInfo)

Szczegóły dotyczące kładki wzdłuż linii łamanej.

TunnelInfo

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

Zapis JSON
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Pola
tunnelPresence

enum (RoadFeatureState)

Wskazuje, czy na danym odcinku linii łamanej znajduje się tunel.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji o tunelu wzdłuż linii łamanej.

RoadFeatureState

Zawiera stany obiektów na drodze wzdłuż odcinka linii łamanej.

Wartości w polu enum
ROAD_FEATURE_STATE_UNSPECIFIED Stan obiektu drogowego nie został obliczony (wartość domyślna).
EXISTS Obiekt na drodze istnieje.
DOES_NOT_EXIST Droga nie istnieje.

PolylinePointIndex

Zawiera indeksy początkowy i końcowy szczegółów linii łamanej. W przypadkach, gdy dane odpowiadają pojedynczemu punktowi, wartości startIndex i endIndex będą równe.

Zapis JSON
{
  "startIndex": integer,
  "endIndex": integer
}
Pola
startIndex

integer

Indeks początkowy tego szczegółu w linii łamanej.

endIndex

integer

Indeks końcowy tego szczegółu w linii łamanej.

RestrictionInfo

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

Zapis JSON
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
Pola
restrictionPresence

enum (RoadFeatureState)

Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej obowiązuje ograniczenie.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji związanych z ograniczeniami wzdłuż linii łamanej.

Zawiera typy ograniczeń, które mogą dotyczyć danego odcinka linii łamanej. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
restrictedHeightMm

string (int64 format)

Limit wysokości w milimetrach. To pole jest wypełniane, gdy ograniczona wysokość uniemożliwia przejazd lub powoduje niski prześwit dla określonego pojazdu.

restrictedWeightKg

string (int64 format)

Limit wagi w kilogramach. To pole jest wypełniane, gdy ograniczenie wagi uniemożliwia przejazd lub jest zbliżone do wagi określonego pojazdu.

hazardousGoods

boolean

To pole ma wartość „true”, gdy transport towarów niebezpiecznych jest ograniczony.

trucksProhibited

boolean

To pole ma wartość „true”, gdy ciężarówki są zabronione.

Koniec pól wykluczających się wzajemnie.

FlyoverInfo

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

Zapis JSON
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Pola
flyoverPresence

enum (RoadFeatureState)

Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej znajduje się wiadukt.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji związanych z przelotem wzdłuż linii łamanej.

NarrowRoadInfo

Zawiera informacje o wąskich drogach wzdłuż linii łamanej.

Zapis JSON
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Pola
narrowRoadPresence

enum (RoadFeatureState)

Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej występuje wąska droga.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji o wąskiej drodze wzdłuż linii łamanej.

BridgeInfo

Zawiera informacje o mostach na linii łamanej.

Zapis JSON
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Pola
bridgePresence

enum (RoadFeatureState)

Wskazuje, czy na danym odcinku linii łamanej znajduje się most.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji o mostach na linii łamanej.

SkywayInfo

Zawiera informacje o łącznikach wzdłuż linii łamanej.

Zapis JSON
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Pola
skywayPresence

enum (RoadFeatureState)

Wskazuje, czy na danym odcinku linii łamanej znajduje się kładka.

polylinePointIndex

object (PolylinePointIndex)

Lokalizacja informacji o łączniku wzdłuż linii łamanej.

GeocodingResults

Zawiera GeocodedWaypoints dla punktu początkowego, miejsca docelowego i punktów pośrednich. Wypełniane tylko w przypadku punktów orientacyjnych adresu.

Zapis JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Pola
origin

object (GeocodedWaypoint)

Punkt na trasie z geokodowaniem miejsca rozpoczęcia.

destination

object (GeocodedWaypoint)

Punkt na trasie z geokodowaniem miejsca docelowego.

intermediates[]

object (GeocodedWaypoint)

Lista pośrednich punktów pośrednich z kodem geograficznym, z których każdy zawiera pole indeksu odpowiadające pozycji punktu pośredniego liczonej od zera w kolejności, w jakiej zostały określone w żądaniu.

GeocodedWaypoint

Szczegóły dotyczące lokalizacji używanych jako punkty orientacyjne. Wypełniane tylko w przypadku punktów orientacyjnych adresu. Zawiera szczegółowe informacje o wynikach geokodowania, które pozwalają określić, do czego został przypisany dany adres.

Zapis JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Pola
geocoderStatus

object (Status)

Wskazuje kod stanu wynikający z operacji geokodowania.

type[]

string

Typy wyniku w postaci co najmniej 1 tagu typu. Obsługiwane typy: typy adresów i typy komponentów adresów.

partialMatch

boolean

Oznacza, że geokoder nie zwrócił dopasowania ścisłego do pierwotnego żądania, ale udało mu się dopasować część żądanego adresu. Sprawdź, czy w pierwotnym żądaniu nie ma błędów pisowni lub niekompletnego adresu.

placeId

string

Identyfikator miejsca dla tego wyniku.

intermediateWaypointRequestIndex

integer

Indeks odpowiedniego punktu pośredniego w żądaniu. Wypełniane tylko wtedy, gdy odpowiedni punkt pośredni jest punktem pośrednim.