Key: tunnel 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="터널">tunnel</code> || '''터널''' — 길·철도·수로가 지하나 구조물 아래를 통과하는 구간임을 뜻합니다. || '''OSM 태그''' || 길 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:tunnel OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="터널">tunnel=*</code>는 '''이 구간이 지반이나 구조물에 둘러싸여 통과하는가'''를 뜻합니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="교량">[[Key: bridge|bridge=*]]</code>와 짝을 이루는 반대 개념이지만, 한 교차 지점에 두 Key를 동시에 쓰지는 않습니다. 위를 지나는 쪽에만 <code class="kosm-tag-reference kosm-tag-reference--link" title="교량">[[Key: bridge|bridge]]</code>를, 아래로 관통하는 쪽에만 <code class="kosm-tag-reference" title="터널">tunnel</code>을 씁니다.

값에 따라 성격이 나뉩니다. 일반 터널, 짧은 배수 통로(<code>culvert</code>), 건물 아래 통과로(<code>building_passage</code>)는 구조가 서로 다릅니다.

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

지하 또는 구조물 내부에 둘러싸여 통과하는 도로·철도·수로 길의 그 구간에 붙입니다. 터널 입구에서 길을 나눠 지상 구간과 섞이지 않게 합니다.

==== Value 선택 ====
흙이나 구조물에 둘러싸여 아래로 통과하는 구간에 사용하고 입구에서 길을 나눕니다. 짧은 배수 통로는 <code>culvert</code>, 건물 아래 통과로는 <code>building_passage</code>처럼 성격을 구분하며, 단순한 교량 아래 길까지 자동으로 터널 처리하지 않습니다.

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

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="터널=일반 터널">tunnel=yes</code> || 일반 터널 || 길·철도·수로가 지하를 통과하는 일반 터널 구간에 사용합니다. 입구에서 출구까지 길을 나누고 보통 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=-1]]</code>을 함께 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:tunnel Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="터널=하천·배수로가 지나는 암거">tunnel=culvert</code> || 하천·배수로가 구조물 아래를 지나는 암거 || 하천·배수로가 도로·철도 같은 구조물 아래의 짧은 관로나 암거를 통과할 때 주로 사용합니다. 긴 하천 터널이나 사람이 통행하는 일반 터널에는 사용하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:tunnel%3Dculvert Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="터널=건물 내부나 아래를 통과하는 구간">tunnel=building_passage</code> || 건물 내부 또는 아래를 통과하는 길 || 도로·보행로가 건물의 일부 아래나 내부 통로를 통과하지만 건물 밖으로 계속 이어질 때 사용합니다. 건물 내부에서 끝나는 복도와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:tunnel%3Dbuilding_passage Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="터널=완전히 지하가 아닌 덮개형 구간">tunnel=covered</code> || 완전히 지하가 아닌 덮개형 구간 || 절개 구간 위를 덮거나 반개방 구조를 덮은 구간처럼 완전한 지하 굴착 터널과 다른 덮개형 통로에 사용합니다. 실제 구조를 확인하지 않고 지하라는 이유만으로 선택하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:tunnel Key 문서에서 확인]
|}

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name]]</code> || 출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:name OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="참조 번호">[[Key: ref|ref]]</code> || 출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:ref OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="보충 설명">[[Key: description|description]]</code> || 다른 정형 태그로 표현하기 어려운 보충 설명을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:description OSM Wiki]
|}

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

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