경로를 따라 정차 지점을 설정하는 방법은 두 가지입니다(예: 차량 인수 또는 반납).
- 중간 경유지 추가: 이는 기본 옵션입니다.
intermediates배열의 출발지와 목적지 사이에 중간 경유지를 추가합니다. 라우팅 엔진은 경유지를 가장 가까운 탐색 가능한 도로에 스냅하고 경로를 해당 정차 지점으로 연결된RouteLeg세그먼트로 나눕니다. - vehicleStopover 지정: 라우팅 엔진이 고속도로, 터널, 고가도로와 같이 정차에 적합하지 않은 도로 세그먼트를 피하기 위해
추가 분석을 실행하도록 하려면 경유지에
vehicleStopover: true를 설정합니다.
중간 경유지 추가
경로를 따라 정차 지점을 설정하려면 요청의 intermediates 배열에 중간 경유지를 추가합니다.
중간 경유지를 추가하면 다음과 같은 효과가 있습니다.
- 경로가
RouteLeg세그먼트로 나뉩니다. 각 세그먼트는 한 정차 지점을 다음 정차 지점에 연결합니다. - 좌표가 도로에 스냅됩니다.: 라우팅 엔진은 옥상이나 마당에 있을 수 있는 위도 및 경도 좌표를 가장 가까운 탐색 가능한 도로 세그먼트에 스냅합니다.
많은 지상 도로의 경우 가장 가까운 도로에 스냅하면 실용적인 정차 지점을 제공할 수 있습니다. 그러나 스냅은 가장 가까운 도로가 고속도로 또는 터널인 경우와 같이 해당 도로 세그먼트가 정차에 적합한지 여부를 결정하지 않습니다.
예: 중간 경유지 추가
다음 예에서는 computeRoutes POST 요청에 중간 경유지를 추가하여 경로를 따라 정차 지점을 설정하는 방법을 보여줍니다.
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'
중간 경유지 및 경로 구간에 대한 자세한 내용은 중간 경유지 설정을 참고하세요.
차량 인수 및 반납 적합성을 위한 vehicleStopover 지정
표준 중간 경유지는 가장 가까운 도로에 스냅되지만 해당 도로가 항상 차량 정차에 적합한 것은 아닙니다. 라우팅 엔진이 차량 인수 또는 반납에 적합한 도로를 평가하기 위해 추가 분석을 실행하도록 하려면 경유지에 vehicleStopover: true를 설정합니다.
vehicleStopover: true를 설정하면 라우팅 엔진이 후보 도로 세그먼트를 평가하고 고속도로, 터널, 고가도로와 같이 정차에 적합하지 않은 도로를 피하려고 시도합니다.
예를 들어 지상 도로가 터널 내부의 고속도로 위를 직접 통과하는 위치를 생각해 보세요. * 표준 중간 경유지: 좌표에 기하학적으로 더 가까운 경우 아래의 고속도로 또는 터널에 스냅됩니다. * 차량 정차 지점: 고속도로 와 터널을 우회하기 위해 추가 분석을 실행하고 정차에 적합한 지상 도로에 정차 지점을 스냅합니다.
예: 경유지에 vehicleStopover 지정
다음 예에서는 완전한 POST 요청에서 중간 경유지에 vehicleStopover: true를 설정하는 방법을 보여줍니다.
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 } }, "vehicleStopover": true } ], "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'
경유지 유형 및 옵션에 대한 자세한 내용은 경유지 유형 및 옵션을 참고하세요.