Przejście z interfejsu Directions API (starsza wersja) lub Distance Matrix API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Ten przewodnik opisuje, 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 korzystanie z interfejsu API jest na tyle intensywne, że kwalifikuje 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 interfejsu REST API

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 URL na treść żądania HTTPS

W przypadku interfejsów Directions API i Distance Matrix API właściwości konfiguracyjne są przekazywane jako parametry 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 ł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 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 GA. 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

Dodano obsługę trybów TWO_WHEELER i TRANSIT.
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 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 Distance Matrix Parametr Routes API Uwagi
copyrights

Nie jest uwzględniony w odpowiedzi. Podczas wyświetlania wyników użytkownikom musisz uwzględnić to stwierdzenie:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2022 Google
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.

  • Jeśli zaczynasz od adresu: użyj autouzupełniania miejsc lub interfejsu Geocoding API, aby przekształcić go w identyfikator miejsca.
  • Jeśli zaczynasz od współrzędnych: rozważ użycie wyszukiwania miejsc docelowych, aby podać bardziej znaczącą lokalizację. Uzyskanie adresu na podstawie współrzędnych może być skomplikowane i prowadzić do nieprawidłowego przyciągania. Interfejs Routes API nie wykonuje geokodowania odwrotnego współrzędnych na adresy.
legs.start_address Niedostępne.
overview_polyline linia łamana
summary description
waypoint_order optimizedIntermediateWaypointIndex