Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
Waypoint
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
경유지를 캡슐화합니다. 경유지는 경로의 시작과 끝을 모두 표시하며 경로를 따라 중간 정류장을 포함합니다.
| JSON 표현 |
{
"via": boolean,
"vehicleStopover": boolean,
"sideOfRoad": boolean,
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"location": {
object (Location)
},
"placeId": string,
"address": string,
"navigationPointToken": string
// End of mutually exclusive fields.
} |
| 필드 |
via |
boolean
이 경유지를 정류장이 아닌 마일스톤으로 표시합니다. 요청의 각 비경유지 경유지에 대해 응답은 legs 배열에 항목을 추가하여 이동의 해당 구간에서 정차에 대한 세부정보를 제공합니다. 정차하지 않고 경로가 이 경유지를 통과하도록 하려면 이 값을 true로 설정합니다. 경유지 경유지는 legs 배열에 항목이 추가되지 않지만 경유지를 통해 이동을 라우팅합니다. 이 값은 중간 경유지에만 설정할 수 있습니다. 터미널 경유지에 이 필드를 설정하면 요청이 실패합니다. ComputeRoutesRequest.optimize_waypoint_order가 true로 설정된 경우 이 필드를 true로 설정할 수 없습니다. 그렇지 않으면 요청이 실패합니다.
|
vehicleStopover |
boolean
경유지가 차량이 정차할 수 있는 곳임을 나타냅니다. 여기서 의도는 픽업 또는 하차입니다. 이 값을 설정하면 계산된 경로에 픽업 및 하차에 적합하지 않은 도로의 비via 경유지가 포함되지 않습니다. 이 옵션은 DRIVE 및 TWO_WHEELER 이동 모드와 locationType이 Location인 경우에만 작동합니다.
|
sideOfRoad |
boolean
이 경유지의 위치가 차량이 도로의 특정 측면에 정차하는 것을 선호하도록 의도되었음을 나타냅니다. 이 값을 설정하면 차량이 도로 중앙에서 위치가 치우쳐 있는 도로 측면에 정차할 수 있도록 경로가 위치를 통과합니다. 이 옵션은 DRIVE 및 TWO_WHEELER RouteTravelMode에만 작동합니다.
|
| 위치를 나타내는 다양한 방법. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다. |
location |
object (Location)
선택적 방향을 포함하여 지리적 좌표를 사용하여 지정된 지점입니다.
|
placeId |
string
경유지와 연결된 관심 장소 장소 ID입니다.
|
address |
string
사람이 읽을 수 있는 주소 또는 플러스 코드입니다. 자세한 내용은 https://plus.codes를 참고하세요.
|
navigationPointToken |
string
Geocoding API의 SearchDestinations 메서드에서 가져온 NavigationPoint를 식별하는 토큰입니다.
|
| 상호 배타적인 필드의 끝입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-09-07(UTC)
[null,null,["최종 업데이트: 2026-09-07(UTC)"],[],["Waypoints, marking route start, end, and intermediate stops, are defined using a JSON format. Key properties include `via` (boolean) for non-stopping waypoints, `vehicleStopover` (boolean) for pickup/drop-off locations, and `sideOfRoad` (boolean) for preferred stopping side. A waypoint's `location_type` can be specified via geographic coordinates (`location`), a place ID (`placeId`), or a human-readable address (`address`). `via` cannot be true for terminal waypoints or if `optimize_waypoint_order` is true.\n"]]