출발지 및 목적지 목록을 사용하고 출발지와 목적지의 각 조합에 대한 경로 정보가 포함된 스트림을 반환합니다.
참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields
또는 fields
를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask
를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 필드 경로의 쉼표로 구분된 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.
예를 들어 이 메서드에서 다음을 실행합니다.
- 사용 가능한 모든 필드의 필드 마스크 (수동 검사용):
X-Goog-FieldMask: *
- 경로 시간, 거리, 요소 상태, 상태, 요소 색인의 필드 마스크 (프로덕션 설정 예):
X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration
필드 마스크에 status
를 포함해야 합니다. 그렇지 않으면 모든 메시지가 정상적으로 표시됩니다. Google에서는 다음과 같은 이유로 와일드 카드 (*
) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.
- 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 줄여 결과를 반환할 수 있습니다.
- 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가된 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
- 필요한 필드만 선택하면 응답 크기가 줄어들어 네트워크 처리량이 증가합니다.
HTTP 요청
POST https://routespreferred.googleapis.com/v1:computeRouteMatrix
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "origins": [ { object ( |
필드 | |
---|---|
origins[] |
필수 항목입니다. 응답 매트릭스의 행을 결정하는 출처 배열입니다. 출처 및 대상의 카디널리티에는 여러 크기 제한사항이 적용됩니다.
|
destinations[] |
필수 항목입니다. 응답 행렬의 열을 결정하는 대상 배열입니다. |
travel |
선택사항입니다. 이동수단을 지정합니다. |
routing |
선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. |
departure |
선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
응답 본문
성공하면 응답 본문에 RouteMatrixElement
인스턴스의 스트림이 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/maps-platform.routespreferred
자세한 내용은 OAuth 2.0 개요를 참고하세요.