Odpowiedzi dojazdu

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Ta usługa ma stan starszej wersji. Od października 2026 r. interfejsu Directions API (starsza wersja) nie będzie można włączać w nowych projektach Google Cloud. Istniejące projekty będą nadal w pełni obsługiwane. Aby korzystać z nowych funkcji i większej wydajności, przejdź na interfejs Routes API.

Przykładowe odpowiedzi

Odpowiedzi dotyczące wskazówek dojazdu są zwracane w formacie wskazanym przez flagę output w ścieżce żądania adresu URL.

Poniżej znajduje się przykładowe żądanie HTTP, które oblicza trasę z Chicago w stanie Illinois do Los Angeles w Kalifornii przez 2 punkty pośrednie w Joplin w stanie Missouri i Oklahoma City w stanie Oklahoma.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

Powyższy przykład żąda danych wyjściowych JSON. Można też poprosić o dane wyjściowe w formacie XML. Wybierz karty poniżej, aby zobaczyć przykładowe odpowiedzi JSON i XML.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

W dalszej części tej dokumentacji będziemy używać składni JSON. W większości przypadków format wyjściowy nie ma znaczenia dla ilustrowania pojęć lub nazw pól w dokumentacji. Pamiętaj jednak o tych subtelnych różnicach:

  • Wyniki XML są opakowane w element główny <DirectionsResponse>.
  • JSON oznacza wpisy z wieloma elementami za pomocą tablic w liczbie mnogiej (takich jak steps i legs), natomiast XML oznacza je za pomocą wielu elementów w liczbie pojedynczej (takich jak <step> i <leg>).
  • W formacie JSON kolejność punktów orientacyjnych jest określana za pomocą pola waypoint_order, a w formacie XML – za pomocą poszczególnych elementów <waypoint_index>.
  • Puste elementy są wskazywane przez puste tablice w pliku JSON, ale przez brak takiego elementu w pliku XML. Odpowiedź, która nie generuje żadnych wyników, zwróci na przykład pustą tablicę routes w formacie JSON, ale nie zwróci żadnych elementów <route> w formacie XML.

DirectionsResponse

Pole Wymagane Typ Opis
wymagane Array<DirectionsRoute>

Zawiera tablicę tras z miejsca wyjazdu do miejsca docelowego. Trasy składają się z zagnieżdżonych odcinków i kroków.

Więcej informacji znajdziesz w sekcji DirectionsRoute.
wymagane DirectionsStatus

Zawiera stan żądania i może zawierać informacje na potrzeby debugowania, które pomogą Ci ustalić, dlaczego żądanie się nie powiodło.

Więcej informacji znajdziesz w sekcji DirectionsStatus.
opcjonalnie thought Array<TravelMode>

Zawiera tablicę dostępnych środków transportu. To pole jest zwracane, gdy żądanie określa środek transportu i nie zwraca żadnych wyników. Tablica zawiera dostępne środki transportu w krajach danego zestawu punktów pośrednich. To pole nie jest zwracane, jeśli co najmniej 1 punkt pośredni jest punktem pośrednim „via”.

Więcej informacji znajdziesz w sekcji TravelMode.
opcjonalnie tekst

Gdy usługa zwraca kod stanu inny niż OK, w obiekcie odpowiedzi może znajdować się dodatkowe pole error_message. To pole zawiera bardziej szczegółowe informacje o przyczynach danego kodu stanu. To pole nie zawsze jest zwracane, a jego zawartość może ulec zmianie.

opcjonalnie Array<DirectionsGeocodedWaypoint>

Zawiera tablicę ze szczegółowymi informacjami o geokodowaniu punktu początkowego, miejsca docelowego i punktów pośrednich. Elementy w tablicy geocoded_waypoints odpowiadają (według pozycji liczonej od 0) miejscu początkowemu, punktom orientacyjnym w podanej kolejności i miejscu docelowemu.

Te szczegóły nie będą dostępne w przypadku punktów pośrednich określonych jako tekstowe wartości szerokości i długości geograficznej, jeśli usługa nie zwróci żadnych wyników. Dzieje się tak, ponieważ takie punkty orientacyjne są poddawane odwrotnemu geokodowaniu w celu uzyskania ich reprezentatywnego adresu dopiero po znalezieniu trasy. Pusty obiekt JSON zajmie odpowiednie miejsca w tablicy geocoded_waypoints.

