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 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 i interfejsowi 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

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 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

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ż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 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. 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łaszanych przez ten interfejs błędów. 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 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