Key: building

KOSM Feature Key Reference로 돌아가기

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
building	건물 — 지붕이 있고 한 위치에 지속적으로 존재하는 구조물의 외곽과 물리적 유형을 나타냅니다.	OOSM 태그	주로 면	text	OSM Wiki

어떻게 사용하나요?

building=*은 지붕이 있고 한자리에 고정된 구조물이 건축적으로 어떤 유형인지를 정하는 지물 핵심 Key입니다. 건물의 외곽을 그리고 그것이 주택인지, 창고인지, 학교 건물인지를 나타냅니다.

건물의 생김새와 그 안에서 지금 벌어지는 일은 서로 다른 정보입니다. 현재 운영 중인 시설은 amenity=*, shop=*, office=*로, 건물 전체의 현재 이용 방식은 building:use=*로 각각 나누어 기록합니다.

적용 대상

building=*는 일반적으로 주로 면에 적용합니다.

건물은 실제 외벽이나 지붕 외곽을 따라 닫힌 길 또는 multipolygon 관계의 면으로 그립니다.

Value 선택

Value는 건물의 건축적·물리적 유형을 나타냅니다. 유형을 모르면 building=yes, 확인할 수 있다면 building=house, building=warehouse, building=school처럼 더 구체적인 값을 사용합니다.

건물의 유형은 현재 그 안에서 이루어지는 활동과 다를 수 있습니다. 병원으로 지어진 건물이 현재 다른 용도로 쓰이더라도 건축적 유형은 building=hospital로 남을 수 있으며, 현재 운영되는 시설은 amenity=*, shop=*, office=* 등으로 별도 기록합니다.

확인되지 않은 값은 임의로 추정하지 않습니다. 비슷한 Value가 있으면 실제 지물의 기능과 OSM Wiki의 구분 기준을 함께 확인합니다.

비슷한 Key와 구분하기

비슷해 보이는 Key도 서로 다른 질문에 답합니다. 한 Key에 모든 의미를 넣지 말고 아래 기준에 따라 나누어 기록합니다.

Key	무엇을 기록하나요?	예시·구분 기준
building:use=*	건물의 현재 전반적인 이용 방식	building:use=residential — 현재 주거용으로 이용
building:main_use=*	건물에 부여된 법적·행정적 대표 주용도 분류	KOSM 값 체계에서 해당 주용도에 대응하는 Value
amenity=* · shop=* · leisure=* · tourism=* · office=*	현재 실제로 운영되는 시설·사업체·활동	amenity=library — 실제 도서관 시설

주요 Value

아래 표에는 KOSM에서 중요하게 다루거나 자주 사용하는 주요 Value를 중심으로 정리했습니다. 각 행에서 Value의 의미, 적용 대상, 함께 사용하는 Key, 방향·형태 기준, 오용하기 쉬운 조건을 확인할 수 있습니다. 여기에 정리되지 않은 나머지 Value와 세부 사용 조건은 OSM Wiki — Key:building에서 확인합니다.

Value	의미	언제·어떻게 사용하나요?	태그 구분	OSM Wiki
building=house	단독주택	한 가구가 주로 사용하는 독립 주택 건물에 적용합니다. 여러 세대가 각각 독립된 주거 단위를 이루면 apartments, 주거용이라는 사실만 확인되고 형태를 특정하기 어렵다면 residential을 검토합니다. 현재 입점 시설은 amenity=*나 shop=*로 따로 기록합니다.	OOSM 태그	Tag 문서에서 확인
building=apartments	공동주택	여러 세대의 독립된 주거 단위가 한 건물에 있는 공동주택에 사용합니다. 단독주택은 house, 주거용임만 확인되고 세부 형식을 모르면 residential을 검토하며 층수는 building:levels=*로 추가합니다.	OOSM 태그	Tag 문서에서 확인
building=residential	주거용 건물	주거용 건물임은 확인되지만 단독주택·공동주택 등 더 구체적인 건축 유형을 결정하기 어려울 때 사용합니다. 구체적인 형태가 확인되면 house, apartments 같은 값을 우선합니다.	OOSM 태그	Tag 문서에서 확인
building=commercial	상업용 건물	사무·서비스 등 상업 활동을 위해 설계된 비주거 건물에 사용합니다. 상품 판매 공간이 중심인 건물은 retail, 생산·제조 시설은 industrial이 더 구체적이며 실제 사업체는 office=*, shop=* 등으로 별도 표현합니다.	OOSM 태그	Tag 문서에서 확인
building=retail	소매점 중심 건물	고객이 방문해 상품을 구매하는 소매 공간을 중심으로 설계된 건물에 사용합니다. 개별 매장의 업종은 shop=*로 따로 기록하고, 건물 일부만 매장이라면 전체 건물을 retail로 단정하지 않습니다.	OOSM 태그	Tag 문서에서 확인
building=office	사무용 건물	사무실 사용을 주목적으로 설계된 건물에 사용합니다. 다양한 상업 활동을 포괄하는 commercial보다 사무 공간이라는 건축적 성격이 분명할 때 선택하고 실제 입주 기관은 office=*로 별도 기록합니다.	OOSM 태그	Tag 문서에서 확인
building=industrial	산업용 건물	제조·가공·산업 생산을 위해 설계된 건물에 사용합니다. 단순 보관 창고는 warehouse와 구분하고, 현재 입주한 업체의 업종은 건물 유형이 아니라 별도 시설 태그로 기록합니다.	OOSM 태그	Tag 문서에서 확인
building=warehouse	창고	물품을 보관·집하하도록 설계된 창고형 건물에 적용합니다. 현재 다른 용도로 전환되었더라도 건축적 유형이 남아 있다면 building=warehouse를 유지하고 현재 쓰임은 building:use=*로 구분합니다.	OOSM 태그	Tag 문서에서 확인
building=school	학교 건물	교실·교육 공간 등 학교 용도로 설계된 건물에 사용합니다. 학교 부지 전체를 나타내는 amenity=school과 구분하며, 폐교 후 다른 시설로 이용 중이면 현재 쓰임을 building:use=*로 추가합니다.	OOSM 태그	Tag 문서에서 확인
building=greenhouse	온실·비닐하우스	유리나 비닐로 덮어 식물을 기르도록 만든 온실·비닐하우스에 사용하는 OSM 값입니다. 시설물 하나하나의 외곽을 그리며, 온실이 모여 있는 농지 전체의 토지 이용은 landuse=*로 별도 표현합니다.	OOSM 태그	Tag 문서에서 확인
building=roof	벽 없이 지붕만 있는 구조물	주유소 캐노피나 버스 승강장 지붕처럼 기둥과 지붕만 있고 벽으로 둘러싸이지 않은 구조물에 사용하는 OSM 값입니다. 지붕 아래에서 운영되는 시설은 amenity=* 등으로 따로 기록하며, 벽이 있는 건물에는 사용하지 않습니다.	OOSM 태그	Tag 문서에서 확인
building=construction	공사 중인 건물	공사가 실제로 진행 중인 건물에 사용하는 OSM 값입니다. 완공 후의 유형이 확인되면 construction=*로 함께 기록할 수 있고, 아직 착공하지 않은 계획 단계에는 사용하지 않습니다. 완공되면 실제 건축 유형 값으로 바꿉니다.	OOSM 태그	Tag 문서에서 확인
building=yes	세부 유형을 알 수 없는 건물	건물임은 확실하지만 건축적 유형을 구분할 수 없을 때만 사용합니다. 현재 입점 업종을 건물 유형으로 추정하지 말고, 형태가 확인되면 house, apartments, warehouse 같은 구체적인 값으로 바꿉니다.	OOSM 태그	Tag 문서에서 확인

함께 사용하는 Key

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

관련 Key	역할	공식 문서
building:use	건물의 건축적 유형과 구분하여 현재의 전반적인 이용 방식을 기록합니다.	OSM Wiki
building:main_use	KOSM 분류 기준에서 건축물의 대표 주용도를 기록합니다.	-
building:levels	건물의 지상층 수를 기록합니다.	OSM Wiki
building:levels:underground	지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다.	OSM Wiki
height	건물이나 구조물의 실제 높이를 미터 단위로 기록합니다.	OSM Wiki
building:structure	건물의 시공 구조를 나타내는 사용 중인 OSM Key입니다. 사용 지역이 제한적이고 구조가 겉으로 확인되지 않는 경우가 많아 KOSM 원자료 대응표가 필요합니다.	OSM Wiki
name	출입구·시설·지물에 실제로 구분되는 이름이 있을 때 기록합니다.	OSM Wiki
amenity	방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다.	OSM Wiki
shop	상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다.	OSM Wiki
addr:housenumber	도로명주소의 건물번호를 기록합니다.	OSM Wiki
addr:plotnumber	한국 지번 주소의 본번과 부번을 기록하는 KOSM 자체 Key입니다.	-

건물 유형과 현재 이용 방식, KOSM 대표 주용도가 같을 수도 있지만 확인 없이 세 Key에 같은 값을 기계적으로 반복하지 않습니다.

대표 태그 조합

OSM Wiki에서 설명하는 사용 방식과 널리 정착된 조합만 선별했습니다. 실제로 확인되지 않은 속성은 예시를 그대로 복사하지 말고 생략합니다.

사용 장면	태그 조합	조합하는 이유
15층 공동주택	building=apartments, building:levels=15, name=한마음아파트	building=*은 건물의 물리적 유형을, building:levels=*는 지상층 수를, name=*은 건물 이름을 기록합니다.
창고를 주거 공간으로 전환한 건물	building=warehouse, building:use=residential	건축적 유형은 창고로 남기고 현재 이용 방식은 주거로 구분합니다. building:use=*는 건물 유형과 현재 쓰임이 다를 때 특히 유용합니다.
학교 건물을 도서관으로 전환한 경우	building=school, building:use=civic, building:main_use=library, amenity=library	building=*은 학교형 건물, building:use=*는 현재의 전반적인 이용 방식, KOSM building:main_use=*는 대표 주용도, amenity=*는 실제 운영 시설을 각각 기록합니다.
건물 전체를 사용하는 슈퍼마켓	building=retail, shop=supermarket, name=우리마트	건물 자체의 유형과 그 안에서 운영되는 상점 기능을 서로 다른 Key로 표현합니다. 상점이 건물 일부만 사용한다면 상점은 별도 노드나 면으로 나누어 기록합니다.

참고 문서

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