Key: building 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="건물">building</code> || '''건물''' — 지붕이 있고 한 위치에 지속적으로 존재하는 구조물의 외곽과 물리적 유형을 나타냅니다. || '''OSM 태그''' || 주로 면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:building OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="건물">building=*</code>은 '''지붕이 있고 한자리에 고정된 구조물이 건축적으로 어떤 유형인지'''를 정하는 지물 핵심 Key입니다. 건물의 외곽을 그리고 그것이 주택인지, 창고인지, 학교 건물인지를 나타냅니다.

건물의 '''생김새와 그 안에서 지금 벌어지는 일은 서로 다른 정보'''입니다. 현재 운영 중인 시설은 <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="사무 시설">[[Key: office|office=*]]</code>로, 건물 전체의 현재 이용 방식은 <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use=*]]</code>로 각각 나누어 기록합니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="건물">building=*</code>는 일반적으로 '''주로 면'''에 적용합니다.

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

==== Value 선택 ====
Value는 건물의 '''건축적·물리적 유형'''을 나타냅니다. 유형을 모르면 <code class="kosm-tag-reference" title="건물=종류를 구분하지 않은 건물">building=yes</code>, 확인할 수 있다면 <code class="kosm-tag-reference" title="건물=단독주택">building=house</code>, <code class="kosm-tag-reference" title="건물=창고">building=warehouse</code>, <code class="kosm-tag-reference" title="건물=학교 건물">building=school</code>처럼 더 구체적인 값을 사용합니다.

건물의 유형은 현재 그 안에서 이루어지는 활동과 다를 수 있습니다. 병원으로 지어진 건물이 현재 다른 용도로 쓰이더라도 건축적 유형은 <code class="kosm-tag-reference" title="건물=병원 건물">building=hospital</code>로 남을 수 있으며, 현재 운영되는 시설은 <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="사무 시설">[[Key: office|office=*]]</code> 등으로 별도 기록합니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use=*]]</code> || 건물의 현재 전반적인 이용 방식 || <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식=주거용으로 사용">[[Key: building:use|building:use=residential]]</code> — 현재 주거용으로 이용
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use=*]]</code> || 건물에 부여된 법적·행정적 대표 주용도 분류 || KOSM 값 체계에서 해당 주용도에 대응하는 Value
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity=* · shop=* · leisure=* · tourism=* · office=*]]</code> || 현재 실제로 운영되는 시설·사업체·활동 || <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=도서관">[[Key: amenity|amenity=library]]</code> — 실제 도서관 시설
|}

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

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

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use]]</code> || 건물의 건축적 유형과 구분하여 현재의 전반적인 이용 방식을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:building%3Ause OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use]]</code> || KOSM 분류 기준에서 건축물의 대표 주용도를 기록합니다. || -
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지상층수">[[Key: building:levels|building:levels]]</code> || 건물의 지상층 수를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="지하층수">[[Key: building:levels:underground|building:levels:underground]]</code> || 지표면 아래에 있는 건물 층수를 양의 정수로 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:building%3Alevels%3Aunderground OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="높이(미터)">[[Key: height|height]]</code> || 건물이나 구조물의 실제 높이를 미터 단위로 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:height OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건축물 구조 형식">[[Key: building:structure|building:structure]]</code> || 건물의 시공 구조를 나타내는 사용 중인 OSM Key입니다. 사용 지역이 제한적이고 구조가 겉으로 확인되지 않는 경우가 많아 KOSM 원자료 대응표가 필요합니다. || [https://wiki.openstreetmap.org/wiki/Key:building%3Astructure OSM Wiki]
|-
| <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: amenity|amenity]]</code> || 방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:amenity OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop]]</code> || 상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다. || [https://wiki.openstreetmap.org/wiki/Key:shop 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:plotnumber|addr:plotnumber]]</code> || 한국 지번 주소의 본번과 부번을 기록하는 KOSM 자체 Key입니다. || -
|}

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

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

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 15층 공동주택 || <code class="kosm-tag-reference" title="건물=공동주택">building=apartments</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: name|name=한마음아파트]]</code> || <code class="kosm-tag-reference" title="건물">building=*</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: name|name=*]]</code>은 건물 이름을 기록합니다.
|-
| 창고를 주거 공간으로 전환한 건물 || <code class="kosm-tag-reference" title="건물=창고">building=warehouse</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식=주거용으로 사용">[[Key: building:use|building:use=residential]]</code> || 건축적 유형은 창고로 남기고 현재 이용 방식은 주거로 구분합니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use=*]]</code>는 건물 유형과 현재 쓰임이 다를 때 특히 유용합니다.
|-
| 학교 건물을 도서관으로 전환한 경우 || <code class="kosm-tag-reference" title="건물=학교 건물">building=school</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식=공공·시민 용도로 사용">[[Key: building:use|building:use=civic]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도=도서관">[[Key: building:main_use|building:main_use=library]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=도서관">[[Key: amenity|amenity=library]]</code> || <code class="kosm-tag-reference" title="건물">building=*</code>은 학교형 건물, <code class="kosm-tag-reference kosm-tag-reference--link" title="현재 건물 이용 방식">[[Key: building:use|building:use=*]]</code>는 현재의 전반적인 이용 방식, KOSM <code class="kosm-tag-reference kosm-tag-reference--link" title="주용도">[[Key: building:main_use|building:main_use=*]]</code>는 대표 주용도, <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설">[[Key: amenity|amenity=*]]</code>는 실제 운영 시설을 각각 기록합니다.
|-
| 건물 전체를 사용하는 슈퍼마켓 || <code class="kosm-tag-reference" title="건물=소매점 중심 건물">building=retail</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형=슈퍼마켓">[[Key: shop|shop=supermarket]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=우리마트]]</code> || 건물 자체의 유형과 그 안에서 운영되는 상점 기능을 서로 다른 Key로 표현합니다. 상점이 건물 일부만 사용한다면 상점은 별도 노드나 면으로 나누어 기록합니다.
|}

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

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