- HTTP 요청
- 요청 본문
- 응답 본문
- RouteMatrixOrigin
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- RouteMatrixDestination
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ExtraComputation
- RouteMatrixElementCondition
- LocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
출발지와 목적지 목록을 가져와서 각 출발지와 목적지 조합에 대한 경로 정보가 포함된 스트림을 반환합니다.
참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. 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://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "origins": [ { object ( |
필드 | |
---|---|
origins[] |
필수 항목입니다. 응답 매트릭스의 행을 결정하는 출처 배열입니다. 출발지와 목적지의 카디널리티에는 몇 가지 크기 제한이 적용됩니다.
|
destinations[] |
필수 항목입니다. 응답 매트릭스의 열을 결정하는 대상 배열입니다. |
travelMode |
선택사항입니다. 교통수단을 지정합니다. |
routingPreference |
선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. |
departureTime |
선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 이 값은 기본적으로 요청한 시간으로 지정됩니다. 참고: 이전에는 RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
arrivalTime |
선택사항입니다. 도착 시간입니다. 참고: RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
languageCode |
선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 식별자를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 표시 언어는 첫 번째 출처의 위치에서 추론됩니다. |
regionCode |
선택사항입니다. ccTLD('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요. |
units |
선택사항입니다. 표시 필드의 측정 단위를 지정합니다. |
extraComputations[] |
선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산으로 응답에 추가 필드가 반환될 수 있습니다. 또한 이러한 추가 필드는 응답으로 반환되도록 필드 마스크에 지정되어야 합니다. |
trafficModel |
선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간을 포함하는 |
transitPreferences |
선택사항입니다. |
응답 본문
v2.computeRouteMatrix API의 출발지/목적지 쌍에 대해 계산된 경로 정보를 포함합니다. 이 proto는 클라이언트에 스트리밍할 수 있습니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "status": { object ( |
필드 | |
---|---|
status |
이 요소의 오류 상태 코드입니다. |
condition |
경로를 찾았는지 여부를 나타냅니다. 지위와는 무관합니다. |
distanceMeters |
경로의 이동 거리(미터)입니다. |
duration |
경로를 탐색하는 데 필요한 시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
staticDuration |
교통상황을 고려하지 않고 경로를 통해 이동하는 시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
travelAdvisory |
경로에 대한 추가 정보입니다. 예: 제한 정보 및 통행료 정보 |
fallbackInfo |
서버가 이 특정 출발지/목적지 쌍에 대해 지정된 환경설정으로 경로를 계산할 수 없는 경우 다른 계산 모드를 사용하도록 대체할 수 있습니다. 대체 모드가 사용되면 이 필드에 대체 응답에 관한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다. |
localizedValues |
|
originIndex |
요청에서 출처의 0 기반 색인입니다. |
destinationIndex |
요청 대상의 0 기반 색인입니다. |
RouteMatrixOrigin
ComputeRouteMatrixRequest의 단일 출처
JSON 표현 |
---|
{ "waypoint": { object ( |
필드 | |
---|---|
waypoint |
필수 항목입니다. 출발지 경유지 |
routeModifiers |
선택사항입니다. 이 값을 출발지로 사용하는 모든 경로의 수정자 |
RouteMatrixDestination
ComputeRouteMatrixRequest의 단일 대상
JSON 표현 |
---|
{
"waypoint": {
object ( |
필드 | |
---|---|
waypoint |
필수 항목입니다. 목적지 경유지 |
ExtraComputation
요청을 완료하는 동안 수행할 추가 계산.
열거형 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
사용되지 않음. 이 값이 포함된 요청은 실패합니다. |
TOLLS |
매트릭스 요소에 대한 통행료 정보입니다. |
RouteMatrixElementCondition
반환되는 경로의 조건입니다.
열거형 | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
요소의 status 가 적절하지 않은 경우에만 사용됩니다. |
ROUTE_EXISTS |
경로를 찾았으며, 요소에 상응하는 정보가 입력되었습니다. |
ROUTE_NOT_FOUND |
경로를 찾을 수 없습니다. distanceMeters 또는 duration 등 경로 정보가 포함된 필드는 요소에서 채워지지 않습니다. |
LocalizedValues
특정 속성의 텍스트 표현
JSON 표현 |
---|
{ "distance": { object ( |
필드 | |
---|---|
distance |
이동 거리가 텍스트 형식으로 표시됩니다. |
duration |
교통상황을 고려하여 텍스트 형식으로 표시되는 시간입니다. 참고: 교통정보가 요청되지 않은 경우 이 값은 staticDuration과 동일한 값입니다. |
staticDuration |
교통상황을 고려하지 않고 텍스트 형식으로 표시되는 시간입니다. |
transitFare |
텍스트 형식으로 표시된 대중교통 요금입니다. |