Migracja z interfejsu Directions API lub Distance Matrix API

W tym przewodniku opisano przenoszenie aplikacji korzystających z: Directions API lub Reach Matrix API do korzystania z Interfejs Routes API. Szczegółowe informacje o interfejsie Routes API znajdziesz w opisie usługi .

Zaktualizuj punkty końcowe 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

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

Przekonwertuj parametry adresu URL, aby używać treści żądania HTTPS

Dzięki interfejsom Directions API oraz YouTube Reach Matrix API przekazywać właściwości konfiguracji jako parametry adresu URL do żądania HTTP GET. Dla: przykład dla interfejsu Directions API:

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

Interfejs Routes API przekazuje parametry w treści żądania lub w nagłówkach w ramach żądania HTTP POST. Przykłady:

Konwertuj punkty pośrednie zakodowane za pomocą linii łamanych na punkty pośrednie lokalizacji

Określanie punktów pośrednich jako zakodowanych linii łamanych jest dostępne w Directions API liczby punktów pośrednich w limicie 16 384 znaków. Ta funkcja nie jest niezbędną w interfejsie Routes API, ponieważ punkty pośrednie mogą być przesyłane Treść żądania REST lub gRPC jest podana jako współrzędne szerokości i długości geograficznej. Na przykład: zobacz Przykład 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 parametry w funkcji Directions API oraz DISTANCE Matrix API, które mają których nazwa została zmieniona lub które zostały zmodyfikowane, albo parametry nieobsługiwane przez GA wersji. 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 – nie w tym samym trybie czas jako 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 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 każda trasa transportu publicznego segment podróży tym samym środkiem transportu (np. Pieszo lub Transport publiczny) jest uważany za jeden etap, a indywidualne wskazówki dojazdu w których poszczególne środki transportu są uwzględniane. W polu Interfejs Routes API, kroki są jedną instrukcją nawigacji do każdego rodzaju podróży. Każda instrukcja nawigacji to kolejny krok. W przypadku wielu etapów w jednym trybie podróży interfejs Routes API zapewnia metadanych, które zawierają podsumowanie czynności dla danego środka transportu, w `stepsOverview`. Aby zażądać tych metadanych, użyj funkcji Maska pola „routes.legs.stepsOverview”. Więcej informacji
transit_routing_preference transitRoutingPreference Więcej informacji
units Niedostępne dla macierzy tras.
waypoints intermediates Usunęliśmy obsługę zakodowanych linii łamanych.
optimize=true dla punktów pośrednich "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. Musisz uwzględnić te informacje: przy wyświetlaniu wyników użytkownikom:

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 do zgłoszonych przez interfejs API błędów. Patrz sekcja Obsługa błędów żądań .
geocoded_waypoints geocoding_results Obsługiwane tylko w przypadku tras Compute. Zawiera informacje o odpowiedzi na geokodowanie tylko dla punktów pośrednich 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