Directions API – krótkie wprowadzenie

Directions API (starsza wersja) to usługa internetowa, która oblicza wskazówki dojazdu między lokalizacjami dla samochodów, pieszych, rowerzystów i transportu publicznego, w tym trasy wieloczęściowe z punktami pośrednimi, oraz zwraca trasy, odcinki i kroki w formacie JSON lub XML. Ma status „starsza wersja”: od października 2026 r. nie będzie można go włączyć w nowych projektach w chmurze Google Cloud. Przejdź na Routes API.

Directions API: najważniejsze informacje

  • Usługa: Directions API
  • Inna nazwa: Directions API (starsza wersja)
  • Kategoria: Trasy
  • Platforma: usługa internetowa (REST)
  • Działa na: serwerze (kod backendu)
  • Etap uruchomienia: GA
  • Cykl życia: starsza wersja
  • Zastąpiony przez: Routes API
  • Omówienie: omówienie interfejsu Directions API
  • Dostępność: cały świat. Dostępność danych zależy od regionu i środka transportu (transport publiczny zależy od danych od przewoźników). (szczegóły dotyczące zakresu ochrony)

Directions API: kiedy z niego korzystać

Kiedy używać interfejsu Directions API:

  • Masz istniejący projekt w chmurze Google Cloud, który ma już włączony interfejs Directions API (starsza wersja) i wywołuje maps/api/directions.
  • Potrzebujesz wskazówek dojazdu samochodem, pieszo, rowerem lub transportem publicznym (punkty pośrednie tylko w przypadku środków transportu innych niż transport publiczny) po stronie serwera w formacie JSON lub XML w istniejącym projekcie.

Kiedy nie używać interfejsu Directions API:

  • Rozpoczynasz nowy projekt w chmurze Google Cloud. Od października 2026 r. nie będzie można włączać interfejsu Directions API (starsza wersja) w nowych projektach. Zamiast tego użyj interfejsu Routes API.
  • Potrzebujesz nowych funkcji routingu i lepszej wydajności. Zamiast tego użyj interfejsu Routes API.
  • Potrzebujesz czasu podróży i odległości dla wielu punktów początkowych i docelowych w jednym żądaniu. Zamiast tego użyj interfejsu Routes API.

Directions API: konfiguracja

Directions API: typowe błędy

  • Problem: żądania do Directions API (starszej wersji) z projektu, w którym starsza wersja interfejsu API nie jest włączona, kończą się błędem LegacyApiNotActivatedMapError. Rozwiązanie: jeśli jesteś właścicielem aplikacji, przejdź na interfejs Routes API. Jako rozwiązanie krótkoterminowe podczas migracji lub oczekiwania na aktualizację aplikacji możesz aktywować starszy interfejs API, wypełniając formularz aktywacji starszego interfejsu API. Zobacz /maps/legacy.
  • Problem: użycie prefiksu via: w punktach pośrednich sprawia, że są one traktowane jako punkty, przez które trzeba przejechać, co może powodować znaczne objazdy lub stan ZERO_RESULTS. Rozwiązanie: używaj punktów pośrednich (bez prefiksu via:), chyba że wymagany jest ścisły punkt przejazdu. Zobacz /maps/documentation/directions/get-directions.
  • Problem: żądania z 11–25 punktami pośrednimi, optimize:true, czasem przejazdu uwzględniającym natężenie ruchu (duration_in_traffic) lub modyfikatorami lokalizacji side_of_road lub heading są rozliczane według wyższej stawki za kod SKU Directions Advanced (Pro). Rozwiązanie: korzystaj z tych funkcji tylko wtedy, gdy ich potrzebujesz. Aby pozostać w ramach SKU Essentials, nie przekraczaj liczby 10 punktów pośrednich i nie używaj parametrów optimize:true, departure_time (w przypadku jazdy samochodem), side_of_road i heading. Zobacz /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Problem: w przypadku jazdy samochodem parametr departure_time nie może być w przeszłości (żądanie nie powiedzie się i zostanie zwrócony błąd INVALID_REQUEST). Bez parametru departure_time trasa i czas trwania są obliczane na podstawie średniego natężenia ruchu niezależnego od czasu i nie jest zwracany parametr duration_in_traffic. Rozwiązanie: ustaw departure_time na now lub na przyszłą godzinę za pomocą mode=driving, aby uzyskać duration_in_traffic. Żądania, które zwracają duration_in_traffic, są rozliczane według kodu SKU Trasy – zaawansowane (Pro). Zobacz /maps/documentation/directions/get-directions.