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

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

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

С помощью API маршрутов вы можете получать точные маршруты и информацию о поездках, используя сведения о транспорте, актуальные данные о пробках и дорожных условиях, а также настройки маршрута:

  • Вид и возможности разных видов транспорта

  • В каком направлении движется транспортное средство

  • Обочина дороги для посадки или высадки

  • Условия дорожного движения и перекрытие дорог

  • Проблемы безопасности, такие как избегание опасных зон или обеспечение безопасных мест посадки.

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

Вы также можете определить наиболее эффективные маршруты для планирования отправки, например:

  • Как лучше назначить набор рабочих для подбора серии посылок

  • Определите лучший склад для отправки посылок в конечный пункт назначения.

Что вы можете сделать с помощью Routes API?

С помощью Routes API вы можете получить две основные категории информации о маршрутизации:

  • Маршруты из одного места в один или несколько пунктов назначения

  • Матрица возможных маршрутов между множеством начальных и конечных точек.

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

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

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

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

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

  • Несколько способов указать пункты отправления, назначения и путевые точки :

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

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

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

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

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

Получить матрицу возможных маршрутов

Метод Routes API Compute Route Matrix предоставляет матрицу информации для рекомендуемых маршрутов между несколькими начальными и конечными точками, включая расстояние и расчетное время прибытия, чтобы помочь вам выбрать лучшие пункты отправления и назначения в соответствии с потребностями вашего бизнеса. Вы можете запросить следующие виды данных о расстоянии:

  • Расстояние для выбранного режима движения

  • Расстояние в километрах или милях

  • Примерное время в пути в пробке

Используя данные о расстоянии, вы можете определить наиболее эффективный способ маршрутизации пассажиров, грузов или работников между несколькими возможными пунктами отправления и назначения.

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

Вы можете указать несколько источников и пунктов назначения для каждого запроса на стороне сервера, умножив количество источников на количество пунктов назначения до 625.

Как работает API маршрутов

API Routes имеет два метода: ComputeRoutes и ComputeRouteMatrix .

Вычислительные маршруты

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

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

ВычислитьМаршрутМаршрут

API маршрутов ComputeRouteMatrix принимает запрос HTTP POST с телом запроса JSON, содержащим сведения о запросе. Обязательными являются как минимум один пункт отправления, два или более пункта назначения, режим путешествия и маска поля, чтобы указать, какие поля возвращать.

Пример 

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Ответ содержит возможные маршруты для комбинации всех путевых точек отправления и назначения.

Ресурсы

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

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

Как использовать API маршрутов

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

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

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

Что дальше