Key: level
K-OSM Feature Key Reference로 돌아가기
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
아래 표에는 K-OSM에서 중요하게 다루거나 자주 사용하는 주요 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에서 확인합니다.