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.

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ą

W 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 drogi można przesyłać 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 parametrów żą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.
language languageCode Obsługiwane tylko w przypadku tras obliczeniowych.
mode travelMode

Dodaliśmy obsługę właściwości TWO_WHEELER i TRANSIT.
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 ścieżek wielokątów.
optimize=true dla punktów pośrednich "optimizeWaypointOrder": "true" Więcej informacji

Konwersje parametrów odpowiedzi

Parametr Trasa dojazdu lub macierz odległości Parametr interfejsu Routes API Uwagi
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.
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 Radzenie sobie z błędami żądań.
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.
bounds viewport
legs.end_address Niedostępne.
legs.start_address Niedostępne.
overview_polyline linia łamana
summary description
waypoint_order optimizedIntermediateWaypointIndex