Key: height: 두 판 사이의 차이

2026년 8월 31일 (월) 14:18 기준 최신판

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에서 확인합니다.

@@ 1번째 줄: / 1번째 줄: @@
-[[KOSM Feature Key Reference]]로 돌아가기
+[[KOSM Feature Key Reference|K-OSM Feature Key Reference]]로 돌아가기
 === Key 개요 ===
@@ 41번째 줄: / 41번째 줄: @@
 === 주요 Value ===
-아래 표에는 '''KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:height OSM Wiki — Key:height]에서 확인합니다.
+아래 표에는 '''K-OSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:height OSM Wiki — Key:height]에서 확인합니다.
 {| class="wikitable"
@@ 77번째 줄: / 77번째 줄: @@
 [[분류:KOSM 태그 사전]]