Key: level 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="OSM 층 레벨">level</code> || '''OSM 층 레벨''' — 실내 시설이나 출입구의 층을 0 기준으로 기록합니다. 지상 기준층은 0, 그 위층은 1, 첫 지하층은 -1입니다. || '''OSM 태그''' || 노드·길·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:level OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="OSM 층 레벨">level=*</code>은 '''건물 안에서 몇 번째 층에 있는가'''를 OSM의 0 기준 순서로 나타냅니다. 한국식 ‘1층’이 <code class="kosm-tag-reference" title="OSM 층 레벨">level=0</code>이 되는 것이 이 Key에서 가장 자주 틀리는 부분입니다.

지상 기준층이 <code>0</code>, 그 위층이 <code>1</code>, 첫 지하층이 <code>-1</code>입니다. 엘리베이터 버튼에 적힌 실제 표기(<code>1</code>, <code>B1</code>)가 필요하면 <code class="kosm-tag-reference" title="층에 붙은 현장 표기">level:ref=*</code>로 따로 적습니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="OSM 층 레벨">level=*</code>는 일반적으로 '''노드·길·면'''에 적용합니다.

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

==== Value 선택 ====
OSM의 0 기준 층 순서를 사용하므로 한국식 지상 1층은 보통 <code class="kosm-tag-reference" title="OSM 층 레벨">level=0</code>, 2층은 <code class="kosm-tag-reference" title="OSM 층 레벨">level=1</code>, 지하 1층은 <code class="kosm-tag-reference" title="OSM 층 레벨">level=-1</code>입니다. 엘리베이터·안내판의 실제 표기는 <code class="kosm-tag-reference" title="층에 붙은 현장 표기">level:ref=1</code>·<code>B1</code>처럼 별도로 기록합니다. 전체 층수인 <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=*]]</code>, 교차 지물의 상대 순서인 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code>와 구분합니다.

한국식 1층을 <code class="kosm-tag-reference" title="OSM 층 레벨">level=1</code>로 입력하지 않습니다. OSM에서는 '''지상 기준층이 <code class="kosm-tag-reference" title="OSM 층 레벨">level=0</code>'''이며 현장 표기는 <code class="kosm-tag-reference" title="층에 붙은 현장 표기">level:ref=*</code>로 구분합니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <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: building:levels|building:levels=*]]</code> || 건물 전체의 지상층 수 || <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=15]]</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:level OSM Wiki — Key:level]에서 확인합니다.

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="OSM 층 레벨">level=0</code> || 지상 기준층(한국식 1층) || 건물·실내 체계에서 기준 지상층에 있는 출입구·시설에 사용합니다. 한국식 ‘1층’ 표기와 OSM의 층 번호 체계가 다를 수 있으므로 건물 내부 레벨 기준을 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:level%3D0 Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="OSM 층 레벨">level=1</code> || 기준층 바로 위층(한국식 2층) || 해당 실내 레벨 체계에서 기준층보다 한 층 위인 level 1에 사용합니다. 현장 층 표기와 OSM level 번호의 대응을 먼저 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:level%3D1 Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="OSM 층 레벨">level=-1</code> || 첫 지하층(보통 B1) || 기준 지상층 바로 아래의 지하 level -1에 사용합니다. 교차 구조의 상대 순서인 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=-1]]</code>과 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:level%3D-1 Tag 문서에서 확인]
|}

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

* <code class="kosm-tag-reference" title="OSM 층 레벨">level=0</code> — 지상 기준층(한국식 1층)
* <code class="kosm-tag-reference" title="OSM 층 레벨">level=1</code> — 기준층 바로 위층(한국식 2층)
* <code class="kosm-tag-reference" title="OSM 층 레벨">level=-1</code> — 첫 지하층(보통 B1)
* 두 개 층에 걸쳐 있으면 세미콜론으로 나열합니다. 예: <code class="kosm-tag-reference" title="OSM 층 레벨">level=0;1</code>
* 빠지는 층 없이 이어지면 붙임표로 범위를 적습니다. 예: <code class="kosm-tag-reference" title="OSM 층 레벨">level=-2-32</code>
* 현장 표기가 다르면 <code class="kosm-tag-reference" title="층에 붙은 현장 표기">level:ref=*</code>에 함께 기록합니다.
* <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code>와 의미가 다릅니다.

=== 함께 사용하는 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:level OSM Wiki — Key:level]에서 확인합니다.

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