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

Запрос матрицы маршрутов принимает в качестве входных данных массив исходных и конечных точек маршрута. 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)
    }
  }
  …
]