Migracja z interfejsu Directions API lub Distance Matrix API

Z tego przewodnika dowiesz się, jak przenieść aplikacje korzystające z interfejsu Directions API lub Distance Matrix API do interfejsu Routes API. Więcej informacji o interfejsie Routes API znajdziesz w omówieniu usługi.

Aktualizowanie punktów końcowych interfejsu API REST

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

Z interfejsu Directions API

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

Z interfejsu Distance Matrix API

Odległość Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Interfejs Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Konwertowanie parametrów adresu URL na treść żądania HTTPS

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

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

Za pomocą interfejsu Routes API możesz przekazywać parametry w treści żądania lub w nagłówkach w ramach żądania HTTP POST. Przykłady:

Konwertuj punkty na trasie zakodowane za pomocą linii łamanej na punkty na trasie lokalizacji

Punkty na trasie jako zakodowane linie łamane można określać w interfejsie Directions API w celu dopasowania dużej liczby punktów pośrednich w adresie URL wynoszącym 16 384 znaki. Ta funkcja nie jest potrzebna w interfejsie Routes API, ponieważ punkty pośrednie mogą być przesyłane w treści żądania REST lub gRPC jako współrzędne szerokości i długości geograficznej. Przykłady znajdziesz w przykładzie HTTP w dokumencie Obliczanie macierzy tras lub Definiowanie pośredniego punktu pośredniego w dokumencie Określanie pośrednich punktów pośrednich.

Konwertuj parametry

W tabelach poniżej znajdziesz listę parametrów w interfejsach Directions API i Distance Matrix API, których nazwy zostały zmienione lub zmodyfikowane, albo parametrów, które nie są obsługiwane w danej wersji Google Analytics. Jeśli używasz któregoś z tych parametrów, zaktualizuj swój kod.

Konwersje parametru żądania

Kierunki lub parametr macierzy odległości Parametr interfejsu Routes API Uwagi
alternatives computeAlternativeRoutes
arrival_time arrivalTime Dostępna tylko w trybie TRANSIT, nie w tym samym czasie co departureTime.
avoid routeModifiers
departure_time departureTime Nie można używać jednocześnie z tagiem arrivalTime.
language languageCode Obsługiwane tylko w przypadku tras Compute.
mode travelMode

Dodano obsługę TWO_WHEELER i TRANSIT.
region regionCode
traffic_model trafficModel Więcej informacji
transit_mode "travelMode": "TRANSIT" W interfejsie Directions API w przypadku trasy transportu publicznego każdy segment podróży z tym samym środkiem transportu (np. pieszo lub transportem publicznym) jest traktowany jako jeden krok, a poszczególne wskazówki w przypadku tego środka transportu są podane w podetapach. Natomiast w interfejsie Routes API kroki są spójnie na jednej instrukcji nawigacji we wszystkich typach podróży. Każda instrukcja nawigacji to krok. Dla wielu kroków w jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie czynności w danym trybie podróży w obiekcie „stepsOverview”. Aby zażądać tych metadanych, użyj maski pola „routes.legs.stepsOverview”. Więcej informacji
transit_routing_preference transitRoutingPreference Więcej informacji
units Niedostępne dla macierzy tras.
waypoints intermediates Usunięto obsługę kodowanych linii łamanych.
optimize=true dla punktów na trasie "optimizeWaypointOrder": "true" Więcej informacji

Konwersje parametrów odpowiedzi

Kierunki lub parametr macierzy odległości Parametr interfejsu Routes API Uwagi
copyrights

Nieuwzględnione w odpowiedzi. Podczas wyświetlania wyników użytkownikom musisz uwzględnić to oświadczenie:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2022 Google
distance distanceMeters Odległość jest podana 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 sekcji Obsługa błędów żądań.
geocoded_waypoints geocoding_results Obsługiwane tylko w przypadku tras Compute. Zawiera odpowiedź geokodowania tylko dla punktów na trasie 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