Переход с предварительной версии

Разработчики Европейской экономической зоны (ЕЭЗ)

API Routes был выпущен в формате публичной предварительной версии (pre-GA) в сентябре 2022 года. На предложения Pre-GA распространяются Специальные условия использования сервисов платформы Google Карт . Подробнее см. в описаниях этапов запуска .

В этом разделе описывается, как перенести приложение из предварительной версии в версию GA.

Новые функции, добавленные в версию GA

В GA-версию добавлены следующие новые функции, которые не были включены в предварительную версию:

  • Наряду с идентификаторами мест и координатами широты/долготы теперь можно указать местоположение в выпуске GA, используя:

    • Строки адреса («Чикаго, Иллинойс» или «Дарвин, Северная Территория, Австралия»)

      Адресные строки часто используются пользователем для ввода адреса. Однако {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 , включив в него одно или несколько из следующих значений: