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

API Routes был выпущен в виде общедоступной предварительной версии (pre-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 , включив одно или несколько из следующих значений: