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

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

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

Нужны маршруты для вождения? Если вас интересуют направления маршрутов, см. Обзор вычислений маршрутов .

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

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

С помощью Compute Route Matrix вы можете определить наиболее эффективные маршруты для планирования отправлений, например:

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

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

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

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

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

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

  • Расчетное время в пути в пробках

Как работает Compute Route Matrix

Метод ComputeRouteMatrix принимает запрос HTTP POST с телом запроса JSON, содержащим данные запроса. Требуются как минимум один источник, два или более пунктов назначения, travelMode и маска поля для указания возвращаемых полей.

Пример 

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

Ресурсы данных Данные возвращены Формат возврата
ВычислитьМаршрутнуюМатрица Возвращает массив маршрутов от одной исходной точки маршрута до одной конечной точки маршрута. JSON

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

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

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

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

Что дальше?