Key: building:levels 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels</code> || '''지상층수''' — 지표면 위에서 보이는 건물 층수를 숫자로 기록합니다. || '''OSM 태그''' || 건물 면 || <code>integer</code> || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="지상층수">building:levels=*</code>는 '''지표면 위에 있는 사용 가능한 층의 개수'''를 셉니다. 건물의 높이가 아니라 층수이며, 지하층은 여기에 포함되지 않습니다.

지붕층은 <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>, 지하층은 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, 실제 높이는 <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height=*]]</code>가 각각 담습니다. 한 건물 안에서 층수가 다른 부분은 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code>로 나눕니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="지상층수">building:levels=*</code>는 일반적으로 '''건물 면'''에 적용합니다.

층수가 동일한 건물 면 또는 건물 부분 면에 붙입니다. 서로 다른 높이의 동·증축부를 하나의 값으로 평균내지 말고 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code> 단위로 나눕니다.

==== Value 선택 ====
지표면 위의 사용 가능한 층 수를 양의 정수로 기록하며 지붕층은 <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>, 지하층은 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>로 분리합니다. 층고가 특이하다는 이유로 소수 층을 만들지 말고 실제 높이는 <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height=*]]</code>를 사용합니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=*]]</code> || 건물·실내에서 대상이 위치하거나 연결되는 층 || <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=-1]]</code> — 지하 1층
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code> || 교차 구조에서 지물 사이의 상대적인 위아래 순서 || 층수나 고도가 아님
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="위치">[[Key: location|location=*]]</code> || 지하·지상·해상 같은 위치 환경 || <code class="kosm-tag-reference kosm-tag-reference--link" title="위치=지하">[[Key: location|location=underground]]</code>
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height=*]]</code> || 지물의 물리적인 전체 높이 || 단위가 없으면 미터
|-
| <code class="kosm-tag-reference" title="해발 고도">ele=*</code> || 해수면을 기준으로 한 지점의 고도 || 건물 높이와 구분
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels=1</code> || 지상 1층 || 지상에서 사용 가능한 층이 1개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>로 분리합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels=2</code> || 지상 2층 || 지상에서 사용 가능한 층이 2개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>로 분리합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels=3</code> || 지상 3층 || 지상에서 사용 가능한 층이 3개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>로 분리합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels=5</code> || 지상 5층 || 지상에서 사용 가능한 층이 5개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>로 분리합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="지상층수">building:levels=15</code> || 지상 15층 || 지상에서 사용 가능한 층이 15개인 건물에 적습니다. 지하층과 지붕층은 포함하지 않고 각각 <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground=*]]</code>, <code class="kosm-tag-reference" title="지붕이 차지하는 층수">roof:levels=*</code>로 분리합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels Key 문서에서 확인]
|}

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building]]</code> || 출입구가 연결되는 건물의 물리적 유형과 외곽을 표현합니다. || [https://wiki.openstreetmap.org/wiki/Key:building OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use]]</code> || 건물의 건축적 유형과 구분하여 현재의 전반적인 이용 방식을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:building%3Ause OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use]]</code> || K-OSM 분류 기준에서 건축물의 대표 주용도를 기록합니다. || -
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height]]</code> || 건물이나 구조물의 실제 높이를 미터 단위로 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:height OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 출입구">[[Key: entrance|entrance]]</code> || 건물이나 둘러싸인 영역에 들어가고 나오는 실제 위치와 종류를 뜻합니다. || [https://wiki.openstreetmap.org/wiki/Key:entrance OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity]]</code> || 방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:amenity OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop]]</code> || 상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:shop OSM Wiki]
|}

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

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