Ten przewodnik opisuje, jak przenieść aplikacje korzystające z interfejsu Directions API lub Distance Matrix API na interfejs Routes API. Szczegółowe informacje o interfejsie Routes API znajdziesz w omówieniu produktu.
Sprawdzone metody dotyczące płatności w przypadku migracji
Te wskazówki obowiązują, jeśli Twoje wykorzystanie interfejsu API jest wystarczająco wysokie, aby przejść na ceny drugiego poziomu. Jeśli przejdziesz na nowszą wersję interfejsu API, będziesz też obciążany(-a) opłatą za inny numer SKU. Aby uniknąć wzrostu kosztów w miesiącu przejścia, zalecamy przełączenie się 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. Informacje o poziomach cenowych znajdziesz na stronie z cennikiem i w odpowiedziach 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 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 konfiguracji 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 interfejsie Routes API parametry przekazujesz w treści żądania lub w nagłówkach
w ramach żądania HTTP POST. Przykłady znajdziesz w tych artykułach:
Konwertowanie punktów pośrednich zakodowanych w postaci linii łamanej na punkty pośrednie lokalizacji
Określanie punktów pośrednich jako zakodowanych linii łamanych jest dostępne w interfejsie Directions API (starsza wersja), aby zmieścić dużą liczbę punktów pośrednich w limicie znaków adresu URL wynoszącym 16384. 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 szerokości i długości geograficznej. 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 interfejsów Directions API i Distance Matrix API, które zostały zmienione lub zmodyfikowane, oraz parametry, które nie są obsługiwane w wersji GA. Jeśli używasz któregoś z tych parametrów, zaktualizuj kod.
Konwersje parametrów żądania
| Parametr Trasa dojazdu lub Macierz odległości | Parametr Routes API | Uwagi |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Dostępny 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 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 (starsza wersja) w przypadku trasy transportu publicznego każdy odcinek podróży z tym samym rodzajem transportu (np. pieszo lub transportem publicznym) jest traktowany jako jeden krok, a poszczególne wskazówki dotyczące tego rodzaju transportu znajdują się w podkrokach. W przeciwieństwie do tego w interfejsie Routes API kroki zawsze zawierają jedną instrukcję nawigacyjną dla wszystkich rodzajów podróży. Każda instrukcja nawigacji to krok. W przypadku wielu kroków w ramach jednego środka transportu interfejs Routes API udostępnia metadane zawierające podsumowanie kroków dla tego środka transportu 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 polilinii. |
optimize=true dla punktów pośrednich |
"optimizeWaypointOrder": "true" |
Więcej informacji |
Konwersje parametrów odpowiedzi
| Parametr Trasa dojazdu lub Macierz odległości | Parametr Routes API | Uwagi |
|---|---|---|
copyrights |
Nie uwzględniono w odpowiedzi. Podczas wyświetlania wyników użytkownikom musisz zamieścić to oświadczenie:
Na przykład:
|
|
distance |
distanceMeters |
Odległość jest podawana tylko w metrach. |
duration_in_traffic |
duration |
Usunięto z Routes API. Używaj 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 sekcji Obsługa błędów żądań. | |
geocoded_waypoints |
geocoding_results |
Obsługiwane tylko w przypadku tras obliczeniowych. 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ć wysoce precyzyjne wyznaczanie trasy, używaj identyfikatorów miejsc zamiast współrzędnych. Identyfikatory miejsc zawierają dane, które dopasowują trasę do prawidłowych punktów dostępu.
|
legs.start_address |
Niedostępne. | |
overview_polyline |
linia łamana | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |