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 |
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:
Na przykład:
|
|
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 |