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