경로 매트릭스 응답 검토

경로 매트릭스 요청에는 출발지 및 목적지 경유지의 배열을 입력으로 사용합니다. Routes API는 각 출발지 경유지에서 각 목적지 경유지까지의 경로를 계산합니다. 예를 들어 두 개의 출발지 경유지와 두 개의 목적지 경유지를 지정하면 API는 4개의 개별 경로를 계산합니다.

API 응답에는 배열이 포함되며, 여기서 각 배열 요소는 한 출발지 경유지에서 하나의 목적지 경유지까지의 경로에 해당합니다. 따라서 두 개의 출발지 경유지와 두 개의 목적지 경유지를 지정하면 응답 배열에는 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)
    }
  }
  …
]