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

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

Введение

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

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

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

Зачем использовать Compute Routes

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

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

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

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

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

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

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

    • Текстовые строки. Например: «Чикаго, Иллинойс», «Дарвин, Северная Территория, Австралия», «1800 Amphitheatre Parkway, Mountain View, CA 94043» или «CWF6+FWX Mountain View, Калифорния».

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

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

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

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

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

Метод ComputeRoutes API Routes принимает 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 API Routes, а также возвращаемые им данные.

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

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

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

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

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

Что дальше?