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

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

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

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

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

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

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

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

Что дальше?