Krótkie podsumowanie informacji o Routes API

Routes API to usługa sieciowa z 2 metodami: Compute Routes zwraca trasę między 2 lokalizacjami z opcjonalnymi punktami pośrednimi, a Compute Route Matrix zwraca odległość i czas podróży dla kombinacji punktów początkowych i docelowych (maksymalnie 625 elementów macierzy tras).

Routes API: najważniejsze informacje

  • Usługa: Routes API
  • Inne nazwy: Routes API v2, Compute Routes, Compute Route Matrix
  • Kategoria: Trasy
  • Platforma: usługa internetowa (REST)
  • Działa na: serwerze (kod backendu)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie interfejsu Routes API
  • Dostępność: cały świat. Wyznaczanie tras dla jednośladów, trasy przyjazne dla środowiska i obliczanie opłat są dostępne tylko w obsługiwanych krajach i miastach. Terytoria zależne z własnym kodem CLDR nie są obsługiwane, chyba że są wymienione na liście. W przypadku adresów rozliczeniowych w Europejskim Obszarze Gospodarczym (EOG) warunki obowiązujące w EOG (https://developers.google.com/maps/comms/eea/routes) zabraniają używania opisów tras lub kroków na jakiejkolwiek mapie. (szczegóły dotyczące zakresu ochrony)

Routes API: kiedy z niego korzystać

Kiedy używać interfejsu Routes API:

  • Potrzebujesz trasy między miejscem początkowym a docelowym z opcjonalnymi punktami pośrednimi dla samochodu, pieszego, roweru, pojazdu dwukołowego lub transportu publicznego.
  • Potrzebujesz odległości i czasu podróży dla wielu par punktów początkowych i docelowych w jednym żądaniu (maksymalnie 625 elementów).
  • Potrzebujesz szacunkowych opłat za przejazd (wybrane miasta), tras przyjaznych dla środowiska (wybrane regiony), linii łamanych uwzględniających natężenie ruchu lub tras dla dużych pojazdów (ograniczona dostępność).
  • Migrujesz aplikację serwerową ze starszej wersji interfejsu Directions API lub Distance Matrix API.

Nie używaj interfejsu Routes API, gdy:

  • Musisz zoptymalizować przypisanie ładunków i kolejność przystanków dla całej floty pojazdów. Zamiast tego użyj interfejsu Route Optimization API.
  • Potrzebujesz szczegółowych wskazówek dojazdu w aplikacji na Androida, które będą zgodne z obliczoną trasą. Zamiast tego użyj pakietu Navigation SDK na Androida.
  • Potrzebujesz szczegółowej nawigacji w aplikacji na iOS, która podąża wyznaczoną trasą. Zamiast tego użyj pakietu Navigation SDK na iOS.

Routes API: konfiguracja

Oficjalne pakiety Routes API:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

Routes API: typowe błędy

  • Problem: nie ma domyślnej listy zwracanych pól. Żądania bez maski pola (nagłówek X-Goog-FieldMask lub parametr $fields) zwracają błąd. Rozwiązanie: zawsze wysyłaj maskę pola z listą potrzebnych pól odpowiedzi. Zobacz /maps/documentation/routes/choose_fields.
  • Problem: używanie maski pola z symbolem wieloznacznym (*) w środowisku produkcyjnym zwiększa koszty i opóźnienia, a koszty mogą nieoczekiwanie wzrosnąć, gdy do odpowiedzi zostaną dodane nowe funkcje zaawansowane. Rozwiązanie: używaj * tylko podczas programowania. W środowisku produkcyjnym żądaj tylko tych pól, których potrzebujesz. Zobacz /maps/documentation/routes/choose_fields.
  • Problem: informacje o opłatach i zużyciu paliwa nie są zwracane po dodaniu ich do maski pola. Od momentu ogólnej dostępności muszą być wyraźnie włączone. Rozwiązanie: dodaj do żądania tablicę extraComputations (np. TOLLS, FUEL_CONSUMPTION) oprócz maski pola. Zobacz /maps/documentation/routes/migrate-routes-preview.
  • Problem: Compute Route Matrix pozwala na 625 elementów, ale tylko na 100 elementów, gdy routingPreference to TRAFFIC_AWARE_OPTIMAL. Rozwiązanie: podczas korzystania z TRAFFIC_AWARE_OPTIMAL utrzymuj liczbę miejsc początkowych x miejsc docelowych na poziomie nieprzekraczającym 100 lub podziel żądanie. Zobacz /maps/documentation/routes/compute_route_matrix.

Co możesz robić za pomocą interfejsu Routes API

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.