- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Trasa
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Manewr
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Widoczny obszar
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
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 ( |
| Pola | |
|---|---|
origin |
Wymagane. Punkt na trasie będący punktem początkowym. |
destination |
Wymagane. Punkt na trasie miejsca docelowego. |
intermediates[] |
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 |
Opcjonalnie: Określa środek transportu. |
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 |
polylineQuality |
Opcjonalnie: Określa preferencje dotyczące jakości linii łamanej. |
polylineEncoding |
Opcjonalnie: Określa preferowane kodowanie linii łamanej. |
departureTime |
Opcjonalnie: Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyty czas wysłania żądania. UWAGA: możesz określić 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: |
arrivalTime |
Opcjonalnie: godzinę przyjazdu, UWAGA: to pole jest ignorowane, gdy żądania określają 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: |
computeAlternativeRoutes |
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 |
Opcjonalnie: Zestaw warunków, które należy spełnić, wpływających na sposób obliczania tras. |
languageCode |
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 |
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 |
Opcjonalnie: Określa jednostki miary dla pól wyświetlania. Te pola obejmują pole |
optimizeWaypointOrder |
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 |
requestedReferenceRoutes[] |
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 |
extraComputations[] |
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 |
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 |
transitPreferences |
Opcjonalnie: Określa preferencje, które wpływają na trasę zwracaną w przypadku tras |
Treść odpowiedzi
v2.computeRoutes – komunikat 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), jeśli określisz |
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 |
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ń W przypadku żądań Ta funkcja nie jest zgodna z innymi środkami transportu, punktami pośrednimi ani z |
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 ( |
| Pola | |
|---|---|
routeLabels[] |
Etykiety |
legs[] |
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 |
distanceMeters |
Odległość do pokonania na trasie w metrach. |
duration |
czas potrzebny na pokonanie trasy. Jeśli ustawisz parametr Gdy parametr
We wszystkich innych przypadkach używane są prędkości pojazdów osobowych, nawet jeśli w parametrze Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
staticDuration |
Czas podróży trasą bez uwzględniania warunków na drodze. Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
polyline |
Linia łamana całej trasy. Ta linia łamana jest połączoną linią łamaną wszystkich |
description |
Opis trasy. |
warnings[] |
Tablica ostrzeżeń, które mają się wyświetlać podczas wyświetlania trasy. |
viewport |
Ramka ograniczająca widoczny obszar linii łamanej. |
travelAdvisory |
Dodatkowe informacje o trasie. |
optimizedIntermediateWaypointIndex[] |
Jeśli ustawisz parametr |
localizedValues |
Tekstowe reprezentacje właściwości |
routeToken |
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: |
polylineDetails |
Zawiera informacje o szczegółach wzdłuż linii łamanej. |
RouteLabel
Etykiety , które są przydatne do identyfikowania konkretnych właściwości trasy w celu porównania ich z innymi.Route
| 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 . |
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 ( |
| Pola | |
|---|---|
distanceMeters |
Odległość do przebycia na danym odcinku trasy w metrach. |
duration |
Czas potrzebny na pokonanie odcinka. Jeśli parametr Gdy parametr
We wszystkich innych przypadkach używane są prędkości pojazdów osobowych, nawet jeśli w parametrze Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „ |
staticDuration |
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ą „ |
polyline |
Ogólna linia łamana dla tego etapu, która obejmuje linię łamaną każdego elementu |
startLocation |
Lokalizacja początkowa tego odcinka. Ta lokalizacja może się różnić od podanej: |
endLocation |
Lokalizacja końcowa tego etapu. Ta lokalizacja może się różnić od podanej: |
steps[] |
Tablica kroków oznaczających segmenty w ramach tego etapu. Każdy krok reprezentuje jedną instrukcję nawigacji. |
travelAdvisory |
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 |
Tekstowe reprezentacje właściwości |
stepsOverview |
Informacje ogólne o krokach w tym: |
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 |
Ciąg znaków kodujący linię łamaną za pomocą algorytmu kodowania linii łamanej. |
geoJsonLinestring |
Określa linię łamaną w formacie GeoJSON LineString. |
| Koniec pól wykluczających się wzajemnie. | |
RouteLegStep
Zawiera segment: . Krok odpowiada pojedynczej instrukcji nawigacji. Odcinki trasy składają się z kroków.RouteLeg
| Zapis JSON |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| Pola | |
|---|---|
distanceMeters |
Odległość do pokonania na tym etapie w metrach. W niektórych przypadkach to pole może nie mieć wartości. |
staticDuration |
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ą „ |
polyline |
Łamana powiązana z tym krokiem. |
startLocation |
Lokalizacja początkowa tego kroku. |
endLocation |
Lokalizacja końcowa tego kroku. |
navigationInstruction |
powiadomienia nawigacji, |
travelAdvisory |
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. o możliwych ograniczeniach strefy ruchu na danym etapie trasy. |
localizedValues |
Tekstowe reprezentacje właściwości |
transitDetails |
Szczegóły dotyczące tego kroku, jeśli tryb podróży to |
travelMode |
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 ( |
| Pola | |
|---|---|
speedReadingIntervals[] |
UWAGA: to pole nie jest obecnie wypełnione. |
RouteLegStepLocalizedValues
Tekstowe reprezentacje niektórych właściwości.
| Zapis JSON |
|---|
{ "distance": { object ( |
| Pola | |
|---|---|
distance |
Odległość podróży w formie tekstowej. |
staticDuration |
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 ( |
| Pola | |
|---|---|
stopDetails |
Informacje o przystankach przyjazdu i odjazdu na danym etapie. |
localizedValues |
Tekstowe reprezentacje właściwości |
headsign |
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 |
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ą „ |
transitLine |
Informacje o linii transportu publicznego używanej na tym etapie. |
stopCount |
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 |
tripShortText |
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 |
TransitStopDetails
Szczegóły dotyczące przystanków transportu publicznego dla: RouteLegStep.
| Zapis JSON |
|---|
{ "arrivalStop": { object ( |
| Pola | |
|---|---|
arrivalStop |
Informacje o przystanku docelowym dla danego kroku. |
arrivalTime |
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: |
departureStop |
Informacje o przystanku początkowym dla danego kroku. |
departureTime |
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: |
TransitStop
Informacje o przystanku transportu publicznego.
| 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: RouteTransitDetails.
| Zapis JSON |
|---|
{ "arrivalTime": { object ( |
| Pola | |
|---|---|
arrivalTime |
Czas w sformatowanej reprezentacji tekstowej z odpowiednią strefą czasową. |
departureTime |
Czas w sformatowanej reprezentacji tekstowej z odpowiednią strefą czasową. |
LocalizedTime
Zlokalizowany opis czasu.
| Zapis JSON |
|---|
{
"time": {
object ( |
| Pola | |
|---|---|
time |
Czas określony jako ciąg znaków w danej strefie czasowej. |
timeZone |
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 ( |
| Pola | |
|---|---|
agencies[] |
Przewoźnik (lub przewoźnicy) obsługujący tę linię transportu publicznego. |
name |
Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”. |
uri |
identyfikator URI tej linii transportu publicznego podany przez przewoźnika. |
color |
Kolor powszechnie używany w oznakowaniu tej linii. Reprezentowany w formacie szesnastkowym. |
iconUri |
Identyfikator URI ikony powiązanej z tą linią. |
nameShort |
Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer linii, np. „M7” lub „355”. |
textColor |
Kolor często używany w tekście na znakach dotyczących tej linii. Reprezentowany w formacie szesnastkowym. |
vehicle |
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 |
Nazwa przewoźnika. |
phoneNumber |
Numer telefonu przewoźnika w formacie międzynarodowym. |
uri |
Identyfikator URI przewoźnika. |
TransitVehicle
Informacje o pojeździe używanym na trasach transportu publicznego.
| Zapis JSON |
|---|
{ "name": { object ( |
| Pola | |
|---|---|
name |
Nazwa tego pojazdu, pisana wielkimi literami. |
type |
rodzaj użytego pojazdu; |
iconUri |
Identyfikator URI ikony powiązanej z tym typem pojazdu. |
localIconUri |
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 ( |
| Pola | |
|---|---|
tollInfo |
Zawiera informacje o opłatach na konkretnej trasie |
speedReadingIntervals[] |
Przedziały prędkości wskazujące natężenie ruchu. To pole jest wypełniane tylko w przypadku żądań, które mają wartość Przykład: |
RouteLegLocalizedValues
Tekstowe reprezentacje niektórych właściwości.
| Zapis JSON |
|---|
{ "distance": { object ( |
| Pola | |
|---|---|
distance |
Odległość podróży w formie tekstowej. |
duration |
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 |
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 ( |
| Pola | |
|---|---|
multiModalSegments[] |
Podsumowanie informacji o różnych segmentach multimodalnych |
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 ( |
| Pola | |
|---|---|
navigationInstruction |
NavigationInstruction dla segmentu multimodalnego. |
travelMode |
Środek transportu w segmencie multimodalnym. |
stepStartIndex |
Odpowiedni indeks |
stepEndIndex |
Odpowiedni indeks |
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, ahigh.longitude= 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.Jeśli
low.longitude= 180 stopni, ahigh.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 ( |
| Pola | |
|---|---|
low |
Wymagane. Najniższy punkt widocznego obszaru. |
high |
Wymagane. Najwyższy punkt widocznego obszaru. |
RouteLocalizedValues
Tekstowe reprezentacje niektórych właściwości.
| Zapis JSON |
|---|
{ "distance": { object ( |
| Pola | |
|---|---|
distance |
Odległość podróży w formie tekstowej. |
duration |
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 |
Czas trwania bez uwzględnienia warunków na drodze, przedstawiony w formie tekstowej. |
transitFare |
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 ( |
| Pola | |
|---|---|
tunnelInfo[] |
Szczegóły tunelu wzdłuż linii łamanej. To pole jest wypełniane, jeśli żądanie określa modyfikator trasy |
restrictionInfo[] |
Szczegóły ograniczenia wzdłuż linii łamanej. To pole jest wypełniane tylko wtedy, gdy żądanie zawiera modyfikator trasy |
flyoverInfo[] |
Szczegóły przelotu wzdłuż linii łamanej. |
narrowRoadInfo[] |
Szczegóły wąskiej drogi wzdłuż linii łamanej. |
bridgeInfo[] |
Szczegóły mostu wzdłuż linii łamanej. |
skywayInfo[] |
Szczegóły dotyczące kładki wzdłuż linii łamanej. |
TunnelInfo
Zawiera informacje o tunelach wzdłuż linii łamanej.
| Zapis JSON |
|---|
{ "tunnelPresence": enum ( |
| Pola | |
|---|---|
tunnelPresence |
Wskazuje, czy na danym odcinku linii łamanej znajduje się tunel. |
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 |
Indeks początkowy tego szczegółu w linii łamanej. |
endIndex |
Indeks końcowy tego szczegółu w linii łamanej. |
RestrictionInfo
Zawiera informacje o różnych ograniczeniach na linii łamanej.
| Zapis JSON |
|---|
{ "restrictionPresence": enum ( |
| Pola | |
|---|---|
restrictionPresence |
Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej obowiązuje ograniczenie. |
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 |
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 |
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 |
To pole ma wartość „true”, gdy transport towarów niebezpiecznych jest ograniczony. |
trucksProhibited |
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 ( |
| Pola | |
|---|---|
flyoverPresence |
Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej znajduje się wiadukt. |
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 ( |
| Pola | |
|---|---|
narrowRoadPresence |
Tylko dane wyjściowe. Wskazuje, czy na danym odcinku linii łamanej występuje wąska droga. |
polylinePointIndex |
Lokalizacja informacji o wąskiej drodze wzdłuż linii łamanej. |
BridgeInfo
Zawiera informacje o mostach na linii łamanej.
| Zapis JSON |
|---|
{ "bridgePresence": enum ( |
| Pola | |
|---|---|
bridgePresence |
Wskazuje, czy na danym odcinku linii łamanej znajduje się most. |
polylinePointIndex |
Lokalizacja informacji o mostach na linii łamanej. |
SkywayInfo
Zawiera informacje o łącznikach wzdłuż linii łamanej.
| Zapis JSON |
|---|
{ "skywayPresence": enum ( |
| Pola | |
|---|---|
skywayPresence |
Wskazuje, czy na danym odcinku linii łamanej znajduje się kładka. |
polylinePointIndex |
Lokalizacja informacji o łączniku wzdłuż linii łamanej. |
GeocodingResults
Zawiera dla punktu początkowego, miejsca docelowego i punktów pośrednich. Wypełniane tylko w przypadku punktów orientacyjnych adresu.GeocodedWaypoints
| Zapis JSON |
|---|
{ "origin": { object ( |
| Pola | |
|---|---|
origin |
Punkt na trasie z geokodowaniem miejsca rozpoczęcia. |
destination |
Punkt na trasie z geokodowaniem miejsca docelowego. |
intermediates[] |
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 ( |
| Pola | |
|---|---|
geocoderStatus |
Wskazuje kod stanu wynikający z operacji geokodowania. |
type[] |
Typy wyniku w postaci co najmniej 1 tagu typu. Obsługiwane typy: typy adresów i typy komponentów adresów. |
partialMatch |
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 |
Identyfikator miejsca dla tego wyniku. |
intermediateWaypointRequestIndex |
Indeks odpowiedniego punktu pośredniego w żądaniu. Wypełniane tylko wtedy, gdy odpowiedni punkt pośredni jest punktem pośrednim. |