Z tego przewodnika dowiesz się, jak przeprowadzić migrację aplikacji, które korzystają z interfejsu Directions API lub Distance Matrix API, do korzystania z interfejsu Routes API. Więcej informacji o interfejsie Routes API znajdziesz w omówieniu usługi.
Sprawdzone metody dotyczące płatności w przypadku migracji
Te wskazówki dotyczą sytuacji, gdy korzystasz z interfejsu API na tyle często, że kwalifikujesz się do cen drugiego poziomu. Podczas migracji do nowszej wersji interfejsu API opłaty są naliczane za inny kod SKU. Aby uniknąć wzrostu kosztów w miesiącu przejścia, zalecamy przejście na nowe interfejsy API w środowisku produkcyjnym jak najbliżej początku miesiąca. Dzięki temu w miesiącu migracji osiągniesz najbardziej opłacalne miesięczne progi cenowe. Więcej informacji o progach cenowych, znajdziesz na stronie z cennikiem i w odpowiedziach na najczęstsze pytania dotyczące cen.
Aktualizowanie punktów końcowych API (typu) REST
Zaktualizuj kod, aby używać nowych punktów końcowych interfejsu Routes API.
Z interfejsu Directions API
| Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
| Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
Z interfejsu 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 treść żądania HTTPS
W przypadku interfejsów Directions API i Distance Matrix API właściwości konfiguracyjne są przekazywane jako parametry adresu URL w żądaniu 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 są przekazywane w treści żądania lub w nagłówkach w ramach żądania HTTP POST. Przykłady:
Konwertowanie punktów pośrednich zakodowanych w postaci linii łamanych na punkty pośrednie lokalizacji
Określanie punktów pośrednich jako zakodowanych linii łamanych jest dostępne w interfejsie Directions API (wersja starsza), aby zmieścić dużą liczbę punktów pośrednich w limicie 16384 znaków w adresie URL. Ta funkcja nie jest potrzebna w interfejsie Routes API, ponieważ punkty pośrednie można przesyłać w treści żądania REST lub gRPC jako współrzędne geograficzne. Przykłady znajdziesz w sekcji Przykład HTTP w dokumencie Obliczanie macierzy tras lub w sekcji Definiowanie punktu pośredniego w dokumencie Określanie punktów pośrednich.
Konwertowanie parametrów
W tabelach poniżej znajdziesz parametry w interfejsach Directions API i Distance Matrix API, które zostały zmienione lub zmodyfikowane, oraz parametry, które nie są obsługiwane w wersji ogólnej dostępności. Jeśli używasz któregokolwiek z tych parametrów, zaktualizuj kod.
Konwersje parametrów żądania
| Parametr Directions lub macierz odległości | Parametr Routes API | Uwagi |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Dostępne tylko w trybie TRANSIT i nie jednocześnie z departureTime. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Nie można używać jednocześnie z arrivalTime. |
language |
languageCode |
Obsługiwane tylko w przypadku funkcji Compute Routes. |
mode |
travelMode |
Przekazywane w
|
region |
regionCode |
|
traffic_model |
trafficModel |
Więcej informacji |
transit_mode |
"travelMode": "TRANSIT" |
W interfejsie Directions API (wersja starsza) w przypadku trasy transportu publicznego każdy odcinek podróży z tym samym trybem podróży (np. pieszo lub transportem publicznym) jest traktowany jako jeden krok, a poszczególne wskazówki dotyczące tego trybu podróży znajdują się w podkrokach. Natomiast w interfejsie Routes API kroki są zawsze jedną instrukcją nawigacyjną we wszystkich typach podróży. Każda instrukcja nawigacyjna jest więc krokiem. W przypadku wielu kroków w jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie kroków dla tego trybu podróży 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ę zakodowanych linii łamanych. |
optimize=true w przypadku punktów pośrednich |
"optimizeWaypointOrder": "true" |
Więcej informacji |
Konwersje parametrów odpowiedzi
| Parametr Directions lub macierz odległości | Parametr Routes API | Uwagi |
|---|---|---|
copyrights |
Nie jest uwzględniony w odpowiedzi. Podczas wyświetlania wyników użytkownikom musisz uwzględnić to stwierdzenie:
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 funkcji Compute Routes. Zawiera informacje o odpowiedzi geokodowania tylko w przypadku punktów pośrednich określonych jako adresy. |
bounds |
viewport |
|
legs.end_address |
Niedostępne. | Aby uzyskać trasy o wysokiej dokładności, używaj identyfikatorów miejsc zamiast współrzędnych. Identyfikatory miejsc zawierają dane, które przyciągają trasę do prawidłowych punktów dostępu.
|
legs.start_address |
Niedostępne. | |
overview_polyline |
linia łamana | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |