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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Метод 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'

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

Ресурсы

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

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

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

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

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

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

Что дальше