경로를 따라 경유지 설정

유럽 경제 지역 (EEA) 개발자

다음 두 가지 방법 중 하나로 경로를 따라 정차 지점을 설정할 수 있습니다(예: 픽업 또는 하차).

  • 중간 경유지 추가: 기본 옵션입니다. 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'

경유지 유형 및 옵션에 대한 자세한 내용은 경유지 유형 및 옵션을 참고하세요.