Method: computeRouteMatrix

HTTP 요청
요청 본문
- JSON 표현
응답 본문
승인 범위

출발지와 목적지 목록을 가져오고, 출발지와 목적지의 각 조합에 대한 경로 정보가 포함된 스트림을 반환합니다.

참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참고). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 대한 자세한 내용은 이 문서를 참조하세요.

예를 들어 이 메서드에서

사용 가능한 모든 필드의 필드 마스크 (수동 검사용): X-Goog-FieldMask: *
경로 소요 시간, 거리, 요소 상태, 조건, 요소 색인의 필드 마스크 (프로덕션 설정 예시): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

필드 마스크에 status를 포함해야 합니다. 그러지 않으면 모든 메시지가 정상인 것처럼 보입니다. 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.

필요한 필드만 선택하면 서버에서 계산 주기를 단축하고 결과를 반환할 수 있으며 지연 시간을 단축할 수 있습니다.
프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능이 보장됩니다. 향후 응답 필드를 더 추가할 수 있으며 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준의 모든 필드를 선택하는 경우 새로 추가되는 필드가 자동으로 응답에 포함되므로 성능이 저하될 수 있습니다.
필요한 필드만 선택하면 응답 크기가 줄어들어 네트워크 처리량이 높아집니다.

HTTP 요청

POST https://routespreferred.googleapis.com/v1:computeRouteMatrix

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

JSON 표현
{ "origins": [ { object (`RouteMatrixOrigin`) } ], "destinations": [ { object (`RouteMatrixDestination`) } ], "travelMode": enum (`RouteTravelMode`), "routingPreference": enum (`RoutingPreference`), "departureTime": string }

{
  "origins": [
    {
      object (RouteMatrixOrigin)
    }
  ],
  "destinations": [
    {
      object (RouteMatrixDestination)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "departureTime": string
}

필드
`origins[]`	`object (RouteMatrixOrigin)` 필수 항목입니다. 응답 행렬의 행을 결정하는 출처 배열입니다. 출발지 및 목적지의 카디널리티에는 다음과 같은 몇 가지 크기 제한이 적용됩니다. 요소 (출발지 × 목적지)의 수는 어떤 경우든 625 이하여야 합니다. routePreference가 `TRAFFIC_AWARE_OPTIMAL`로 설정된 경우 요소 수 (출발지 × 목적지)는 100 이하여야 합니다. `placeId`로 지정된 경유지 (출발지 + 목적지)의 수는 50개 이하여야 합니다.
`destinations[]`	`object (RouteMatrixDestination)` 필수 항목입니다. 응답 매트릭스의 열을 결정하는 대상 배열입니다.
`travelMode`	`enum (RouteTravelMode)` 선택사항입니다. 교통수단을 지정합니다.
`routingPreference`	`enum (RoutingPreference)` 선택사항입니다. 경로 계산 방법을 지정합니다. 서버에서는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 길어지면 오류가 반환됩니다. 향후 기본 옵션이 유효한 결과를 제공하지 않는 경우 다른 옵션을 사용하도록 대체 메커니즘을 구현할 수 있습니다. `travelMode`이 `DRIVE` 또는 `TWO_WHEELER`인 경우에만 이 옵션을 지정할 수 있으며, 그러지 않으면 요청이 실패합니다.
`departureTime`	`string (Timestamp format)` 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본적으로 요청한 시간이 됩니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 `"2014-10-02T15:01:23Z"` 및 `"2014-10-02T15:01:23.045123456Z"`입니다.

응답 본문

성공한 경우 응답 본문에 RouteMatrixElement의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.