Migracja z interfejsu Directions API lub Distance Matrix API

Z tego przewodnika dowiesz się, jak przenieść aplikacje, które korzystają z interfejsu Directions API lub Distance Matrix API, na korzystanie z interfejsu Routes API. Szczegółowe informacje o interfejsie Routes API znajdziesz w omówieniu tego produktu.

Te wskazówki obowiązują, jeśli korzystanie z interfejsu API jest na tyle intensywne, że kwalifikuje się do cen drugiego poziomu. Podczas migracji do nowszej wersji interfejsu API płacisz też za inny kod SKU. Aby uniknąć zwiększonych kosztów w miesiącu przejścia, zalecamy przejście na nowe interfejsy API w wersji produkcyjnej możliwie jak najbliżej początku miesiąca. Dzięki temu w miesiącu migracji będziesz korzystać z najbardziej opłacalnych poziomów cen miesięcznych. Informacje o poziomach cen znajdziesz na tej stronie oraz w artykule z odpowiedziami na najczęstsze pytania dotyczące cen.

Aktualizowanie punktów końcowych interfejsu API REST

Zaktualizuj kod, aby używać nowych punktów końcowych interfejsu Routes API

Z Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Z Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Konwertowanie parametrów adresu URL na dane w ciele żądania HTTPS

W przypadku interfejsów Directions API i Distance Matrix API właściwości konfiguracji są przekazywane jako parametry adresu URL do żądania HTTP GET. Na przykład w przypadku interfejsu Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

W przypadku interfejsu Routes API parametry przekazujesz w treści żądania lub w nagłówkach jako część żądania HTTP POST. Przykłady:

Konwertowanie punktów pośrednich zakodowanych jako linie łamane na punkty pośrednie z lokalizacją

interfejsie Directions API można określać punkty pośrednie jako zakodowane wielokąty, aby zmieścić dużą liczbę punktów pośrednich w ramach limitu adresu URL wynoszącego 16 384 znaki. Ta funkcja nie jest wymagana w interfejsie Routes API, ponieważ punkty pośrednie mogą być przesyłane w ciele żądania REST lub gRPC jako współrzędne szerokości i długości geograficznej. Przykłady znajdziesz w dokumentach Przykład HTTP w dokumentacji Obliczanie macierzy tras oraz Definiowanie punktu pośredniego w dokumentacji Określanie punktów pośrednich.

Konwertowanie parametrów

W tabeli poniżej znajdziesz parametry interfejsów Directions API i Distance Matrix API, które zostały zmienione lub zmodyfikowane, a także parametry, które nie są obsługiwane w tej wersji GA. Jeśli używasz któregoś z tych parametrów, zaktualizuj kod.

Konwersje parametru żądania

Parametr Trasa dojazdu lub Macierz odległości Parametr interfejsu Routes API Uwagi
alternatives computeAlternativeRoutes
arrival_time arrivalTime Dostępne tylko w trybie TRANSIT, a nie w tym samym czasie co departureTime.
avoid routeModifiers
departure_time departureTime Nie można ich używać jednocześnie.arrivalTime
language languageCode Obsługiwane tylko w przypadku tras obliczeniowych.
mode travelMode

Dodaliśmy obsługę właściwości TWO_WHEELER i TRANSIT.

optimize=true w przypadku punktów pośrednich "optimizeWaypointOrder": "true" Więcej informacji
region regionCode
traffic_model trafficModel Więcej informacji
transit_mode "travelMode": "TRANSIT" W interfejsie Directions API każdy odcinek trasy z tym samym trybem podróży (np. pieszo lub komunikacją zbiorową) jest traktowany jako jeden krok, a poszczególne wskazówki dotyczące tego trybu podróży są podawane w podkrokach. W interfejsie Routes API kroki to zawsze jedna instrukcja nawigacji dotycząca wszystkich rodzajów podróży. Każda instrukcja nawigacji to krok. W przypadku wielu kroków w jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie kroków w tym trybie w polu „stepsOverview”. Aby poprosić o te metadane, użyj maski pola „routes.legs.stepsOverview”. Więcej informacji
transit_routing_preference transitRoutingPreference Więcej informacji
units units Więcej informacji
waypoints intermediates Usunięto obsługę zaszyfrowanych wielokątów.

Konwersje parametrów odpowiedzi

Parametr Trasa dojazdu lub Macierz odległości Parametr interfejsu Routes API Uwagi
bounds viewport
copyrights

Nie uwzględniono w odpowiedzi. Wyświetlając wyniki użytkownikom, musisz dołączyć to oświadczenie:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2022 Google

distance distanceMeters Odległość jest dostępna tylko w metrach.
duration_in_traffic duration Usunięto w interfejsie Routes API, użyj duration.
geocoded_waypoints geocoding_results Obsługiwane tylko w przypadku tras obliczeniowych. Zawiera informacje o geokodowaniu tylko w przypadku punktów kontrolnych określonych jako adresy.
legs.end_address Niedostępne.
legs.start_address Niedostępne.
overview_polyline linia łamana
status Niedostępne. Używaj kodów odpowiedzi HTTP w przypadku błędów zgłaszanych przez interfejs API. Więcej informacji znajdziesz w artykule Przetwarzanie błędów żądań.
summary description
waypoint_order optimizedIntermediateWaypointIndex