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

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

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