Więcej informacji znajdziesz w artykule DirectionsGeocodedWaypoint.

DirectionsRoute

Trasy składają się z zagnieżdżonych elementów legs i steps.

Pole Wymagane Typ Opis
wymagane Granice

Zawiera ramkę ograniczającą widocznego obszaru overview_polyline.

Więcej informacji znajdziesz w sekcji Ograniczenia.
wymagane tekst

Zawiera powiadomienia o prawach autorskich, które mają być wyświetlane w przypadku tej trasy. Musisz samodzielnie przetwarzać i wyświetlać te informacje. Te treści są przeznaczone do odczytu w postaci, w jakiej są wyświetlane. Nie analizuj ich automatycznie.

wymagane Array<DirectionsLeg>

Tablica zawierająca informacje o odcinku trasy między 2 lokalizacjami na danej trasie. Dla każdego określonego punktu orientacyjnego lub miejsca docelowego będzie dostępny osobny odcinek. (Trasa bez punktów pośrednich będzie zawierać dokładnie 1 etap w tablicy etapów). Każdy odcinek składa się z serii kroków.

Więcej informacji znajdziesz w artykule DirectionsLeg.
wymagane DirectionsPolyline

Zawiera obiekt, który przechowuje zakodowaną reprezentację linii łamanej trasy. Ta linia łamana to przybliżona (wygładzona) ścieżka wynikowych wskazówek dojazdu.

Więcej informacji znajdziesz w sekcji DirectionsPolyline.
wymagane tekst

Zawiera krótki opis tekstowy trasy, który nadaje się do nazwania i odróżnienia trasy od alternatywnych.

wymagane Array<string>

Zawiera tablicę ostrzeżeń, które mają być wyświetlane podczas pokazywania tych wskazówek dojazdu. Musisz samodzielnie obsługiwać i wyświetlać te ostrzeżenia.

wymagane Array<integer>

Tablica wskazująca kolejność punktów pośrednich na obliczonej trasie. Kolejność tych punktów orientacyjnych może zostać zmieniona, jeśli w żądaniu przekazano parametr optimize:true w parametrze punktów orientacyjnych.

opcjonalnie Fare

Jeśli jest obecny, zawiera łączną opłatę (czyli łączny koszt biletów) na tej trasie. Ta właściwość jest zwracana tylko w przypadku żądań dotyczących transportu publicznego i tylko w przypadku tras, na których informacje o opłatach są dostępne dla wszystkich odcinków transportu publicznego.

Więcej informacji znajdziesz w sekcji Opłata.

Ograniczenia

Prostokąt we współrzędnych geograficznych z punktów w rogach południowo-zachodnim i północno-wschodnim.

Pole Wymagane Typ Opis
wymagane LatLngLiteral Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane LatLngLiteral Więcej informacji znajdziesz w artykule LatLngLiteral.

LatLngLiteral

Obiekt opisujący konkretną lokalizację z szerokością i długością geograficzną w stopniach dziesiętnych.

Pole Wymagane Typ Opis
wymagane liczba

Szerokość geograficzna w stopniach dziesiętnych
wymagane liczba

Długość geograficzna w stopniach dziesiętnych

DirectionsLeg

Pole Wymagane Typ Opis
wymagane tekst

Zawiera zrozumiały dla człowieka adres (zwykle adres ulicy) uzyskany w wyniku odwrotnego geokodowania end_location tego odcinka trasy. Te treści powinny być odczytywane w takiej postaci, w jakiej są. Nie analizuj sformatowanego adresu automatycznie.

wymagane LatLngLiteral

Współrzędne szerokości i długości geograficznej danego miejsca docelowego tego etapu. Ponieważ interfejs Directions API oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w punktach początkowym i końcowym, end_location może się różnić od podanego miejsca docelowego tego etapu, jeśli na przykład w pobliżu miejsca docelowego nie ma drogi.

Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane tekst

Zawiera zrozumiały dla człowieka adres (zwykle adres ulicy) uzyskany w wyniku odwrotnego geokodowania start_location tego odcinka. Te treści powinny być odczytywane w niezmienionej postaci. Nie analizuj sformatowanego adresu automatycznie.

wymagane LatLngLiteral

Współrzędne szerokości i długości geograficznej miejsca rozpoczęcia tego etapu. Interfejs Directions API oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w punktach początkowym i końcowym. Dlatego start_location może się różnić od podanego miejsca rozpoczęcia tego etapu, jeśli na przykład w pobliżu miejsca rozpoczęcia nie ma drogi.

Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane Array<DirectionsStep>

