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

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

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

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

Маски полей

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

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

Дополнительную информацию см. в разделе Выбор возвращаемой информации.

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

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

Powered by Google, ©YEAR Google

Пример:

Powered by Google, ©2023 Google

Как определить маршрут в ответе

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

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

"originIndex": 1,
"destinationIndex": 0

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

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

"originIndex": 4,
"destinationIndex": 1

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

Об информации о маршруте в ответе

Ответ API содержит массив, каждый элемент которого определяет маршрут от одной начальной путевой точки до одной конечной путевой точки. Это элементы RouteMatrixElements в методе gRPC или тело ответа в HTTP-ответе.

Помимо свойств originIndex и destinationIndex, каждый элемент содержит только базовую информацию, относящуюся к этому маршруту, например distanceMeters, duration и travelAdvisory. Чтобы получить более подробную информацию о маршруте, например ломаную линию, используйте computeRoutes.

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

[
  // 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)
    }
  }
  …
]