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
- Usługa do włączenia:
routes.googleapis.com - Uwierzytelnianie: klucz interfejsu API, OAuth 2.0, konto usługi.
- Pierwsze kroki: konfigurowanie interfejsu Routes API
- Dokumentacja: dokumentacja Routes API
- Ceny: użycie interfejsu Routes API i płatności
- Zasady: zasady dotyczące interfejsu Routes API
- Informacje o wersjach: informacje o wersjach interfejsu Routes API
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: produkty powiązane
- Zastępuje: Directions API, Distance Matrix API
- Często używane z: Navigation SDK for Android, Navigation SDK for iOS, Route Optimization API, Geocoding API, Places API (New)
Routes API: typowe błędy
- Problem: nie ma domyślnej listy zwracanych pól. Żądania bez maski pola (nagłówek
X-Goog-FieldMasklub 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
routingPreferencetoTRAFFIC_AWARE_OPTIMAL. Rozwiązanie: podczas korzystania zTRAFFIC_AWARE_OPTIMALutrzymuj 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.
- Zwracaj wskazówki dojazdu między co najmniej 2 współrzędnymi szerokości i długości geograficznej jako serię współrzędnych dla każdego kroku na trasie.
- Zwracaj wskazówki dojazdu między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej w postaci serii opisów manewrów na poszczególnych etapach trasy.
- Zwraca odległość między poszczególnymi etapami trasy między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracaj czas podróży między poszczególnymi etapami trasy między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracaj zakodowaną linię łamaną między każdym krokiem na trasie między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracanie odległości na trasie między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracanie czasu podróży na trasie między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracanie zakodowanej linii łamanej dla trasy między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Zwracanie informacji o opłatach za przejazd na trasie między co najmniej 2 zestawami współrzędnych szerokości i długości geograficznej.
- Określ środek transportu (samochód, transport publiczny, pieszo, motocykl) w żądaniu trasy. Uwaga: w usłudze internetowej Routes API (computeRoutes) przekaż parametr travelMode w treści HTTP POST JSON, używając RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT lub TRUCK z routeModifiers.vehicleInfo) i dołącz wymagany nagłówek X-Goog-FieldMask zamiast starszego parametru zapytania trybu GET. W bibliotece tras interfejsu Maps JavaScript API przekaż travelMode i pola w ComputeRoutesRequest.
- Określ przystanek lub punkt, przez który ma przebiegać trasa.
- Określ, jak dane o natężeniu ruchu mają być używane w żądaniu trasy.
- Określ elementy, których chcesz unikać, np. autostrady lub opłaty, w żądaniu trasy.
- Ustawianie punktów na trasie.
- Ustawianie punktów pośrednich na trasie
- Ustaw punkt, przez który ma przebiegać trasa.
- Określ kierunek jazdy pojazdu i stronę drogi na trasie.
- Optymalizuj kolejność przystanków na trasie.
- Określ trasę przyjazną dla środowiska w żądaniu trasy. Podgląd
- Określ krótszy dystans lub alternatywną trasę w żądaniu trasy. Uwaga: w Routes API żądanie krótszej trasy referencyjnej (SHORTER_DISTANCE) jest funkcją eksperymentalną, a żądanie tras alternatywnych (computeAlternativeRoutes) jest funkcją ogólnodostępną.
- Zwracaj odległości dla macierzy tras między wieloma punktami początkowymi i docelowymi.
- Zwracaj czasy podróży dla macierzy tras między wieloma punktami początkowymi i docelowymi.
- Zwracaj informacje o opłatach drogowych dla macierzy tras między wieloma punktami początkowymi i docelowymi.
- Określ tryb podróży (samochód, transport publiczny, pieszo, motocykl) w żądaniu macierzy tras. Uwaga: w usłudze internetowej Routes API (computeRouteMatrix) przekaż travelMode w treści żądania HTTP POST JSON, używając RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT lub TRUCK z origins[].routeModifiers.vehicleInfo; BICYCLE nie jest obsługiwany w przypadku macierzy tras) i dołącz wymagany nagłówek X-Goog-FieldMask. W bibliotece tras interfejsu Maps JavaScript API przekaż travelMode i pola w ComputeRouteMatrixRequest.