Key: building:levels

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`building:levels`	지상층수 — 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다.	OSM 태그	건물 면	`integer`	OSM Wiki

어떻게 사용하나요?

building:levels=*는 지표면 위에 있는 사용 가능한 층의 개수를 셉니다. 건물의 높이가 아니라 층수이며, 지하층은 여기에 포함되지 않습니다.

지붕층은 roof:levels=*, 지하층은 building:levels:underground=*, 실제 높이는 height=*가 각각 담습니다. 한 건물 안에서 층수가 다른 부분은 building:part=*로 나눕니다.

적용 대상

building:levels=*는 일반적으로 건물 면에 적용합니다.

층수가 동일한 건물 면 또는 건물 부분 면에 붙입니다. 서로 다른 높이의 동·증축부를 하나의 값으로 평균내지 말고 building:part=* 단위로 나눕니다.

Value 선택

지표면 위의 사용 가능한 층 수를 양의 정수로 기록하며 지붕층은 roof:levels=*, 지하층은 building:levels:underground=*로 분리합니다. 층고가 특이하다는 이유로 소수 층을 만들지 말고 실제 높이는 height=*를 사용합니다.

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

비슷한 Key와 구분하기

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

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

주요 Value

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

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`building:levels=1`	지상 1층	지상에서 사용 가능한 층이 1개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 `building:levels:underground=`, `roof:levels=`로 분리합니다.	OSM 태그	Key 문서에서 확인
`building:levels=2`	지상 2층	지상에서 사용 가능한 층이 2개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 `building:levels:underground=`, `roof:levels=`로 분리합니다.	OSM 태그	Key 문서에서 확인
`building:levels=3`	지상 3층	지상에서 사용 가능한 층이 3개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 `building:levels:underground=`, `roof:levels=`로 분리합니다.	OSM 태그	Key 문서에서 확인
`building:levels=5`	지상 5층	지상에서 사용 가능한 층이 5개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 `building:levels:underground=`, `roof:levels=`로 분리합니다.	OSM 태그	Key 문서에서 확인
`building:levels=15`	지상 15층	지상에서 사용 가능한 층이 15개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 `building:levels:underground=`, `roof:levels=`로 분리합니다.	OSM 태그	Key 문서에서 확인

함께 사용하는 Key

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

관련 Key	역할	공식 문서
`building`	출입구가 연결되는 건물의 물리적 유형과 외곽을 표현합니다.	OSM Wiki
`building:use`	건물의 건축적 유형과 구분하여 현재의 전반적인 이용 방식을 기록합니다.	OSM Wiki
`building:main_use`	KOSM 분류 기준에서 건축물의 대표 주용도를 기록합니다.	-
`height`	건물이나 구조물의 실제 높이를 미터 단위로 기록합니다.	OSM Wiki
`entrance`	건물이나 둘러싸인 영역에 들어가고 나오는 실제 위치와 종류를 뜻합니다.	OSM Wiki
`amenity`	방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다.	OSM Wiki
`shop`	상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다.	OSM Wiki

참고 문서

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