Key: tunnel

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`tunnel`	터널 — 길·철도·수로가 지하나 구조물 아래를 통과하는 구간임을 뜻합니다.	OSM 태그	길	`text`	OSM Wiki

어떻게 사용하나요?

tunnel=*는 이 구간이 지반이나 구조물에 둘러싸여 통과하는가를 뜻합니다. bridge=*와 짝을 이루는 반대 개념이지만, 한 교차 지점에 두 Key를 동시에 쓰지는 않습니다. 위를 지나는 쪽에만 bridge를, 아래로 관통하는 쪽에만 tunnel을 씁니다.

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

적용 대상

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

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

Value 선택

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

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

주요 Value

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

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

함께 사용하는 Key

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

관련 Key	역할	공식 문서
`name`	출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다.	OSM Wiki
`ref`	출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다.	OSM Wiki
`description`	다른 정형 태그로 표현하기 어려운 보충 설명을 기록합니다.	OSM Wiki

참고 문서

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