Миграция с Directions API или Distance Matrix API

В этом руководстве описывается, как перенести приложения, использующие Directions API или Distance Matrix API, на использование Routes API. Подробную информацию об API маршрутов см. в обзоре продукта .

Обновите конечные точки REST API.

Обновите свой код, чтобы использовать новые конечные точки API маршрутов.

Из API маршрутов

API маршрутов https://maps.googleapis.com/maps/api/directions/ outputFormat ? parameters
API маршрутов https://routes.googleapis.com/directions/v2:computeRoutes

Из API матрицы расстояний

API матрицы расстояний https://maps.googleapis.com/maps/api/distancematrix/ outputFormat ? parameters
API маршрутов https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Преобразование параметров URL-адреса для использования тела запроса HTTPS

С помощью Directions API и Distance Matrix API вы передаете свойства конфигурации в качестве параметров URL-адреса в HTTP GET . Например, для API направлений:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

С помощью Routes API вы передаете параметры в теле запроса или в заголовках как часть запроса HTTP POST . Примеры см.:

Преобразование путевых точек, закодированных полилиниями, в путевые точки местоположения

Указание путевых точек в виде закодированных полилиний доступно в Directions API, что позволяет разместить большое количество путевых точек в пределах URL-адреса длиной в 16 384 символа. Эта функция не требуется в API маршрутов, поскольку путевые точки могут передаваться в теле запроса REST или gRPC как координаты широты и долготы. Примеры см. в разделе «Пример HTTP» в документе «Вычислить матрицу маршрута» или «Определить промежуточную точку маршрута» в документе «Указать промежуточные точки маршрута» .

Преобразование параметров

В следующих таблицах перечислены параметры API Directions и Distance Matrix API, которые были переименованы или изменены, а также параметры, которые не поддерживаются в общедоступной версии. Обновите свой код, если вы используете какой-либо из этих параметров.

Запросить преобразование параметров

Параметр матрицы направлений или расстояний Параметр API маршрутов Примечания
alternatives computeAlternativeRoutes
arrival_time arrivalTime Доступно только в режиме TRANSIT , а не одновременно с параметром departureTime .
avoid routeModifiers
departure_time departureTime Невозможно использовать одновременно с arrivalTime .
language languageCode Поддерживается только для вычислительных маршрутов.
mode travelMode

Добавлена ​​поддержка TWO_WHEELER и TRANSIT .

region regionCode
traffic_model trafficModel Узнать больше
transit_mode "travelMode": "TRANSIT" В API направлений в транзитном маршруте каждый сегмент поездки с одним и тем же режимом передвижения (например, «Пешеходный» или «Транзит») считается одним шагом, а отдельные направления для этого режима передвижения разделены на подэтапы. Напротив, в API маршрутов шаги представляют собой единую навигационную инструкцию для всех типов путешествий. Таким образом, каждая инструкция навигации — это шаг. Для нескольких шагов в одном режиме путешествия API маршрутов предоставляет метаданные, содержащие сводку шагов для этого режима путешествия, в `stepsOverview`. Чтобы запросить эти метаданные, используйте маску поля «routes.legs.stepsOverview». Узнать больше .
transit_routing_preference transitRoutingPreference Узнать больше
units units Узнать больше
waypoints intermediates Удалена поддержка закодированных полилиний .
optimize=true для путевых точек "optimizeWaypointOrder": "true" Узнать больше

Преобразования параметров ответа

Параметр матрицы направлений или расстояний Параметр API маршрутов Примечания
copyrights

Не включено в ответ. При отображении результатов пользователям необходимо включить следующее утверждение:

Powered by Google, © YEAR Google

Например:

Powered by Google, ©2022 Google

distance distanceMeters Расстояние доступно только в метрах.
duration_in_traffic duration Удален в API маршрутов, используйте duration .
status Нет в наличии. Используйте коды ответов HTTP для ошибок, о которых сообщает API. Дополнительные сведения см. в разделе Обработка ошибок запроса .
geocoded_waypoints geocoding_results Поддерживается только для вычислительных маршрутов. Содержит информацию ответа геокодирования только для путевых точек, указанных в качестве адресов.
bounds viewport
legs.end_address Нет в наличии.
legs.start_address Нет в наличии.
overview_polyline полилиния
summary description
waypoint_order optimizedIntermediateWaypointIndex