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

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

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

Введение

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

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

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

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

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

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

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

Получите инструкции для разных способов передвижения , а также для одного или нескольких пунктов назначения:
- Способы передвижения: общественный транспорт, автомобиль, двухколесный транспорт, ходьба или езда на велосипеде.
- Серия путевых точек, которые можно оптимизировать для наиболее эффективного порядка перемещения к ним.
Используйте несколько способов указания пунктов отправления, назначения и промежуточных точек :
- Текстовые строки. Например: «Чикаго, Иллинойс», «Дарвин, Северная Каролина, Австралия», «1800 Amphitheatre Parkway, Mountain View, CA 94043» или «CWF6+FWX Mountain View, Калифорния»
- Идентификаторы мест
- Координаты широты и долготы, опционально с указанием направления движения транспортного средства
Настройте параметры маршрута в соответствии с вашими потребностями и целями:
- Выберите топливо- или энергосберегающие маршруты для типа двигателя вашего автомобиля: Дизельный, Электрический, Гибридный, Газовый. Для получения дополнительной информации см. Получить экологичный маршрут .
- Установите детальные параметры для расчета трафика, что позволит вам принимать решения о компромиссе между качеством и задержкой. Подробнее см. в разделе Укажите, как и следует ли включать данные о трафике .
- Установите направление движения транспортного средства (направление движения) и информацию о стороне дороги для путевых точек, чтобы повысить точность ETA. Подробности см. в разделе Укажите направление движения транспортного средства и сторону дороги .
- Укажите транзитные и конечные местоположения и безопасные места остановок. Подробнее см. в разделах Установка остановки по маршруту и Установка точки для маршрута, через которую нужно пройти .
- Запросить информацию о платных дорогах, а также о расстоянии маршрута и расчетном времени прибытия. Подробности см. в разделе Рассчитать плату за проезд по маршруту .
Контролируйте задержку и качество, запрашивая только необходимые данные с помощью маски поля, что помогает избежать ненужного времени обработки и более высоких ставок биллинга запросов. Подробнее см. в разделе Выберите, какую информацию возвращать .

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

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

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

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

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

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

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