Migracja z interfejsu Directions API lub Distance Matrix API

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

Zaktualizuj punkty końcowe interfejsu API REST

Zaktualizuj kod, aby używać nowych punktów końcowych 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

Interfejs 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

Interfejs Routes API służy do przekazywania parametrów w treści żądania lub w nagłówkach w ramach żą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ślić punkty pośrednie jako zakodowane linie łamane. Pozwalają one dopasować dużą liczbę punktów pośrednich do 16 384 znaków w adresie URL. 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.

Konwertuj parametry

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óregokolwiek z tych parametrów, zaktualizuj kod.

Poproś o konwersje parametrów

Kierunki jazdy lub parametr matrycy 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 używać jednocześnie z usługą arrivalTime.
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 kolejny krok. W przypadku wielu kroków w jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie kroków dla danego środka transportu w sekcji „stepsOverview”. Aby zażądać tych metadanych, 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.
optimize=true dla punktów na trasie "optimizeWaypointOrder": "true" Więcej informacji

Konwersje parametru odpowiedzi

Kierunki jazdy lub parametr matrycy 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. W przypadku błędów zgłaszanych przez interfejs API używaj kodów odpowiedzi HTTP. Więcej informacji znajdziesz w artykule Przetwarzanie błędów żądań.
geocoded_waypoints geocoding_results Obsługiwane tylko w przypadku tras Compute. 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