Key: oneway

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`oneway`	일방통행 — 길의 진행 방향을 기준으로 통행 가능한 방향을 기록합니다.	OSM 태그	길	`text`	OSM Wiki

어떻게 사용하나요?

oneway=*는 한 방향으로만 통행할 수 있는지를 나타내며, 방향의 기준은 지도상의 동서남북이 아니라 길을 그린 순서입니다. 이 점이 이 Key에서 가장 자주 틀리는 부분입니다.

길 방향과 통행 방향이 같으면 yes, 반대면 -1입니다. 특정 교통수단만 예외라면 oneway:bicycle=*처럼 수단별 Key로 따로 적습니다.

적용 대상

oneway=*는 일반적으로 길에 적용합니다.

통행 방향이 정의된 길에 적용하며, 값은 그 길을 그린 순서를 기준으로 해석합니다. 교차점 노드나 도로 영역 전체가 아니라 방향 제한이 실제로 적용되는 선형 구간에 붙입니다.

Value 선택

값은 OSM 길의 방향을 기준으로 합니다. 길 방향과 같으면 yes, 반대면 -1이며, 도로가 양방향이라는 사실을 특별히 명시할 필요가 있을 때만 no를 사용합니다. 자전거 등 특정 교통수단의 예외는 oneway:bicycle=*처럼 별도로 기록합니다.

확인되지 않은 값은 짐작해서 넣지 않습니다. 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.

비슷한 Key와 구분하기

비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.

Key	무엇을 기록하나요?	예시·구분 기준
`highway=*`	길의 이동 기능과 도로망에서의 역할	`highway=residential` — 주거지역 접근 도로
`service=*`	서비스 도로·철도의 세부 용도	`highway=service`와 조합
`surface=*`	길 표면의 실제 재질	`surface=asphalt` — 아스팔트
`access=*`	공식적인 통행 허용·제한	`access=private` — 사유 통행

주요 Value

아래 표에는 KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 OSM Wiki — Key:oneway에서 확인합니다.

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`oneway=yes`	길 방향으로만 통행	길을 그린 방향으로만 통행할 수 있을 때 사용합니다. 교통수단별 예외는 `oneway:bicycle=no`처럼 더 구체적인 Key로 기록합니다.	OSM 태그	Tag 문서에서 확인
`oneway=no`	양방향 통행	해당 도로가 양방향임을 명시해야 할 때 사용합니다. 일반적으로 양방향이 기본인 도로에는 불필요하게 반복하지 않습니다.	OSM 태그	Tag 문서에서 확인
`oneway=-1`	길의 반대 방향으로만 통행	길을 그린 방향과 반대 방향으로만 통행할 때 사용합니다. 가능하면 실제 통행 방향에 맞게 길 방향을 정리할 수 있는지도 검토합니다.	OSM 태그	Tag 문서에서 확인
`oneway=reversible`	시간 등에 따라 통행 방향이 바뀜	시간대·교통 운영에 따라 도로 전체의 허용 진행 방향이 바뀌는 가변방향 도로에 사용합니다. 단순 일방통행 시간 제한은 조건부 태그가 더 적절한지 확인합니다.	OSM 태그	Tag 문서에서 확인
`oneway=alternating`	교대로 한 방향씩 통행	폭이 좁아 양방향 차량이 동시에 지나갈 수 없고 우선권·신호에 따라 한 방향씩 번갈아 통행하는 구간에 사용합니다. 시간대별 방향 전환인 `reversible`과 구분합니다.	OSM 태그	Tag 문서에서 확인

값 입력 방법

길 방향을 기준으로 통행 방향을 기록합니다.

oneway=yes — 길 방향으로만 통행
oneway=no — 양방향 통행
oneway=-1 — 길 반대 방향으로만 통행. 길을 그린 방향을 뒤집으면 이 값을 쓰지 않아도 됩니다.

함께 사용하는 Key

Key가 비슷해 보여도 각각 나타내는 정보가 다릅니다. 하나의 Key에 여러 의미를 넣지 말고, 정보의 종류에 맞는 Key를 각각 사용합니다.

관련 Key	역할	공식 문서
`highway`	도로·보행로의 기능과 네트워크상 중요도를 분류합니다.	OSM Wiki
`surface`	길이나 공간의 실제 표면 재질을 기록합니다.	OSM Wiki
`smoothness`	바퀴 달린 이동수단이 표면을 이용하기 쉬운 정도를 기록합니다.	OSM Wiki
`lanes`	도로의 일반적인 차로 수를 기록합니다.	OSM Wiki
`maxspeed`	표지나 법규로 정해진 최고 제한속도를 기록합니다.	OSM Wiki
`access`	법적·공식적으로 허용되는 출입 또는 통행 대상을 기록합니다.	OSM Wiki
`sidewalk`	도로에 나란히 있는 보도의 존재와 위치를 기록합니다.	OSM Wiki
`bridge`	지물이 다리 위를 통과하거나 다리 구조 자체임을 뜻합니다.	OSM Wiki

참고 문서

이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:oneway에서 확인합니다.