Как перейти с предварительного выпуска

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

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

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

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

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

  • Помимо идентификаторов мест и координат широты и долготы, теперь в общедоступной версии можно указывать местоположение, используя:

    • Строки адреса ("Chicago, IL" или "Darwin, NT, Australia").

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

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

    • Плюс-коды

      Коды Plus Code – это своего рода адреса для людей и мест, у которых нет обычного адреса. В отличие от обычных адресов, которые состоят из названия улицы и номера дома, коды Plus Code основаны на широте и долготе и отображаются в виде букв и цифр.

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