Key: addr:city 문서 원본 보기

[[KOSM Feature Key Reference|K-OSM Feature Key Reference]]로 돌아가기

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="특별·광역·시도">addr:city</code> || '''특별·광역·시도''' — OSM의 addr:city를 K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. || '''OSM 태그''' '''의미 변형''' || 주로 노드·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="특별·광역·시도">addr:city=*</code>는 K-OSM 주소 체계에서 '''특별시·광역시·특별자치시·도·특별자치도 단위'''를 담도록 의미를 고정한 Key입니다.

이는 OSM의 국제적 관행(‘도시’ 이름)과 범위가 다른 K-OSM만의 해석입니다. 내보내기·변환할 때 이 차이를 반드시 명시적으로 처리해야 합니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="특별·광역·시도">addr:city=*</code>는 일반적으로 '''주로 노드·면'''에 적용합니다.

주소가 부여된 건물·출입구·주소 노드에 K-OSM의 시·도 계층으로 적용합니다. 행정경계 자체의 이름을 기록하는 Key는 아닙니다.

==== Value 선택 ====
K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위를 담도록 의미를 고정합니다. OSM의 국제적 <code class="kosm-tag-reference" title="특별·광역·시도">addr:city</code> 관례와 범위가 다를 수 있으므로 K-OSM 내보내기·변환 시 이 의미 변형을 명시적으로 처리합니다.

'''확인되지 않은 값은 짐작해서 넣지 않습니다.''' 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="특별·광역·시도">addr:city=서울특별시</code> || 특별시 || 실제 주소의 광역 행정단위가 ‘서울특별시’일 때 이 Key에 적습니다. K-OSM에서는 이 Key가 시·도 단위를 뜻하므로, 도시 이름을 담는 OSM의 일반 관행과 범위가 다릅니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="특별·광역·시도">addr:city=경기도</code> || 도 || 실제 주소의 광역 행정단위가 ‘경기도’일 때 이 Key에 적습니다. K-OSM에서는 이 Key가 시·도 단위를 뜻하므로, 도시 이름을 담는 OSM의 일반 관행과 범위가 다릅니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity Key 문서에서 확인]
|}

=== 함께 사용하는 Key ===
Key가 비슷해 보여도 '''각각 나타내는 정보가 다릅니다.''' 하나의 Key에 여러 의미를 넣지 말고, '''정보의 종류에 맞는 Key를 각각 사용합니다.'''

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="시·군·구">[[Key: addr:district|addr:district]]</code> || OSM의 addr:district를 K-OSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Adistrict OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="읍·면·동">[[Key: addr:subdistrict|addr:subdistrict]]</code> || OSM의 addr:subdistrict를 K-OSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Asubdistrict OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="도로명">[[Key: addr:street|addr:street]]</code> || 주소가 속한 도로의 이름을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Astreet OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물번호">[[Key: addr:housenumber|addr:housenumber]]</code> || 도로명주소의 건물번호를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Ahousenumber OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="우편번호">[[Key: addr:postcode|addr:postcode]]</code> || 해당 주소의 우편번호를 기록합니다. 대한민국은 2015년부터 5자리 국가기초구역번호를 사용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Apostcode OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물 내부 단위">[[Key: addr:unit|addr:unit]]</code> || 동·호처럼 하나의 주소 안에서 개별 점유 공간을 구분하는 단위를 기록합니다. 층은 level=* 또는 addr:floor=*로 따로 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Aunit OSM Wiki]
|}

=== 참고 문서 ===
이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity OSM Wiki — Key:addr:city]에서 확인합니다.

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