Эта страница переведена с помощью Cloud Translation API.

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

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

Введение

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 см. в разделе Клиентские библиотеки .