Z tego przewodnika dowiesz się, jak przenieść do interfejsu Routes API aplikacje korzystające z interfejsu Directions API lub Reach Matrix API. Szczegółowe informacje o interfejsie Routes API znajdziesz w omówieniu 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
Korzystając z interfejsów Directions API i interfejsu Reach Matrix API, przekazujesz do żądania HTTP GET
właściwości konfiguracji jako parametry adresu URL. Na przykład w przypadku 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ś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 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 Compute matryca tras lub w sekcji 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 interfejsach Directions API oraz Reach Matrix API, które zmieniły nazwę lub które zostały zmodyfikowane, a także parametry, które nie są obsługiwane w wersji Google Analytics. 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 | Notatki |
---|---|---|
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 Compute. |
mode |
travelMode |
Dodano obsługę |
region |
regionCode |
|
traffic_model |
trafficModel |
Więcej informacji |
transit_mode |
"travelMode": "TRANSIT" |
W interfejsie Directions API na trasie transportu publicznego każdy etap podróży z tym samym środkiem transportu (np. Pieszo lub Transport publiczny) jest uznawany za jeden etap, a poszczególne wskazówki dojazdu dla tego środka transportu są przedstawiane w podetapach. W interfejsie Routes API kroki są natomiast spójną instrukcją nawigacji w przypadku 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”. Dowiedz się więcej. |
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 | Notatki |
---|---|---|
copyrights |
Nie uwzględniono w odpowiedzi. Przy wyświetlaniu wyników użytkownikom musisz dołączyć to oświadczenie:
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. 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 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 |