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

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

Нужны автомобильные маршруты? Если вас интересуют пошаговые инструкции по прокладке маршрута, см. раздел «Обзор расчета маршрутов» .

Переход на новую систему? Если вы переходите с API матрицы расстояний (устаревшая версия), см. инструкции по миграции, начиная с раздела «Почему стоит перейти на API маршрутов» .

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

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

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

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

Что дальше?

• Получите матрицу маршрутов
• Доступные варианты матрицы маршрутов
• Выберите, какую информацию вернуть.
• Переход с API матрицы расстояний (устаревшая версия)
• Переход с предварительной версии Routes API на общедоступную версию.