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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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. Podczas przechodzenia na nowszą wersję interfejsu API obciążamy Cię też za inny kod SKU. Aby uniknąć wzrostu kosztów w miesiącu przejścia na nowe interfejsy API, zalecamy jak najszybsze wdrożenie ich w środowisku produkcyjnym. 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 najczęstszych pytaniach dotyczących 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 konfiguracyjne przekazujesz 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 polilinii 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 pośredniego punktu na trasie w dokumencie Określanie pośrednich punktów na trasie.

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 TWO_WHEELER i TRANSIT.
region regionCode
traffic_model trafficModel Więcej informacji
transit_mode "travelMode": "TRANSIT" W przypadku interfejsu Directions API (starszego) w trasie transportu publicznego każdy segment 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 jednym trybie podróży interfejs Routes API udostępnia metadane zawierające podsumowanie kroków w danym trybie 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 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:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2022 Google
distance distanceMeters Odległość jest podawana tylko w metrach.
duration_in_traffic duration Usunięto z interfejsu 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 obliczeniowych. Zawiera informacje o odpowiedzi geokodowania tylko w przypadku punktów pośrednich 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