В этом руководстве описывается, как перенести приложения, использующие Directions API или Distance Matrix API, на использование Routes API. Подробную информацию об API маршрутов см. в обзоре продукта .
Рекомендации по выставлению счетов за миграцию
Это руководство применимо, если уровень использования API достаточно высок для перехода на цены второго уровня. При переходе на более новую версию API вам также будет выставлен счет за другой номер SKU. Чтобы избежать увеличения затрат в течение месяца перехода, мы рекомендуем перейти на новые 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 |