В этом руководстве описывается, как перенести приложения, использующие Directions API или Distance Matrix API, на использование Routes API. Подробнее об Routes API см. в обзоре продукта .
Лучшие практики выставления счетов для миграции
Это руководство применимо, если использование API достаточно высоко для перехода на цены второго уровня. При переходе на более новую версию API вам также выставляется счет за другой SKU. Чтобы избежать увеличения расходов в течение месяца перехода, мы рекомендуем переходить на новые API в производстве как можно ближе к началу месяца. Это гарантирует, что вы достигнете наиболее экономически эффективных ежемесячных ценовых уровней в течение месяца миграции. Информацию о ценовых уровнях см. на странице ценообразования и в разделе часто задаваемых вопросов о ценах .
Обновите конечные точки REST API
Обновите свой код для использования новых конечных точек API Routes.
Из 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 . Например, для Directions API:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
С помощью API Routes вы передаете параметры в теле запроса или в заголовках как часть запроса HTTP POST . Примеры см.:
Преобразовать путевые точки, закодированные в виде полилиний, в путевые точки местоположения
Указание точек маршрута в виде закодированных полилиний доступно в API Directions (Legacy) для размещения большого количества точек маршрута в ограничении URL в 16384 символа. Эта функция не является обязательной в API Routes, поскольку точки маршрута могут передаваться в теле запроса REST или gRPC как координаты широты/долготы. Примеры см. в примере HTTP в документе Compute a route matrix или в разделе Define an intermediate waypoint в документе Specify intermediate waypoints .
Преобразовать параметры
В следующих таблицах перечислены параметры в API Directions и API Distance Matrix, которые были переименованы или изменены, или параметры, которые не поддерживаются в выпуске GA. Обновите свой код, если вы используете какой-либо из этих параметров.
Запросить преобразование параметров
| Параметр матрицы направлений или расстояний | Параметр 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 Directions (Legacy) в транзитном маршруте каждый сегмент поездки с тем же режимом передвижения (например, Пешком или Транзитом) считается одним шагом, а отдельные указания для этого режима передвижения находятся в подшагах. Напротив, в API Routes шаги последовательно представляют собой одну навигационную инструкцию для всех типов передвижения. Таким образом, каждая навигационная инструкция является шагом. Для нескольких шагов в одном режиме передвижения API Routes предоставляет метаданные, которые содержат сводку шагов для этого режима передвижения в `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 | Поддерживается только для Compute Routes. Содержит информацию об ответе геокодирования только для путевых точек, указанных как адреса. |
bounds | viewport | |
legs.end_address | Нет в наличии. | |
legs.start_address | Нет в наличии. | |
overview_polyline | полилиния | |
summary | description | |
waypoint_order | optimizedIntermediateWaypointIndex |