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 omówieniu tego produktu.
Sprawdzone metody dotyczące płatności w przypadku migracji
Te wskazówki obowiązują, jeśli korzystanie z interfejsu API jest na tyle intensywne, że kwalifikuje się do cen drugiego poziomu. Podczas migracji do nowszej wersji interfejsu API płacisz też za inny kod SKU. Aby uniknąć zwiększonych kosztów w miesiącu przejścia, zalecamy przejście na nowe interfejsy API w wersji produkcyjnej możliwie jak najbliżej początku miesiąca. Dzięki temu w miesiącu migracji będziesz korzystać z najbardziej opłacalnych poziomów cen miesięcznych. Informacje o poziomach cen znajdziesz na tej stronie oraz w artykule z odpowiedziami na najczęstsze pytania dotyczące cen.
Aktualizowanie punktów końcowych interfejsu API REST
Zaktualizuj kod, aby używać nowych punktów końcowych interfejsu Routes API
Z Directions API
| Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
| Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
Z Distance Matrix API
| Distance Matrix API | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
| Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Konwertowanie parametrów adresu URL na dane w ciele żądania HTTPS
W przypadku interfejsów Directions API i Distance Matrix API właściwości konfiguracji są przekazywane jako parametry adresu URL do żądania HTTP GET. Na przykład w przypadku interfejsu Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
W przypadku interfejsu Routes API parametry przekazujesz w treści żądania lub w nagłówkach jako część żądania HTTP POST. Przykłady:
Konwertowanie punktów pośrednich zakodowanych jako linie łamane na punkty pośrednie z lokalizacją
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 wymagana w interfejsie Routes API, ponieważ punkty pośrednie mogą być przesyłane w ciele żądania REST lub gRPC jako współrzędne szerokości i długości geograficznej. Przykłady znajdziesz w dokumentach Przykład HTTP w dokumentacji Obliczanie macierzy tras oraz Definiowanie punktu pośredniego w dokumentacji Określanie punktów pośrednich.
Konwertowanie parametrów
W tabeli poniżej znajdziesz parametry interfejsów Directions API i Distance Matrix API, które zostały zmienione lub zmodyfikowane, a także parametry, które nie są obsługiwane w tej wersji GA. Jeśli używasz któregoś z tych parametrów, zaktualizuj kod.
Konwersje parametru żądania
| Parametr Trasa dojazdu lub Macierz odległości | Parametr interfejsu Routes API | Uwagi |
|---|---|---|
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 ich używać jednocześnie.arrivalTime |
language |
languageCode |
Obsługiwane tylko w przypadku tras obliczeniowych. |
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żdy odcinek trasy z tym samym trybem podróży (np. pieszo lub komunikacją zbiorową) jest traktowany jako jeden krok, a poszczególne wskazówki dotyczące tego trybu podróży są podawane w podkrokach. W interfejsie Routes API kroki to zawsze jedna instrukcja nawigacji dotycząca wszystkich rodzajów podróży. Każda instrukcja nawigacji to krok. W przypadku wielu kroków w jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie kroków w tym trybie w polu „stepsOverview”. Aby poprosić o te metadane, użyj maski pola „routes.legs.stepsOverview”. Więcej informacji |
transit_routing_preference |
transitRoutingPreference |
Więcej informacji |
units |
units |
Więcej informacji |
waypoints |
intermediates |
Usunięto obsługę zaszyfrowanych wielokątów. |
optimize=true w przypadku punktów pośrednich |
"optimizeWaypointOrder": "true" |
Więcej informacji |
Konwersje parametrów odpowiedzi
| Parametr Trasa dojazdu lub Macierz odległości | Parametr interfejsu Routes API | Uwagi |
|---|---|---|
copyrights |
Nie uwzględniono w odpowiedzi. Wyświetlając wyniki 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. Używaj kodów odpowiedzi HTTP w przypadku błędów zgłaszanych przez interfejs API. Więcej informacji znajdziesz w artykule Przetwarzanie błędów żądań. | |
geocoded_waypoints |
geocoding_results |
Obsługiwane tylko w przypadku tras obliczeniowych. Zawiera informacje o geokodowaniu tylko w przypadku punktów kontrolnych 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 |