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
- Usługa do włączenia:
directions-backend.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Pierwsze kroki: skonfiguruj Directions API
- Dokumentacja: dokumentacja Directions API
- Ceny: korzystanie z interfejsu Directions API i płatności
- Zasady: zasady dotyczące interfejsu Directions API
- Informacje o wersjach: informacje o wersjach interfejsu Directions API
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 stanZERO_RESULTS. Rozwiązanie: używaj punktów pośrednich (bez prefiksuvia:), 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 lokalizacjiside_of_roadlubheadingsą 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ówoptimize:true,departure_time(w przypadku jazdy samochodem),side_of_roadiheading. Zobacz /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problem: w przypadku jazdy samochodem parametr
departure_timenie może być w przeszłości (żądanie nie powiedzie się i zostanie zwrócony błądINVALID_REQUEST). Bez parametrudeparture_timetrasa i czas trwania są obliczane na podstawie średniego natężenia ruchu niezależnego od czasu i nie jest zwracany parametrduration_in_traffic. Rozwiązanie: ustawdeparture_timenanowlub 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.