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

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

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

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

В общедоступную версию добавлены новые функции.

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

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

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

      Адресная строка — это часто способ ввода адреса пользователем. Однако, прежде чем {product_name} сможет рассчитать маршрут, система должна сначала выполнить внутреннюю геокодировку адресной строки, чтобы преобразовать её в координаты широты и долготы.

      Кроме того, добавлена ​​поддержка параметра запроса regionCode , позволяющего указать, какие результаты с геокодированием следует возвращать для конкретного географического региона.

    • Плюс-коды

      Плюс-коды — это как уличные адреса для людей или мест, у которых нет фактического адреса. Вместо адресов с названиями улиц и номерами домов, плюс-коды основаны на широте и долготе и отображаются в виде цифр и букв.

  • В ответе на запрос о вычислении маршрутов теперь содержится массив geocodingResults . Для каждого местоположения в запросе (начальная точка, конечная точка или промежуточная точка маршрута), указанного в виде адресной строки или кода Plus , API выполняет поиск идентификатора места. Каждый элемент этого массива содержит идентификатор места, соответствующий местоположению, а также дополнительные метаданные о местоположении. Местоположения, указанные в запросе в виде идентификатора места или координат широты/долготы, игнорируются.

Изменения в существующих функциях предварительного просмотра.

Теперь необходимо явно включить следующие функции в общедоступной версии, добавив в запрос новое поле массива extraComputations :

В предварительной версии вы использовали маску поля , чтобы указать, какую информацию о данных характеристиках следует возвращать в ответе. Теперь необходимо выполнить оба условия:

  • Установите новый параметр запроса extraComputations array, чтобы включить эти функции.
  • Укажите маску поля, чтобы определить, какую информацию следует вернуть в ответе.

Что мне нужно знать?

Следующие поля больше не будут включаться в ответы computeRouteMatrix , если они явно не включены путем установки extraComputations :

  • travelAdvisory.tollInfo (Информация о платных дорогах)

Следующие поля больше не будут включаться в ответы computeRoutes, если они явно не включены путем установки параметра extraComputations :

  • routes.legs.travelAdvisory.tollInfo (Информация о платных дорогах)
  • routes.travelAdvisory.tollInfo (Информация о платных дорогах)
  • routes.travelAdvisory.fuelConsumptionMicroliters (Расход топлива)
  • routes.travelAdvisory.speedReadingIntervals (Traffic on a polyline)
  • routes.legs.travelAdvisory.speedReadingIntervals (Traffic on a polyline)

Что мне нужно сделать?

Для получения полей ответа с информацией о плате за проезд, расходе топлива или трафике на полилинии необходимо установить новое поле массива запросов extraComputations , включив в него одно или несколько из следующих значений: