Обзор вычислений маршрутов

Введение

Метод Compute Routes в сервисе Routes API принимает HTTPS-запрос и возвращает оптимальный маршрут между двумя точками. Он позволяет прокладывать маршруты с учетом дорожной ситуации в реальном времени для общественного транспорта, велосипедов, автомобилей, двухколесных транспортных средств или пеших прогулок между несколькими точками.

Нужны матрицы маршрутов? Если вас интересует матрица маршрутов, см. раздел «Обзор вычисления матрицы маршрутов» .

Переход на новую систему? Если вы переходите с API матрицы расстояний (устаревшая версия), см. инструкции по миграции, начиная с раздела «Почему стоит перейти на API маршрутов» .

Почему стоит использовать Compute Routes?

С помощью Compute Routes, обладающей широким спектром возможностей по настройке маршрутов, вы можете прокладывать маршруты для своих транспортных средств или посылок в соответствии со своими предпочтениями, оптимизируя при этом затраты и качество.

Что можно делать с помощью Compute Routes?

С помощью метода Compute Routes в Routes API можно выполнять следующие действия:

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

  • Виды транспорта: общественный транспорт, автомобиль, двухколесные транспортные средства, пешая ходьба или езда на велосипеде.

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

• Используйте несколько способов для указания пунктов отправления, назначения и путевых точек :

  • Текстовые строки. Например: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" или "CWF6+FWX Mountain View, California"

  • Идентификаторы мест

  • Координаты широты и долготы, при необходимости с указанием направления движения транспортного средства.

• Настройте параметры маршрута в соответствии с вашими потребностями и целями:

  • Выберите экономичные маршруты в зависимости от типа двигателя вашего автомобиля: дизельный, электрический, гибридный, бензиновый. Для получения дополнительной информации см. раздел «Выберите экологичный маршрут» .

  • Настройте параметры расчета трафика с высокой степенью детализации, что позволит вам принимать решения о компромиссе между качеством и задержкой. Подробнее см. раздел «Укажите, как и следует ли включать данные о трафике» .

  • Укажите направление движения транспортного средства и обочину дороги для путевых точек, чтобы повысить точность расчета времени прибытия. Подробнее см. раздел «Указание направления движения транспортного средства и обочины дороги» .

  • Укажите места транзита и конечные точки, а также безопасные места для промежуточной остановки. Подробнее см. разделы «Установка остановки на маршруте» и «Установка точки, через которую будет проходить маршрут» .

  • Запросите информацию о платных дорогах, а также о расстоянии по маршруту и ​​предполагаемом времени прибытия. Подробности см. в разделе «Расчет платы за проезд по маршруту» .

• Контролируйте задержку и качество , запрашивая только необходимые данные с помощью маски поля, что поможет избежать лишнего времени обработки и повышения тарифов на запросы. Подробнее см. раздел «Выбор возвращаемой информации» .

Как работают маршруты вычислений

Метод ComputeRoutes API Routes принимает HTTP POST-запрос с телом запроса в формате JSON, содержащим подробную информацию о запросе. Обязательными являются поля origin, destination, travelMode и маска полей, указывающая, какие поля следует вернуть.

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

Затем сервис рассчитывает запрошенный маршрут и возвращает запрошенные вами поля.

Ресурсы

В таблице ниже приведено краткое описание ресурсов, доступных через метод Compute Routes в API Routes, а также возвращаемые им данные.

Как использовать вычислительные маршруты

Доступные клиентские библиотеки

Список доступных клиентских библиотек для Compute Routes см. в разделе «Клиентские библиотеки» .

Что дальше?

• Проложить маршрут
• Доступные варианты маршрута
• Выберите, какую информацию вернуть.
• Переход с API Directions (устаревшая версия)
• Переход с предварительной версии Routes API на общедоступную версию.