Key: addr:city

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
`addr:city`	특별·광역·시도 — OSM의 addr:city를 KOSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위로 의미를 변형하여 적용합니다.	OSM 태그 의미 변형	주로 노드·면	`text`	OSM Wiki

어떻게 사용하나요?

addr:city=*는 KOSM 주소 체계에서 특별시·광역시·특별자치시·도·특별자치도 단위를 담도록 의미를 고정한 Key입니다.

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

적용 대상

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

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

Value 선택

KOSM 주소 체계에서는 특별시·광역시·특별자치시·도·특별자치도 단위를 담도록 의미를 고정합니다. OSM의 국제적 addr:city 관례와 범위가 다를 수 있으므로 KOSM 내보내기·변환 시 이 의미 변형을 명시적으로 처리합니다.

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

주요 Value

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

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
`addr:city=서울특별시`	특별시	실제 주소의 광역 행정단위가 ‘서울특별시’일 때 이 Key에 적습니다. KOSM에서는 이 Key가 시·도 단위를 뜻하므로, 도시 이름을 담는 OSM의 일반 관행과 범위가 다릅니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다.	OSM 태그	Key 문서에서 확인
`addr:city=경기도`	도	실제 주소의 광역 행정단위가 ‘경기도’일 때 이 Key에 적습니다. KOSM에서는 이 Key가 시·도 단위를 뜻하므로, 도시 이름을 담는 OSM의 일반 관행과 범위가 다릅니다. 전체 주소를 한 문장으로 합치지 않고 인접 건물의 값을 추정해 복사하지 않습니다.	OSM 태그	Key 문서에서 확인

함께 사용하는 Key

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

관련 Key	역할	공식 문서
`addr:district`	OSM의 addr:district를 KOSM 주소 체계에서는 시·군·구 단위로 의미를 변형하여 적용합니다.	OSM Wiki
`addr:subdistrict`	OSM의 addr:subdistrict를 KOSM 주소 체계에서는 읍·면·동 단위로 의미를 변형하여 적용합니다.	OSM Wiki
`addr:street`	주소가 속한 도로의 이름을 기록합니다.	OSM Wiki
`addr:housenumber`	도로명주소의 건물번호를 기록합니다.	OSM Wiki
`addr:postcode`	해당 주소의 우편번호를 기록합니다. 대한민국은 2015년부터 5자리 국가기초구역번호를 사용합니다.	OSM Wiki
`addr:unit`	동·호처럼 하나의 주소 안에서 개별 점유 공간을 구분하는 단위를 기록합니다. 층은 level=* 또는 addr:floor=*로 따로 기록합니다.	OSM Wiki

참고 문서

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