Key: height 문서 원본 보기

[[KOSM Feature Key Reference]]로 돌아가기

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="높이(미터)">height</code> || '''높이(미터)''' — 지물의 전체 높이를 기록합니다. 단위가 없으면 미터로 해석합니다. || '''OSM 태그''' || 노드·길·면 || <code>numeric(11,2)</code> || [https://wiki.openstreetmap.org/wiki/Key:height OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="높이(미터)">height=*</code>는 '''지면의 가장 낮은 접점에서 구조물 꼭대기까지의 전체 높이'''를 기본 미터 단위로 담습니다. 층수에서 환산한 추정값이 아니라 실제 높이입니다.

해발고도인 <code class="kosm-tag-reference" title="해발 고도">ele=*</code>, 층수인 <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=*]]</code>와 자주 혼동됩니다. 부분마다 높이가 다른 건물은 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code> 단위로 나누어 적습니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="높이(미터)">height=*</code>는 일반적으로 '''노드·길·면'''에 적용합니다.

높이가 동일한 건물·구조물·수직 지물 객체에 붙입니다. 건물 부분마다 높이가 다르면 전체 외곽이 아니라 해당 <code class="kosm-tag-reference" title="건물을 이루는 부분 구조">building:part=*</code> 면에 적습니다.

==== Value 선택 ====
지면의 가장 낮은 접점부터 구조물 꼭대기까지의 전체 높이를 기록하며 기본 단위는 미터입니다. 지붕을 포함하는지 대상 정의를 확인하고, 해발고도인 <code class="kosm-tag-reference" title="해발 고도">ele=*</code>, 층수인 <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels=*]]</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: 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" title="해발 고도">ele=*</code> || 해수면을 기준으로 한 지점의 고도 || 건물 높이와 구분
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="높이(미터)">height=4</code> || 높이 4m || 지면에서 구조물 최고점까지의 실제 높이가 4m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:height Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="높이(미터)">height=4.5</code> || 높이 4.5m || 지면에서 구조물 최고점까지의 실제 높이가 4.5m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:height Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="높이(미터)">height=8</code> || 높이 8m || 지면에서 구조물 최고점까지의 실제 높이가 8m일 때 기록합니다. 층수에 평균 층고를 곱해 추정하지 않으며 지붕 높이·최소 통과 높이와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:height Key 문서에서 확인]
|}

=== 값 입력 방법 ===
단위를 생략한 숫자는 미터로 해석합니다. 소수점은 마침표로 적습니다.

* <code class="kosm-tag-reference" title="높이(미터)">height=12.5</code> — 높이 12.5m
* 미터임을 분명히 하려면 <code class="kosm-tag-reference" title="높이(미터)">height=12.5 m</code>처럼 값과 단위를 한 칸 띄어 적습니다.
* '''피트·인치는 예외입니다.''' 단위 약자를 붙이지 않고 <code class="kosm-tag-reference" title="높이(미터)">height=7'4"</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:height OSM Wiki — Key:height]에서 확인합니다.

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