Key: level

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`level`	OSM 층 레벨 — 실내 시설이나 출입구의 층을 0 기준으로 기록합니다. 지상 기준층은 0, 그 위층은 1, 첫 지하층은 -1입니다.	OSM 태그	노드·길·면	`text`	OSM Wiki

어떻게 사용하나요?

level=*은 건물 안에서 몇 번째 층에 있는가를 OSM의 0 기준 순서로 나타냅니다. 한국식 ‘1층’이 level=0이 되는 것이 이 Key에서 가장 자주 틀리는 부분입니다.

지상 기준층이 0, 그 위층이 1, 첫 지하층이 -1입니다. 엘리베이터 버튼에 적힌 실제 표기(1, B1)가 필요하면 level:ref=*로 따로 적습니다.

적용 대상

level=*는 일반적으로 노드·길·면에 적용합니다.

실내 공간·출입구·통로 등 건물 안에서 층 위치가 필요한 노드·길·면에 붙입니다. OSM의 0 기준 순서를 사용하고 현장 표기는 필요하면 level:ref=*로 분리하며, 건물 전체 층수를 뜻하지 않습니다.

Value 선택

OSM의 0 기준 층 순서를 사용하므로 한국식 지상 1층은 보통 level=0, 2층은 level=1, 지하 1층은 level=-1입니다. 엘리베이터·안내판의 실제 표기는 level:ref=1·B1처럼 별도로 기록합니다. 전체 층수인 building:levels=*, 교차 지물의 상대 순서인 layer=*와 구분합니다.

한국식 1층을 level=1로 입력하지 않습니다. OSM에서는 지상 기준층이 level=0이며 현장 표기는 level:ref=*로 구분합니다.

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

비슷한 Key와 구분하기

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

Key	무엇을 기록하나요?	예시·구분 기준
`layer=*`	교차 구조에서 지물 사이의 상대적인 위아래 순서	층수나 고도가 아님
`location=*`	지하·지상·해상 같은 위치 환경	`location=underground`
`building:levels=*`	건물 전체의 지상층 수	`building:levels=15`
`height=*`	지물의 물리적인 전체 높이	단위가 없으면 미터
`ele=*`	해수면을 기준으로 한 지점의 고도	건물 높이와 구분

주요 Value

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

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`level=0`	지상 기준층(한국식 1층)	건물·실내 체계에서 기준 지상층에 있는 출입구·시설에 사용합니다. 한국식 ‘1층’ 표기와 OSM의 층 번호 체계가 다를 수 있으므로 건물 내부 레벨 기준을 확인합니다.	OSM 태그	Tag 문서에서 확인
`level=1`	기준층 바로 위층(한국식 2층)	해당 실내 레벨 체계에서 기준층보다 한 층 위인 level 1에 사용합니다. 현장 층 표기와 OSM level 번호의 대응을 먼저 확인합니다.	OSM 태그	Tag 문서에서 확인
`level=-1`	첫 지하층(보통 B1)	기준 지상층 바로 아래의 지하 level -1에 사용합니다. 교차 구조의 상대 순서인 `layer=-1`과 구분합니다.	OSM 태그	Tag 문서에서 확인

값 입력 방법

현장 층 이름이 아니라 OSM의 0 기준 수직 순서를 숫자로 기록합니다.

level=0 — 지상 기준층(한국식 1층)
level=1 — 기준층 바로 위층(한국식 2층)
level=-1 — 첫 지하층(보통 B1)
두 개 층에 걸쳐 있으면 세미콜론으로 나열합니다. 예: level=0;1
빠지는 층 없이 이어지면 붙임표로 범위를 적습니다. 예: level=-2-32
현장 표기가 다르면 level:ref=*에 함께 기록합니다.
layer=*와 의미가 다릅니다.

함께 사용하는 Key

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

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

참고 문서

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