Обзор маршрутов

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

Введение

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

Нужны матрицы маршрутов? Если вас интересует матрица маршрутов, ознакомьтесь с обзором Compute Route Matrix.

Перенос данных Если вы переходите с Distance Matrix API (устаревшая версия), ознакомьтесь с инструкциями по переходу, начиная с раздела Зачем переходить на Routes API.

Преимущества Compute Routes

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

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

Метод Compute Routes в Routes API позволяет:

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

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

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

  • Указывайте пункты отправления и назначения, а также путевые точки разными способами.

    • Текстовые строки. Примеры: "Москва, Россия", "Дарвин, Северная территория, Австралия", "1800 Amphitheatre Parkway, Mountain View, CA 94043" или "CWF6+FWX Mountain View, California".

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

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

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

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

Как работает Compute Routes

Метод ComputeRoutes Routes API принимает HTTP-запрос POST с телом запроса JSON, содержащим сведения о запросе. Обязательно укажите пункт отправления, пункт назначения, 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 в Routes API, и возвращаемые данные.

Ресурсы данных Возвращенные данные Формат возвращаемого значения
ComputeRoutes Возвращает маршруты, участки и шаги для маршрута, а также альтернативные маршруты, если они запрошены. JSON

Как использовать Compute Routes

1 Настройка Начните с раздела Настройка облачного проекта Google Cloud и выполните все инструкции.
2 Как рассчитывается плата за использование Routes API Подробную информацию вы найдете в статье Статистика использования и оплата.
3 Как рассчитать маршрут и посмотреть ответ Дополнительную информацию можно найти в разделах Получение маршрута и Просмотр ответов о маршрутах.

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

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

Дальнейшие действия