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

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

Примечание. Если вы использовали предварительную версию API Routes, см. раздел «Миграция с предварительной версии на общедоступную версию» для получения информации о переходе на общедоступную версию.

Обновите конечные точки 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