Key: location 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="위치">location</code> || '''위치''' — 지물이 지하·지상·해상 등 어느 환경에 위치하는지 기록합니다. || '''OSM 태그''' || 노드·길·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:location OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="위치">location=*</code>는 '''지물이 지하·수중·해상 등 어떤 환경에 놓여 있는가'''를 뜻합니다. 높낮이 순서를 정하는 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code>나 건물 안 층을 가리키는 <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=*]]</code>과는 다른 종류의 정보입니다.

지물 핵심 태그가 이미 환경을 충분히 설명하는 경우(예: 터널 구간)에는 굳이 반복하지 않습니다. 주로 관로·전선·저장 설비처럼 겉으로 드러나지 않는 시설에서 의미가 큽니다.

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

지하·수중·해상이라는 환경 정보가 필요한 설비나 경로 객체에 붙입니다. 교차 지물의 단순 상대 순서만 설명하는 경우에는 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code>가 더 적합합니다.

==== Value 선택 ====
대상이 지하·수중·해상 등 어떤 환경에 놓였는지를 뜻합니다. 단순한 위아래 순서인 <code class="kosm-tag-reference kosm-tag-reference--link" title="레이어">[[Key: layer|layer=*]]</code>나 실내 층 위치인 <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=*]]</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: 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 ===
아래 표에는 '''KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:location OSM Wiki — Key:location]에서 확인합니다.

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="위치=지하">location=underground</code> || 지하에 위치 || 대상 전체가 지표면 아래에 위치할 때 사용합니다. 짧은 터널 구간은 <code class="kosm-tag-reference kosm-tag-reference--link" title="터널">[[Key: tunnel|tunnel=*]]</code>, 건물 층은 <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="레이어">[[Key: layer|layer=*]]</code>로 각각 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:location%3Dunderground Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="위치=해상">location=offshore</code> || 해안에서 떨어진 해상에 위치 || 대상이 해안선에서 떨어진 해상에 위치할 때 사용합니다. 해변·부두처럼 육지와 연결된 시설을 단순히 물가에 있다는 이유로 <code>offshore</code>로 분류하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:location Key 문서에서 확인]
|}

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

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