Key: addr:unit: 두 판 사이의 차이

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

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`addr:unit`	건물 내부 단위 — 동·호처럼 하나의 주소 안에서 개별 점유 공간을 구분하는 단위를 기록합니다. 층은 level=* 또는 addr:floor=*로 따로 기록합니다.	OSM 태그	주로 노드·면	`text`	OSM Wiki

어떻게 사용하나요?

addr:unit=*은 하나의 건물 주소 안에서 개별 점유 공간을 구별하는 부분을 담습니다. 상가동·101호처럼 주소의 마지막 단위에 해당합니다.

층은 이 Key가 아니라 level=*(OSM 층 순서)나 addr:floor=*가 담습니다. 건물 전체 객체에 모든 호수를 나열하지 않습니다.

적용 대상

addr:unit=*는 일반적으로 주로 노드·면에 적용합니다.

동·층·호처럼 개별 내부 공간을 나타내는 실내 객체나 주소점에 붙입니다. 건물 전체 객체에 모든 세대 번호를 나열하지 않습니다.

Value 선택

하나의 건물 주소 안에서 동·층·호 등 개별 점유 공간을 구분할 때 사용합니다. 건물 전체 주소 객체에 모든 호수를 나열하지 말고, 해당 실내 공간이나 출입구가 독립 객체로 매핑된 경우에 붙입니다.

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

주요 Value

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

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`addr:unit=101호`	호 단위	실제 주소의 동·호 같은 세부 단위가 ‘101호’일 때 이 Key에 적습니다. 층은 이 Key가 아니라 `level=`이나 `addr:floor=`에 적습니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다.	OSM 태그	Key 문서에서 확인
`addr:unit=상가동`	동 단위	실제 주소의 동·호 같은 세부 단위가 ‘상가동’일 때 이 Key에 적습니다. 층은 이 Key가 아니라 `level=`이나 `addr:floor=`에 적습니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다.	OSM 태그	Key 문서에서 확인

함께 사용하는 Key

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

관련 Key	역할	공식 문서
`addr:city`	OSM의 addr:city를 K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다.	OSM Wiki
`addr:district`	OSM의 addr:district를 K-OSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다.	OSM Wiki
`addr:subdistrict`	OSM의 addr:subdistrict를 K-OSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다.	OSM Wiki
`addr:street`	주소가 속한 도로의 이름을 기록합니다.	OSM Wiki
`addr:housenumber`	도로명주소의 건물번호를 기록합니다.	OSM Wiki
`addr:postcode`	해당 주소의 우편번호를 기록합니다. 대한민국은 2015년부터 5자리 국가기초구역번호를 사용합니다.	OSM Wiki

참고 문서

이 Key의 전체 정의와 조합 방법, 최신 사용 기준은 OSM Wiki — Key:addr:unit에서 확인합니다.

@@ 1번째 줄: / 1번째 줄: @@
-[[KOSM Feature Key Reference]]로 돌아가기
+[[KOSM Feature Key Reference|K-OSM Feature Key Reference]]로 돌아가기
 === Key 개요 ===
@@ 24번째 줄: / 24번째 줄: @@
 === 주요 Value ===
-아래 표에는 '''KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:addr%3Aunit OSM Wiki — Key:addr:unit]에서 확인합니다.
+아래 표에는 '''K-OSM에서 중요하게 다루거나 자주 사용하는 주요 Value'''를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. '''정보가 없거나 실제 상태를 판단할 수 없으면 임의의 Value를 선택하지 말고 해당 Key를 입력하지 않습니다.''' 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 [https://wiki.openstreetmap.org/wiki/Key:addr%3Aunit OSM Wiki — Key:addr:unit]에서 확인합니다.
 {| class="wikitable"
@@ 40번째 줄: / 40번째 줄: @@
 ! 관련 Key !! 역할 !! 공식 문서
 |-
-| <code class="kosm-tag-reference kosm-tag-reference--link" title="특별·광역·시도">[[Key: addr:city|addr:city]]</code> || OSM의 addr:city를 KOSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity OSM Wiki]
+| <code class="kosm-tag-reference kosm-tag-reference--link" title="특별·광역·시도">[[Key: addr:city|addr:city]]</code> || OSM의 addr:city를 K-OSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Acity OSM Wiki]
 |-
-| <code class="kosm-tag-reference kosm-tag-reference--link" title="시·군·구">[[Key: addr:district|addr:district]]</code> || OSM의 addr:district를 KOSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Adistrict OSM Wiki]
+| <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를 KOSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다. || [https://wiki.openstreetmap.org/wiki/Key:addr%3Asubdistrict 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]
@@ 57번째 줄: / 57번째 줄: @@
 [[분류:KOSM 태그 사전]]