Key: height
K-OSM Feature Key Reference로 돌아가기
Key 개요
| Key | 의미 | 태그 구분 | 적용 형태 | 값 형식 | 공식 문서 |
|---|---|---|---|---|---|
height |
높이(미터) — 지물의 전체 높이를 기록합니다. 단위가 없으면 미터로 해석합니다. | OSM 태그 | 노드·길·면 | numeric(11,2) |
OSM Wiki |
어떻게 사용하나요?
height=*는 지면의 가장 낮은 접점에서 구조물 꼭대기까지의 전체 높이를 기본 미터 단위로 담습니다. 층수에서 환산한 추정값이 아니라 실제 높이입니다.
해발고도인 ele=*, 층수인 building:levels=*와 자주 혼동됩니다. 부분마다 높이가 다른 건물은 building:part=* 단위로 나누어 적습니다.
적용 대상
height=*는 일반적으로 노드·길·면에 적용합니다.
높이가 동일한 건물·구조물·수직 지물 객체에 붙입니다. 건물 부분마다 높이가 다르면 전체 외곽이 아니라 해당 building:part=* 면에 적습니다.
Value 선택
지면의 가장 낮은 접점부터 구조물 꼭대기까지의 전체 높이를 기록하며 기본 단위는 미터입니다. 지붕을 포함하는지 대상 정의를 확인하고, 해발고도인 ele=*, 층수인 building:levels=*와 혼동하지 않습니다.
확인되지 않은 값은 짐작해서 넣지 않습니다. 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.
비슷한 Key와 구분하기
비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.
| Key | 무엇을 기록하나요? | 예시·구분 기준 |
|---|---|---|
level=* |
건물·실내에서 대상이 위치하거나 연결되는 층 | level=-1 — 지하 1층
|
layer=* |
교차 구조에서 지물 사이의 상대적인 위아래 순서 | 층수나 고도가 아님 |
location=* |
지하·지상·해상 같은 위치 환경 | location=underground
|
building:levels=* |
건물 전체의 지상층 수 | building:levels=15
|
ele=* |
해수면을 기준으로 한 지점의 고도 | 건물 높이와 구분 |
주요 Value
아래 표에는 K-OSM에서 중요하게 다루거나 자주 사용하는 주요 Value를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 OSM Wiki — Key:height에서 확인합니다.
| Value | 의미 | 언제·어떻게 사용하나요? | 태그 구분 | OSM Wiki |
|---|---|---|---|---|
height=4 |
높이 4m | 지면에서 구조물 최고점까지의 실제 높이가 4m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. | OSM 태그 | Key 문서에서 확인 |
height=4.5 |
높이 4.5m | 지면에서 구조물 최고점까지의 실제 높이가 4.5m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. | OSM 태그 | Key 문서에서 확인 |
height=8 |
높이 8m | 지면에서 구조물 최고점까지의 실제 높이가 8m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. | OSM 태그 | Key 문서에서 확인 |
값 입력 방법
단위를 생략한 숫자는 미터로 해석합니다. 소수점은 마침표로 적습니다.
height=12.5— 높이 12.5m- 미터임을 분명히 하려면
height=12.5 m처럼 값과 단위를 한 칸 띄어 적습니다. - 피트·인치는 예외입니다. 단위 약자를 붙이지 않고
height=7'4"처럼 작은따옴표와 큰따옴표로 적으며 사이를 띄우지 않습니다.
함께 사용하는 Key
Key가 비슷해 보여도 각각 나타내는 정보가 다릅니다. 하나의 Key에 여러 의미를 넣지 말고, 정보의 종류에 맞는 Key를 각각 사용합니다.
| 관련 Key | 역할 | 공식 문서 |
|---|---|---|
name |
출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다. | OSM Wiki |
ref |
출입구 번호·도로 번호·정류장 번호처럼 외부에서 사용하는 식별자를 기록합니다. | OSM Wiki |
description |
다른 정형 태그로 표현하기 어려운 보충 설명을 기록합니다. | OSM Wiki |
참고 문서
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:height에서 확인합니다.