중간 경유지는 출발지와 목적지 사이에 지정된 위치로, 경로가 통과해야 합니다.
REST computeRoutes 메서드 또는 gRPC ComputeRoutes 메서드의 intermediates 배열 속성을 사용하여 단일 요청에서 최대 25개의 중간 경유지를 정의할 수 있습니다.
스탑오버와 통과 경유지 비교
중간 경유지를 정차 또는 통과 위치로 구성할 수 있습니다.
- 경유지: 기본적으로 차량이 해당 위치에 정차합니다. 각 경유지 웨이포인트는 응답의
legs배열에RouteLeg항목을 추가하여 경로를 나눕니다. 자세한 내용은 경로에 정차 지점 설정하기를 참고하세요. "via"이true로 설정된 통과 경유지: 차량이 정차하지 않고 위치를 통과합니다. 통과 경유지는legs배열에 항목을 추가하지 않습니다. 자세한 내용은 경로가 통과할 지점 설정을 참고하세요.
경로 구간 및 중간 경유지
요청의 각 중간 경유지에 대해 응답에는 routes.legs 배열에 별도의 RouteLeg 객체가 포함됩니다.
예를 들어 출발지, 중간 경유지 1개, 목적지가 있는 경로에는 두 개의 경로 구간이 포함됩니다. * 구간 1: 출발지에서 중간 경유지까지 * 2구간: 중간 기착지에서 목적지까지
예: 중간 경유지가 있는 요청
다음 예에서는 intermediates 배열을 사용하여 경로에 단일 중간 경유지를 추가합니다.
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
경로 구간이 여러 개인 응답
요청의 중간 경유지가 "via": true를 설정하지 않는 경유지이므로 대답은 legs 배열에서 경로를 두 구간으로 나눕니다.
{ "routes": [ { "distanceMeters": 805, "duration": "248s", "legs": [ { "distanceMeters": 207, "duration": "89s", "startLocation": { "latLng": { "latitude": 37.4197318, "longitude": -122.0826233 } }, "endLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } } }, { "distanceMeters": 598, "duration": "159s", "startLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } }, "endLocation": { "latLng": { "latitude": 37.4176166, "longitude": -122.0793882 } } } ] } ] }