Tablica kroków zawierająca informacje o każdym osobnym kroku etapu podróży.

Więcej informacji znajdziesz w sekcji DirectionsStep.

traffic_speed_entry

opcjonalnie Array<DirectionsTrafficSpeedEntry>

Informacje o prędkości ruchu na danym odcinku.

Więcej informacji znajdziesz w artykule DirectionsTrafficSpeedEntry.

wymagane Array<DirectionsViaWaypoint>

Lokalizacje punktów pośrednich na tym odcinku.

Więcej informacji znajdziesz w artykule DirectionsViaWaypoint.

opcjonalnie TimeZoneTextValueObject

Zawiera szacowany czas dotarcia na tym odcinku. Ta właściwość jest zwracana tylko w przypadku wskazówek dojazdu transportem publicznym.

Więcej informacji znajdziesz w sekcji TimeZoneTextValueObject.

opcjonalnie TimeZoneTextValueObject

Zawiera szacowany czas odjazdu na tym odcinku, określony jako obiekt Time. departure_time jest dostępny tylko w przypadku wskazówek dojazdu transportem publicznym.

Więcej informacji znajdziesz w artykule TimeZoneTextValueObject.

opcjonalnie TextValueObject

Całkowita odległość pokonana na tym odcinku.

Więcej informacji znajdziesz w sekcji TextValueObject.
opcjonalnie TextValueObject

Łączny czas trwania tego etapu.

Więcej informacji znajdziesz w sekcji TextValueObject.
opcjonalnie TextValueObject

Wskazuje łączny czas trwania tego etapu. Ta wartość to szacowany czas jazdy w ruchu ulicznym na podstawie bieżących i historycznych warunków na drodze. Więcej informacji o opcjach, których możesz użyć, aby poprosić o zwrócenie wartości optymistycznej, pesymistycznej lub najbardziej prawdopodobnej, znajdziesz w opisie parametru żądania traffic_model. Czas trwania w ruchu jest zwracany tylko wtedy, gdy są spełnione wszystkie te warunki:

  • Żądanie nie zawiera punktów pośrednich. Jeśli żądanie zawiera punkty pośrednie, muszą one być poprzedzone prefiksem via:, aby uniknąć postojów.
  • Żądanie dotyczy konkretnie wskazówek dojazdu – parametr trybu jest ustawiony na driving.
  • Żądanie zawiera parametr departure_time.
  • Informacje o warunkach na drodze są dostępne dla wybranej trasy.

Więcej informacji znajdziesz w sekcji TextValueObject.

DirectionsStep

Każdy element w tablicy steps definiuje pojedynczy krok obliczonych wskazówek dojazdu. Krok to najbardziej podstawowa jednostka trasy, która zawiera pojedynczy krok opisujący konkretną, pojedynczą instrukcję dotyczącą podróży. np. „Skręć w lewo na skrzyżowaniu z ulicą W. 4th St." Krok zawiera nie tylko instrukcję, ale też informacje o odległości i czasie trwania, które pokazują, jak ten krok odnosi się do następnego. Na przykład krok oznaczony jako „Zjedź na I-80 West” może zawierać czas trwania „37 mil” i „40 minut”, co oznacza, że następny krok jest oddalony o 37 mil lub 40 minut od tego kroku.

Gdy używasz interfejsu Directions API do wyszukiwania wskazówek dojazdu transportem publicznym, tablica steps będzie zawierać dodatkowe szczegóły dotyczące transportu publicznego w formie tablicy transit_details. Jeśli wskazówki dojazdu obejmują kilka środków transportu, szczegółowe wskazówki dotyczące kroków pieszych lub samochodowych będą podane w tablicy kroków wewnętrznych. Na przykład krok dotyczący chodzenia będzie zawierał wskazówki dojazdu z lokalizacji początkowej i końcowej: „Idź do Innes Ave i Fitch St”. Ten krok będzie zawierać szczegółowe wskazówki dotyczące trasy pieszej w tablicy kroków wewnętrznych, np. „Kieruj się na północny zachód”, „Skręć w lewo w Arelious Walker” i „Skręć w lewo w Innes Ave”.

Pole Wymagane Typ Opis
wymagane TextValueObject

Zawiera typowy czas potrzebny na wykonanie kroku, aż do następnego kroku. To pole może być niezdefiniowane, jeśli czas trwania jest nieznany.

Więcej informacji znajdziesz w sekcji TextValueObject.
wymagane LatLngLiteral

Zawiera lokalizację ostatniego punktu tego kroku.

Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane tekst

Zawiera sformatowane instrukcje dotyczące tego kroku, przedstawione jako ciąg tekstowy HTML. Te treści są przeznaczone do odczytu w takiej postaci, w jakiej są wyświetlane. Nie analizuj ich automatycznie.

wymagane DirectionsPolyline

Zawiera pojedynczy obiekt punktów, który zawiera reprezentację kroku w postaci zakodowanej linii łamanej. Ta łamana to przybliżona (wygładzona) ścieżka kroku.

Więcej informacji znajdziesz w sekcji DirectionsPolyline.
wymagane LatLngLiteral

Zawiera lokalizację punktu początkowego tego kroku.

Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane TravelMode

Zawiera typ użytego trybu podróży.

Więcej informacji znajdziesz w sekcji TravelMode.
opcjonalnie TextValueObject

Zawiera odległość, jaką należy pokonać w ramach tego kroku, aby dotrzeć do następnego. To pole może być niezdefiniowane, jeśli odległość jest nieznana.

Więcej informacji znajdziesz w sekcji TextValueObject.
opcjonalnie tekst

Zawiera działanie, które należy wykonać na bieżącym etapie (skręć w lewo, wjedź na drogę, jedź prosto itp.). Wartości mogą ulec zmianie, a nowe wartości mogą zostać wprowadzone bez wcześniejszego powiadomienia.

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
opcjonalnie

Zawiera szczegółowe wskazówki dotyczące pieszych lub samochodowych etapów trasy we wskazówkach dojazdu transportem publicznym. Kroki podrzędne są dostępne tylko wtedy, gdy parametr travel_mode ma wartość „transit”. Tablica wewnętrznych kroków jest tego samego typu co kroki.

opcjonalnie DirectionsTransitDetails

Szczegóły dotyczące tego kroku, jeśli środek transportu to transit.

Więcej informacji znajdziesz w artykule DirectionsTransitDetails.

TextValueObject

Obiekt zawierający wartość liczbową i jej sformatowaną reprezentację tekstową.

Pole Wymagane Typ Opis

text

wymagane tekst

Wartość w formie ciągu znaków.
wymagane liczba

Wartość liczbowa.

DirectionsPolyline

Kodowanie linii łamanej to algorytm kompresji stratnej, który umożliwia przechowywanie serii współrzędnych jako pojedynczego ciągu znaków. Współrzędne punktów są kodowane za pomocą wartości ze znakiem. Jeśli masz tylko kilka punktów statycznych, możesz też użyć interaktywnego narzędzia do kodowania linii łamanych.

Proces kodowania konwertuje wartość binarną na serię kodów znaków ASCII przy użyciu znanego schematu kodowania base64. Aby zapewnić prawidłowe wyświetlanie tych znaków, zakodowane wartości są sumowane z 63 (znak ASCII „?”) przed ich konwersją na ASCII. Algorytm sprawdza też dodatkowe kody znaków dla danego punktu, sprawdzając najmniej znaczący bit każdej grupy bajtów. Jeśli ten bit jest ustawiony na 1, punkt nie jest jeszcze w pełni uformowany i muszą po nim następować dodatkowe dane.

Dodatkowo, aby zaoszczędzić miejsce, punkty zawierają tylko przesunięcie względem poprzedniego punktu (z wyjątkiem pierwszego punktu). Wszystkie punkty są zakodowane w formacie Base64 jako liczby całkowite ze znakiem, ponieważ szerokość i długość geograficzna są wartościami ze znakiem. Format kodowania w łamanej musi reprezentować 2 współrzędne (szerokość i długość geograficzną) z odpowiednią dokładnością. Biorąc pod uwagę maksymalną długość geograficzną +/- 180 stopni z dokładnością do 5 miejsc po przecinku (od 180,00000 do -180,00000), wymaga to 32-bitowej wartości binarnej ze znakiem.

Pole Wymagane Typ Opis
wymagane tekst

Pojedynczy ciąg znaków reprezentujący łamaną.

