경로 매트릭스 요청은 출발지 및 목적지 경유지의 배열을 입력으로 받습니다. 그러면 Routes API가 각 출발지 경유지에서 각 목적지 경유지까지의 경로를 계산합니다. 예를 들어 출발지 경유지 2개와 목적지 경유지 2개를 지정하면 API에서 개별 경로 4개를 계산합니다.
API 응답에는 배열이 포함되며, 여기서 각 배열 요소는 하나의 출발지 경유지에서 하나의 목적지 경유지까지의 경로에 해당합니다. 따라서 두 개의 출발지 경유지와 2개의 목적지 경유지를 지정하면 응답 배열에는 계산된 경로마다 하나씩 4개의 요소가 포함됩니다.
응답을 사용하여 고객에게 다양한 경로 옵션을 제공하고 사용자가 요구사항에 맞는 적절한 경로를 선택하도록 할 수 있습니다.
필드 마스크에 관한 정보
경로를 계산하는 메서드를 호출할 때는 응답에서 반환되기를 원하는 필드를 정의하는 필드 마스크를 지정해야 합니다. 반환되는 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드가 오류를 반환합니다.
이 문서의 예시에서는 필드 마스크를 고려하지 않고 전체 응답 객체를 보여줍니다. 프로덕션 환경에서는 필드 마스크에 명시적으로 지정한 필드만 응답에 포함됩니다.
자세한 내용은 반환할 정보 선택을 참고하세요.
저작권 표시 정보
사용자에게 결과를 표시할 때 다음 저작권 표시를 포함해야 합니다.
Powered by Google, ©YEAR Google
예를 들면 다음과 같습니다.
Powered by Google, ©2023 Google
응답에서 경로 식별
originIndex 및 destinationIndex 응답 속성을 사용하여 응답에서 각 경로를 식별합니다. 이러한 속성에는 경로 계산에 사용되는 입력 origin 및 입력 destination 경유지의 0부터 시작하는 색인이 포함됩니다. 즉, 요청의 첫 번째 출발지 경유지와 첫 번째 목적지 경유지는 배열 색인 0에 있습니다.
예를 들어 응답의 경로에는 다음이 포함됩니다.
"originIndex": 1, "destinationIndex": 0
이러한 속성은 입력 배열의 색인 1에 있는 출발지 경유지와 색인 0의 목적지 경유지에서 경로가 계산되었음을 나타냅니다.
다음 경로:
"originIndex": 4, "destinationIndex": 1
경로는 입력 배열의 색인 4에 있는 출발지 경유지와 입력 배열의 색인 1에 있는 목적지 경유지에서 계산되었습니다.
응답 정보
API 응답을 나타내는 JSON 객체에는 배열이 포함되며, 여기서 각 배열 요소는 하나의 출발지 경유지에서 하나의 목적지 경유지까지의 경로를 정의합니다.
각 경로에는 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)
}
}
…
]