기본적으로 Routes API는 기본 경로를 반환합니다. 이 경로는 일반적으로 출발지에서 목적지까지 가장 빠른 경로를 보여줍니다. 요청 시 대체 경로가 있는 경우 API는 기본 경로 및 있습니다. 그러면 고객은 자신의 요구사항에 가장 적합한 경로를 선택할 수 있습니다.
대체 경로 요청 시 고려사항
대체 경로를 요청하려면 다음 고려사항에 유의하세요.
중간 경로가 없는 경로에 대해서만 대체 경로를 요청할 수 있습니다. 경유지. 경로에서 다음을 지정하는 경우 대체 경로 요청 오류가 발생하지 않습니다. 대체 방법 없음 경로가 반환됩니다
응답에 최대 세 개의 대체 경로가 포함됩니다. 하지만 대체 경로를 사용할 수 없는 경우가 있으므로 응답에 기본 경로를 선택합니다
대체 텍스트를 계산하는 데 추가 처리가 필요하기 때문에 경로를 요청할 경우 대체 경로를 요청하면 응답 시간이 생성합니다.
대체 경로 요청 예
대체 경로를 요청하려면 computeAlternativeRoutes
를 true
로 설정합니다. 이
다음 예는
computeRoutes
메서드 (REST) 요청
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "routingPreference":"TRAFFIC_AWARE", "computeAlternativeRoutes": true }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
이 예에서는 응답에
각 경로의 duration
, distanceMeters,
, routeLabels
속성 내
고객은 그 정보를 사용하여 어떤 경로를 이용할지 선택할 수 있습니다. 자세한 내용은
자세한 내용은 반환할 정보 선택을 참고하세요.
대체 경로 응답 예시
응답에서 routeLabels
배열 속성을 사용하여 도달범위를 식별합니다.
경로:
기본 경로의 경우
routeLabels
속성에 다음이 포함됩니다.DEFAULT_ROUTE
입니다.대체 경로의 경우
routeLabels
속성에 다음이 포함됩니다.DEFAULT_ROUTE_ALTERNATE
입니다.
이 예에서 응답에는 기본 경로와 2개의 대체 경로가 포함되어 있습니다.
경로. duration
및 distanceMeters
속성의 값이
경로마다 다릅니다.
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }
응답에 다중선 포함
사용자가 경로를 더 쉽게 선택할 수 있도록 다중선을 사용합니다. 그런 다음 지도에 각 폴리라인을 표시합니다.
다중선을 추가하려면 필드 마스크에 routes.polyline
를 포함합니다.
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'
그러면 응답에 각 경로에 대한 폴리라인이 포함됩니다.
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "polyline": { "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "polyline": { "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "polyline": { "encodedPolyline": "FVLL|Af@HPAV…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }