경로 매트릭스 응답 검토

경로 매트릭스 요청은 출발지와 목적지의 배열을 입력으로 취합니다. 경유지. 그러면 Routes API가 각 출발 경유지에서 각 도착 경유지까지의 경로를 계산합니다. 예를 들어 두 개의 출처를 지정하는 경우 두 개의 목적지 경유지의 경우 API는 4개의 개별적인 경로.

API 응답에는 배열이 포함되며, 여기서 각 배열 요소는 한 출발지 경유지에서 하나의 목적지 경유지로 가는 경로를 보여줍니다. 따라서 두 개의 출발지 경유지와 두 개의 목적지 경유지를 지정하면 응답 배열은 에는 계산된 각 경로에 하나씩 네 개의 요소가 포함됩니다.

이 응답을 사용하여 고객에게 다양한 경로 옵션을 제공할 수 있습니다. 사용자가 요구사항에 맞는 적절한 경로를 선택하도록 합니다.

필드 마스크에 관한 정보

메서드를 호출하여 경로를 계산할 때 필드를 지정해야 합니다. 마스크는 응답에서 반환되기를 원하는 필드를 정의합니다. 없음 반환된 필드의 기본 목록입니다. 이 목록을 생략하면 메서드가 오류가 발생했습니다.

이 문서의 예에서는 전체 응답 객체를 필드 마스크를 고려해야 합니다 프로덕션 환경에서는 필드 마스크에 명시적으로 지정한 필드만 응답에 포함됩니다.

자세한 내용은 반환할 정보 선택하기를 참고하세요.

저작권 표시 정보

사용자에게 결과를 표시할 때 다음 저작권 고지를 포함해야 합니다.

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에 있는 목적지 경유지에서 시작됩니다.

답변 정보

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