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