TravelMode

  • DRIVING (domyślna) wskazuje obliczenia z użyciem sieci dróg.
  • BICYCLING żąda obliczenia trasy rowerowej z uwzględnieniem ścieżek rowerowych i preferowanych ulic (jeśli są dostępne).
  • TRANSIT żąda obliczeń z wykorzystaniem tras transportu publicznego (jeśli są dostępne).
  • WALKING żąda obliczenia trasy pieszej z wykorzystaniem ścieżek dla pieszych i chodników (jeśli są dostępne).

DirectionsTransitDetails

Dodatkowe informacje, które nie są istotne w przypadku innych środków transportu.

Pole Wymagane Typ Opis
opcjonalnie DirectionsTransitStop

Przystanek docelowy.

Więcej informacji znajdziesz w sekcji DirectionsTransitStop.

opcjonalnie TimeZoneTextValueObject Więcej informacji znajdziesz w sekcji TimeZoneTextValueObject.
opcjonalnie DirectionsTransitStop

Przystanek początkowy.

Więcej informacji znajdziesz w sekcji DirectionsTransitStop.

opcjonalnie TimeZoneTextValueObject Więcej informacji znajdziesz w sekcji TimeZoneTextValueObject.
opcjonalnie tekst

Określa kierunek jazdy na tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdu. Często będzie to stacja końcowa.

opcjonalnie liczba całkowita

Określa oczekiwaną liczbę sekund między odjazdami z tego samego przystanku w tym czasie. Jeśli na przykład wartość headway wynosi 600, a autobus Ci ucieknie, musisz poczekać 10 minut.

opcjonalnie DirectionsTransitLine

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

Więcej informacji znajdziesz w sekcji DirectionsTransitLine.

opcjonalnie liczba całkowita

Liczba przystanków od przystanku początkowego do końcowego. Obejmuje to przystanek docelowy, ale nie przystanek początkowy. Jeśli na przykład wskazówki dojazdu obejmują wyjazd z przystanku A, przejazd przez przystanki B i C oraz przyjazd na przystanek D, num_stops zwróci wartość 3.

opcjonalnie tekst

Tekst, który pojawia się w rozkładach jazdy i na tablicach informacyjnych, aby pasażerowie mogli zidentyfikować przejazd. Tekst powinien jednoznacznie identyfikować przejazd w danym dniu obsługi. Na przykład „538” to trip_short_name pociągu Amtrak, który odjeżdża z San Jose w Kalifornii o 15:10 w dni powszednie do Sacramento w Kalifornii.

DirectionsTransitStop

Pole Wymagane Typ Opis
wymagane LatLngLiteral

Lokalizacja przystanku.

Więcej informacji znajdziesz w artykule LatLngLiteral.
wymagane tekst

Nazwa przystanku transportu publicznego.

TimeZoneTextValueObject

Obiekt zawierający czas epoki uniksowej, strefę czasową i sformatowaną reprezentację tekstową.

Pole Wymagane Typ Opis

text

wymagane tekst

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

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

wymagane liczba

Czas określony jako czas epoki uniksowej lub sekundy od północy 1 stycznia 1970 r. czasu UTC.

DirectionsTransitLine

Pole Wymagane Typ Opis
wymagane Array<DirectionsTransitAgency>

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

Więcej informacji znajdziesz w sekcji DirectionsTransitAgency.

wymagane tekst

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

Kolor często używany na znakach dotyczących tej linii.
opcjonalnie tekst

Zawiera adres URL ikony powiązanej z tą linią.
opcjonalnie tekst

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

text_color

opcjonalnie tekst

Kolor często używany na znakach dotyczących tej linii.
opcjonalnie tekst

Zawiera adres URL tej linii transportu publicznego podany przez przewoźnika.
opcjonalnie DirectionsTransitVehicle

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

Więcej informacji znajdziesz w sekcji DirectionsTransitVehicle.

DirectionsTransitAgency

Pole Wymagane Typ Opis
opcjonalnie tekst

Nazwa przewoźnika.
opcjonalnie tekst

Numer telefonu przewoźnika.
opcjonalnie tekst

Adres URL przewoźnika.

DirectionsTransitVehicle

Pole Wymagane Typ Opis
wymagane tekst

Nazwa tego pojazdu pisana wielkimi literami.
wymagane tekst

