В этом руководстве описывается, как перенести приложения, использующие 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 | Добавлена поддержка |
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 | Не включено в ответ. При отображении результатов пользователям необходимо включить следующее утверждение: Например: | |
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 |
В этом руководстве описывается, как перенести приложения, использующие 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 | Добавлена поддержка |
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 | Не включено в ответ. При отображении результатов пользователям необходимо включить следующее утверждение: Например: | |
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 |