Просмотрите ответ матрицы маршрута

Запрос матрицы маршрутов принимает на вход массив начальных и конечных путевых точек. Затем API маршрутов вычисляет маршрут от каждой начальной путевой точки до каждой конечной путевой точки. Например, если вы укажете две начальные и две конечные путевые точки, API вычислит четыре отдельных маршрута.

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

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

О полевых масках

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

Примеры в этом документе показывают весь объект ответа без учета масок полей. В рабочей среде ваш ответ будет содержать только те поля, которые вы явно указываете в маске поля.

Для получения более подробной информации см. раздел «Выберите, какую информацию вернуть» .

О отображении авторских прав

При отображении результатов пользователям необходимо включить следующее заявление об авторских правах:

Powered by Google, © YEAR Google

Например:

Powered by Google, ©2023 Google

Укажите маршрут в ответе.

Используйте свойства ответа originIndex и destinationIndex для идентификации каждого маршрута в ответе. Эти свойства содержат индексы входных точек отправления и назначения , используемые для расчета маршрута (начиная с нуля) . Это означает, что первая точка отправления и первая точка назначения в запросе находятся по индексу 0 в массиве.

Например, маршрут в ответе содержит:

"originIndex": 1,
"destinationIndex": 0

Эти свойства указывают на то, что маршрут был рассчитан от начальной точки по индексу 1 во входном массиве и от конечной точки по индексу 0.

Для следующего маршрута:

"originIndex": 4,
"destinationIndex": 1

Маршрут рассчитывался от начальной точки с индексом 4 во входном массиве и от конечной точки с индексом 1 во входном массиве.

По поводу ответа

JSON-объект , представляющий ответ API, содержит массив, где каждый элемент массива определяет маршрут от одной исходной точки до одной конечной точки.

Наряду со свойствами originIndex и destinationIndex , каждый маршрут содержит информацию, специфичную для этого маршрута, такую ​​как distanceMeters , duration и travelAdvisory .

Ответ имеет следующий вид:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]