rodzaj użytego pojazdu;

  • 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 na strome zbocze 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 – pociąg dalekobieżny.
  • METRO_RAIL – kolej miejska.
  • MONORAIL – kolej jednoszynowa.
  • OTHER – wszystkie inne pojazdy będą zwracać ten typ.
  • 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.
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
opcjonalnie tekst

Zawiera adres URL ikony powiązanej z tym typem pojazdu.
opcjonalnie tekst

Zawiera adres URL ikony powiązanej z tym typem pojazdu na podstawie lokalnych znaków transportowych.

DirectionsTrafficSpeedEntry

Pole Wymagane Typ Opis
wymagane liczba

Przesunięcie wzdłuż ścieżki (w metrach), do którego obowiązuje ta kategoria prędkości.
wymagane tekst

Bieżące natężenie ruchu i prędkość na tym odcinku trasy.

DirectionsViaWaypoint

Pole Wymagane Typ Opis
opcjonalnie LatLngLiteral

Lokalizacja punktu na trasie.

Więcej informacji znajdziesz w artykule LatLngLiteral.
opcjonalnie liczba całkowita

Indeks kroku zawierającego punkt pośredni.
opcjonalnie liczba

Pozycja punktu na trasie wzdłuż linii łamanej kroku, wyrażona jako współczynnik od 0 do 1.

Cena

Łączna opłata za przejazd na trasie.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
Pole Wymagane Typ Opis
wymagane tekst

Kod waluty w formacie ISO 4217 wskazujący walutę, w której wyrażona jest kwota.

text

wymagane tekst

Łączna kwota opłaty za przejazd sformatowana w żądanym języku.
wymagane liczba

Łączna kwota opłaty za przejazd w określonej walucie.

DirectionsStatus

Pole stanu w obiekcie odpowiedzi na żądanie wskazówek dojazdu zawiera stan żądania i może zawierać informacje na potrzeby debugowania, które pomogą Ci ustalić, dlaczego usługa wskazówek dojazdu nie działa. Pole stanu może zawierać te wartości:

  • OK wskazuje, że odpowiedź zawiera prawidłowy wynik.
  • NOT_FOUND wskazuje, że nie udało się geokodować co najmniej jednej lokalizacji określonej w punkcie początkowym, docelowym lub punktach pośrednich żądania.
  • ZERO_RESULTS oznacza, że nie udało się znaleźć trasy między miejscem początkowym a docelowym.
  • MAX_WAYPOINTS_EXCEEDED oznacza, że w żądaniu podano zbyt wiele punktów pośrednich. W przypadku aplikacji korzystających z Directions API jako usługi internetowej lub usługi wyznaczania trasy w Maps JavaScript API maksymalna dozwolona liczba punktów pośrednich wynosi 25 (plus punkt początkowy i docelowy).
  • MAX_ROUTE_LENGTH_EXCEEDED wskazuje, że żądana trasa jest za długa i nie można jej przetworzyć. Ten błąd występuje, gdy zwracane są bardziej złożone wskazówki dojazdu. Spróbuj zmniejszyć liczbę punktów pośrednich, skrętów lub instrukcji.
  • INVALID_REQUEST oznacza, że przesłane żądanie było nieprawidłowe. Typowe przyczyny tego stanu to nieprawidłowy parametr lub wartość parametru.
  • OVER_DAILY_LIMIT oznacza dowolną z tych wartości:
    • Brak klucza interfejsu API lub jest on nieprawidłowy.
    • Na Twoim koncie nie włączono płatności.
    • Przekroczono samodzielnie nałożony limit wykorzystania.
    • Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
    Aby dowiedzieć się, jak rozwiązać ten problem, zapoznaj się z najczęstszymi pytaniami dotyczącymi Map.
  • OVER_QUERY_LIMIT oznacza, że usługa otrzymała zbyt wiele żądań z Twojej aplikacji w dozwolonym okresie.
  • REQUEST_DENIED oznacza, że usługa odmówiła aplikacji dostępu do usługi wskazówek dojazdu.
  • UNKNOWN_ERROR oznacza, że nie udało się przetworzyć prośby o wskazówki dojazdu z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.

DirectionsGeocodedWaypoint

Pole Wymagane Typ Opis
opcjonalnie tekst

Wskazuje kod stanu wynikający z operacji geokodowania. To pole może zawierać te wartości:

The allowed values include: OK, and ZERO_RESULTS
opcjonalnie

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

