Ten przewodnik opisuje, jak przenieść aplikacje, które używają interfejsu Directions API lub Distance Matrix API, na interfejs Routes API. Szczegółowe informacje o interfejsie Routes API znajdziesz w opisie usługi.
Sprawdzone metody dotyczące płatności podczas migracji
Te wskazówki mają zastosowanie, jeśli wykorzystanie interfejsu API jest na tyle wysokie, że kwalifikuje się do cen na drugim poziomie. 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 uzyskasz najbardziej opłacalne poziomy cen miesięcznych. Informacje o poziomach cen znajdziesz na stronie z cenami i w odpowiedziach na najczęstsze pytania dotyczące cen.
Aktualizowanie punktów końcowych interfejsu API typu REST
Zaktualizuj kod, aby używać nowych punktów końcowych 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 treść żądania HTTPS
W przypadku interfejsów Directions API i Distance Matrix API właściwości konfiguracji przekazujesz 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 w ramach żądania HTTP POST. Przykłady:
Konwertowanie punktów pośrednich zakodowanych jako linia łamana na punkty pośrednie lokalizacji
Określanie punktów pośrednich jako zakodowanych linii łamanych jest dostępne w Directions API (starsza wersja), aby zmieścić dużą liczbę punktów pośrednich w limicie adresu URL wynoszącym 16 384 znaki. Ta funkcja nie jest konieczna w 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 sekcji Przykład HTTP w dokumencie Obliczanie macierzy tras lub w sekcji Definiowanie punktu pośredniego w dokumencie Określanie punktów pośrednich.
Parametry konwersji
W tabelach poniżej wymieniono 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 z parametrem żądania
| Parametr trasy lub macierzy odległości | Parametr interfejsu 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 tras Compute. |
mode |
travelMode |
Przekazywane w treści żądania HTTP |
region |
regionCode |
|
traffic_model |
trafficModel |
Więcej informacji |
transit_mode |
"travelMode": "TRANSIT" |
W Directions API (starsza wersja) w przypadku trasy transportu publicznego każdy odcinek podróży z tym samym środkiem transportu (np. pieszo lub transportem publicznym) jest traktowany jako jeden krok, a poszczególne wskazówki dotyczące tego środka transportu są podane w podkrokach. W interfejsie Routes API kroki są zawsze jedną instrukcją nawigacji we wszystkich typach podróży. Każda instrukcja nawigacji 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 |
Usunęliśmy obsługę zakodowanych linii łamanych. |
optimize=true – punkty pośrednie |
"optimizeWaypointOrder": "true" |
Więcej informacji |
Konwersje z parametrem odpowiedzi
| Parametr trasy lub macierzy odległości | Parametr interfejsu Routes API | Uwagi |
|---|---|---|
copyrights |
Nie uwzględniono w odpowiedzi. Podczas wyświetlania wyników użytkownikom musisz dołączyć to oświadczenie:
Na przykład:
|
|
distance |
distanceMeters |
Odległość jest podawana tylko w metrach. |
duration_in_traffic |
duration |
Usunięto w 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 sekcji Obsługa błędów żądań. | |
geocoded_waypoints |
geocoding_results |
Obsługiwane tylko w przypadku tras Compute. 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ć bardzo dokładne wskazówki dojazdu, 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 |