API Routes был выпущен в виде общедоступной предварительной версии (до GA) в сентябре 2022 года. На предложения Pre-GA распространяются Особые условия обслуживания платформы Google Maps . Дополнительную информацию см. в описании этапов запуска .
В этом разделе описывается, как перенести приложение из предварительной версии в общедоступную версию.
Новые функции, добавленные в общедоступную версию
В общедоступную версию добавлены следующие новые функции, которые не были включены в предварительную версию:
Наряду с идентификаторами мест и координатами широты и долготы теперь вы можете указать местоположение в общедоступной версии, используя:
Строки адреса («Чикаго, Иллинойс» или «Дарвин, Северная Каролина, Австралия»)
Строки адреса часто используются для ввода адреса пользователем. Однако {product_name} должен сначала геокодировать строку адреса внутри себя, чтобы преобразовать ее в координаты широты и долготы, прежде чем он сможет рассчитать маршрут.
Кроме того, была добавлена поддержка параметра запроса
regionCode
, который позволяет указать возврат геокодированных результатов для определенного географического региона.Коды Plus похожи на адреса людей или мест, у которых нет фактического адреса. Вместо адресов с названиями улиц и номерами коды Plus основаны на широте и долготе и отображаются в виде цифр и букв.
Ответ вычисления маршрутов теперь содержит массив
geocodingResults
. Для каждого местоположения в запросе (исходная, конечная или промежуточная путевая точка), указанного в виде строки адреса или кода Plus , API выполняет поиск по идентификатору места. Каждый элемент этого массива содержит идентификатор места, соответствующий местоположению, а также дополнительные метаданные об этом местоположении. Местоположение в запросе, указанное в виде идентификатора места или координат широты/долготы, игнорируется.
Изменения в существующих функциях предварительной версии
Теперь вы должны явно включить следующие функции в GA, добавив в запрос новое поле extraComputations
массива:
В предварительной версии вы использовали маску поля , чтобы указать, нужно ли возвращать информацию об этих функциях в ответе. Теперь вы оба должны:
- Установите новый параметр запроса массива
extraComputations
, чтобы включить эти функции. - Установите маску поля, чтобы указать, чтобы возвращать информацию в ответе.
Что мне нужно знать?
Следующие поля больше не будут включаться в ответы ComputeRouteMatrix , если они явно не включены путем установки extraComputations
:
-
travelAdvisory.tollInfo
(информация о платных дорогах)
Следующие поля больше не будут включаться в ответы ComputeRoutes , если они явно не включены путем установки extraComputations
:
-
routes.legs.travelAdvisory.tollInfo
(информация о платных дорогах) -
routes.travelAdvisory.tollInfo
(Информация о платных дорогах) -
routes.travelAdvisory.fuelConsumptionMicroliters
(Расход топлива) -
routes.travelAdvisory.speedReadingIntervals
(Трафик на ломаной линии) -
routes.legs.travelAdvisory.speedReadingIntervals
(Трафик на ломаной линии)
Что мне нужно делать?
Чтобы получать поля ответа для информации о платных дорогах, расходе топлива или трафике на полилинии, необходимо установить новое поле массива запроса extraComputations
, включив одно или несколько из следующих значений:
Чтобы получать информацию о дорожных сборах , установите для нового поля массива
extraComputations
значение"TOLLS"
.Чтобы получить расход топлива , установите для нового поля массива
extraComputations
значение"FUEL_CONSUMPTION"
.Чтобы получать информацию о трафике на полилиниях , установите для нового поля массива
extraComputations
значение"TRAFFIC_ON_POLYLINE"
.