Key: oneway 문서 원본 보기

[[KOSM Feature Key Reference|K-OSM Feature Key Reference]]로 돌아가기

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="일방통행">oneway</code> || '''일방통행''' — 길의 진행 방향을 기준으로 통행 가능한 방향을 기록합니다. || '''OSM 태그''' || 길 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:oneway OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="일방통행">oneway=*</code>는 '''한 방향으로만 통행할 수 있는지'''를 나타내며, 방향의 기준은 지도상의 동서남북이 아니라 '''길을 그린 순서'''입니다. 이 점이 이 Key에서 가장 자주 틀리는 부분입니다.

길 방향과 통행 방향이 같으면 <code>yes</code>, 반대면 <code>-1</code>입니다. 특정 교통수단만 예외라면 <code class="kosm-tag-reference" title="자전거의 일방통행 예외">oneway:bicycle=*</code>처럼 수단별 Key로 따로 적습니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="일방통행">oneway=*</code>는 일반적으로 '''길'''에 적용합니다.

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

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

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로">[[Key: highway|highway=*]]</code> || 길의 이동 기능과 도로망에서의 역할 || <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=주거 도로">[[Key: highway|highway=residential]]</code> — 주거지역 접근 도로
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="서비스 도로·철도 세부 유형">[[Key: service|service=*]]</code> || 서비스 도로·철도의 세부 용도 || <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=서비스 도로">[[Key: highway|highway=service]]</code>와 조합
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="표면 재질">[[Key: surface|surface=*]]</code> || 길 표면의 실제 재질 || <code class="kosm-tag-reference kosm-tag-reference--link" title="표면 재질=아스팔트">[[Key: surface|surface=asphalt]]</code> — 아스팔트
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code> || 공식적인 통행 허용·제한 || <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code> — 사유 통행
|}

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

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

=== 값 입력 방법 ===
길 방향을 기준으로 통행 방향을 기록합니다.

* <code class="kosm-tag-reference" title="일방통행=길 방향으로만 통행">oneway=yes</code> — 길 방향으로만 통행
* <code class="kosm-tag-reference" title="일방통행=양방향 통행">oneway=no</code> — 양방향 통행
* <code class="kosm-tag-reference" title="일방통행=길 반대 방향으로만 통행">oneway=-1</code> — 길 반대 방향으로만 통행. '''길을 그린 방향을 뒤집으면 이 값을 쓰지 않아도 됩니다.'''

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로">[[Key: highway|highway]]</code> || 도로·보행로의 기능과 네트워크상 중요도를 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:highway OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="표면 재질">[[Key: surface|surface]]</code> || 길이나 공간의 실제 표면 재질을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:surface OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="통행 가능 수준">[[Key: smoothness|smoothness]]</code> || 바퀴 달린 이동수단이 표면을 이용하기 쉬운 정도를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:smoothness OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="차로 수">[[Key: lanes|lanes]]</code> || 도로의 일반적인 차로 수를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:lanes OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="최고 제한속도">[[Key: maxspeed|maxspeed]]</code> || 표지나 법규로 정해진 최고 제한속도를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:maxspeed OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access]]</code> || 법적·공식적으로 허용되는 출입 또는 통행 대상을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:access OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="보도 배치">[[Key: sidewalk|sidewalk]]</code> || 도로에 나란히 있는 보도의 존재와 위치를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:sidewalk OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="교량">[[Key: bridge|bridge]]</code> || 지물이 다리 위를 통과하거나 다리 구조 자체임을 뜻합니다. || [https://wiki.openstreetmap.org/wiki/Key:bridge OSM Wiki]
|}

=== 참고 문서 ===
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 [https://wiki.openstreetmap.org/wiki/Key:oneway OSM Wiki — Key:oneway]에서 확인합니다.

[[분류:KOSM 태그 사전]]