Częściowe dopasowania występują najczęściej w przypadku adresów, które nie istnieją w miejscowości podanej w żądaniu. Częściowe dopasowania mogą być też zwracane, gdy żądanie pasuje do co najmniej 2 lokalizacji w tej samej miejscowości. Na przykład „21 Henr St, Bristol, UK” zwróci częściowe dopasowanie zarówno dla Henry Street, jak i Henrietta Street. Pamiętaj, że jeśli żądanie zawiera błędnie wpisany element adresu, usługa geokodowania może zasugerować alternatywny adres. Sugestie wywołane w ten sposób będą również oznaczone jako częściowe dopasowanie.

opcjonalnie tekst

Unikalny identyfikator, którego można używać z innymi interfejsami API Google. Zobacz Omówienie identyfikatora miejsca.

opcjonalnie Array<string>

Wskazuje typ adresu wyniku geokodowania użytego do obliczenia wskazówek dojazdu.

  • administrative_area_level_1 wskazuje jednostkę administracyjną pierwszego rzędu poniżej poziomu kraju. W Stanach Zjednoczonych są to stany. Nie wszystkie kraje używają tych poziomów administracyjnych. W większości przypadków krótkie nazwy administrative_area_level_1 będą ściśle odpowiadać podregionom ISO 3166-2 i innym powszechnie używanym listom. Nie możemy jednak tego zagwarantować, ponieważ nasze wyniki geokodowania są oparte na różnych sygnałach i danych o lokalizacji.
  • administrative_area_level_2 oznacza jednostkę administracyjną drugiego rzędu poniżej poziomu kraju. W Stanach Zjednoczonych są to hrabstwa. Nie wszystkie kraje używają tych poziomów administracyjnych.
  • administrative_area_level_3 oznacza jednostkę administracyjną trzeciego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych.
  • administrative_area_level_4 oznacza jednostkę administracyjną czwartego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych.
  • administrative_area_level_5 wskazuje jednostkę administracyjną piątego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych.
  • airport oznacza lotnisko.
  • colloquial_area wskazuje powszechnie używaną alternatywną nazwę podmiotu.
  • country wskazuje narodowy podmiot polityczny i jest zwykle najwyższym typem zamówienia zwracanym przez geokoder.
  • intersection oznacza główne skrzyżowanie, zwykle 2 głównych dróg.
  • locality oznacza miasto lub miejscowość z prawami miejskimi.
  • natural_feature wskazuje ważny obiekt przyrodniczy.
  • neighborhood oznacza nazwaną okolicę
  • park oznacza park z nazwą.
  • plus_code wskazuje zakodowane odniesienie do lokalizacji, które pochodzi z szerokości i długości geograficznej. Kody Plus mogą zastępować adresy ulic w miejscach, gdzie ich nie ma (gdzie budynki nie są ponumerowane lub ulice nie mają nazw). Więcej informacji znajdziesz na stronie https://plus.codes.
  • point_of_interest wskazuje nazwane ciekawe miejsce. Zwykle są to znane lokalne obiekty, które nie pasują do żadnej innej kategorii, np. „Pałac Kultury i Nauki” czy „Wieża Eiffla”.
  • political oznacza podmiot polityczny. Zwykle ten typ wskazuje wielokąt jakiejś jednostki administracji cywilnej.
  • postal_code oznacza kod pocztowy używany do adresowania przesyłek pocztowych na terenie danego kraju.
  • premise wskazuje nazwaną lokalizację, zwykle budynek lub zbiór budynków o wspólnej nazwie.
  • route wskazuje nazwaną trasę (np. „US 101”).
  • street_address oznacza dokładny adres.
  • sublocality oznacza jednostkę administracyjną pierwszego rzędu poniżej miejscowości. W przypadku niektórych lokalizacji może zostać zwrócony jeden z dodatkowych typów: sublocality_level_1 do sublocality_level_5. Każdy poziom dzielnicy jest jednostką administracyjną. Większe liczby oznaczają mniejszy obszar geograficzny.
  • subpremise wskazuje element pierwszego rzędu poniżej nazwanej lokalizacji, zwykle pojedynczy budynek w zbiorze budynków o wspólnej nazwie.
  • tourist_attraction oznacza atrakcję turystyczną.
  • train_station oznacza stację kolejową.
  • transit_station oznacza stację transportu publicznego.

Pusta lista typów oznacza, że nie ma znanych typów dla danego komponentu adresu, np. Lieu-dit we Francji.