Key: entrance 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="건물 출입구">entrance</code> || '''건물 출입구''' — 건물이나 시설에 들어가는 실제 위치와 출입구 종류를 뜻합니다. || '''OSM 태그''' || 건물 외곽의 노드 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:entrance OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="건물 출입구">entrance=*</code>는 '''건물이나 구역의 경계를 실제로 통과하는 지점'''과 그 지점의 역할을 뜻합니다. 문이라는 물건이 아니라 ‘드나드는 곳’이라는 위치 정보입니다.

주 출입구·부출입구·업무용·출구 전용처럼 역할을 나눌 뿐, 누가 통과할 수 있는지는 말하지 않습니다. 통행 권한은 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code>, 휠체어 이용 가능성은 <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair=*]]</code>가 담습니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="건물 출입구">entrance=*</code>는 일반적으로 '''건물 외곽의 노드'''에 적용합니다.

건물·시설 경계를 실제로 통과하는 지점의 노드에 적용하고 가능하면 외곽선과 노드를 공유합니다. 건물 내부의 일반 문은 실내 매핑의 <code class="kosm-tag-reference" title="출입문의 형식">door=*</code>와 구분합니다.

출입구 노드는 가능하면 '''실제 출입 위치의 건물·영역 외곽선'''에 연결합니다. 건물 중심이나 출입구와 무관한 내부 위치에 놓지 않습니다.

==== Value 선택 ====
<code class="kosm-tag-reference" title="건물 출입구">entrance=*</code>는 건물이나 둘러싸인 영역에 실제로 들어가거나 나오는 '''위치'''와 출입구의 '''종류'''를 뜻합니다. 일반적으로 출입구가 있는 지점에 노드를 만들고 건물·영역의 외곽선에 연결합니다.

이 Key는 출입구의 역할을 설명할 뿐, 누가 통과할 수 있는지는 결정하지 않습니다. 공개·사유·배송 전용 같은 접근 조건은 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code>, 휠체어 접근성은 <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair=*]]</code>처럼 별도의 속성으로 기록합니다.

건물 내부의 일반 문을 모두 <code class="kosm-tag-reference" title="건물 출입구">entrance=*</code>로 표시하지는 않습니다. 내부 문과 실내 이동 구조를 세밀하게 표현할 때는 실내 지도 문법과 <code class="kosm-tag-reference" title="출입문의 형식">door=*</code>를 함께 검토합니다.

여러 출입구가 있을 때 모든 출입구를 <code>main</code>으로 지정하지 말고 실제 안내·동선에서의 역할을 확인합니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference" title="출입문의 형식">door=*</code> || 그 위치에 설치된 문의 물리적 형식 || <code class="kosm-tag-reference" title="출입문의 형식=미닫이문">door=sliding</code> — 미닫이문
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code> || 누가 공식적으로 통과할 수 있는지 || <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code> — 사적 이용자만 허용
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설">[[Key: barrier|barrier=*]]</code> || 울타리·담장·볼라드 같은 물리적 통행 장벽 || <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=문">[[Key: barrier|barrier=gate]]</code> — 장벽을 통과하는 문
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="철도=지하철역 출입구">[[Key: railway|railway=subway_entrance]]</code> || 지상에서 지하철역으로 연결되는 역 출입구 || 일반 건물 출입구와 구분
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="건물 출입구=주 출입구">entrance=main</code> || 주 출입구 || 방문자 안내와 보행 경로에서 대표적으로 사용하는 주 출입구에 붙입니다. 주 출입구가 여러 개일 수 있으며 <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=*]]</code>, <code class="kosm-tag-reference" title="출입문의 형식">door=*</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="운영시간">[[Key: opening_hours|opening_hours=*]]</code>로 이용 조건을 보완합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dmain Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=종류를 구분하지 않은 출입구">entrance=yes</code> || 종류를 구분하지 않은 출입구 || 출입구임은 확인했지만 중요도나 용도를 더 구체적으로 구분할 수 없을 때 사용합니다. 종류를 확인할 수 있다면 <code>main</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="서비스 도로·철도 세부 유형">[[Key: service|service]]</code>, <code>home</code> 등 더 구체적인 값을 우선합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dyes Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=보조 출입구">entrance=secondary</code> || 보조 출입구 || 주 출입구는 아니며 행사·특정 시간 등에 보조적으로 사용하는 출입구에 붙입니다. 이용 시간이 제한되면 <code class="kosm-tag-reference kosm-tag-reference--link" title="운영시간">[[Key: opening_hours|opening_hours=*]]</code>, 이용자가 제한되면 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code>로 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dsecondary Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=직원·물류용 출입구">entrance=service</code> || 직원·물류용 출입구 || 직원 출입, 물품 배송, 후문 등 일반 방문객보다 업무 목적으로 사용하는 출입구에 붙입니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code> 또는 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=배달 차량만">[[Key: access|access=delivery]]</code>는 출입구 역할과 별개의 접근 조건입니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dservice Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=출구 전용">entrance=exit</code> || 출구 전용 || 들어갈 수 없고 밖으로 나오는 용도로만 사용하는 출구에 붙입니다. 통행 방향과 실제 운영 방식이 확인된 경우에만 사용합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dexit Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=비상 출입구">entrance=emergency</code> || 비상 출입구 || 화재 등 비상 상황에서 탈출하기 위한 비상구에 붙입니다. 일반 출입구로 사용되는지와 잠금·접근 조건은 별도로 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Demergency Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=계단실 출입구">entrance=staircase</code> || 계단실 출입구 || 건물의 계단실로 직접 연결되는 출입구를 구분할 때 사용합니다. 연결 층은 <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=*]]</code>, 문 형식은 <code class="kosm-tag-reference" title="출입문의 형식">door=*</code>, 휠체어 접근성은 <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair=*]]</code>로 기록합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dstaircase Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=주택·가정 출입구">entrance=home</code> || 주택·가정으로 들어가는 출입구 || 개별 주택·정원·세대 등 사적인 거주 공간으로 들어가는 출입구에 사용합니다. 공동주택의 공용 주 출입구와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dhome Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=차고 출입구">entrance=garage</code> || 차고 출입구 || 보행자용 일반 출입구가 아니라 차고로 연결되는 차량 출입구에 사용합니다. 차량 접근 조건과 폭은 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="폭">[[Key: width|width=*]]</code>로 추가합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dgarage Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=상점으로 연결되는 출입구">entrance=shop</code> || 상점으로 바로 연결되는 출입구 || 건물의 대표 출입구가 아니라 개별 상점으로 바로 연결되는 출입구에 사용합니다. 상점 자체는 별도 객체의 <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop=*]]</code> 또는 적절한 지물 핵심 Key로 표현합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dshop Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="건물 출입구=출입할 수 없는 위치">entrance=no</code> || 문처럼 보이지만 실제로 출입할 수 없는 위치 || 문이나 출입구처럼 보이지만 봉쇄되어 실제 통행이 불가능한 위치를 명확히 표시할 때만 사용합니다. 출입구 존재 여부를 모르는 경우에는 사용하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:entrance%3Dno Tag 문서에서 확인]
|}

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building]]</code> || 출입구가 연결되는 건물의 물리적 유형과 외곽을 표현합니다. || [https://wiki.openstreetmap.org/wiki/Key:building OSM Wiki]
|-
| <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> || K-OSM 분류 기준에서 건축물의 대표 주용도를 기록합니다. || -
|-
| <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: height|height]]</code> || 건물이나 구조물의 실제 높이를 미터 단위로 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:height 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" title="출입문의 형식">door</code> || 출입구에 설치된 미닫이문·회전문·여닫이문 등의 문 형식을 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:door OSM Wiki]
|-
| <code>automatic_door</code> || 자동문의 작동 방식이나 감지 방식을 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:automatic_door OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="폭">[[Key: width|width]]</code> || 통행 가능한 문·길·시설의 폭을 나타냅니다. || [https://wiki.openstreetmap.org/wiki/Key:width OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level]]</code> || 출입구나 시설이 연결되는 층을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:level OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성">[[Key: wheelchair|wheelchair]]</code> || 휠체어 사용자가 이용할 수 있는 정도를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:wheelchair OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access]]</code> || 법적·공식적으로 허용되는 출입 또는 통행 대상을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:access OSM Wiki]
|}

<code class="kosm-tag-reference" title="건물 출입구">entrance=*</code>는 출입구의 종류이고 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건">[[Key: access|access=*]]</code>는 통과할 수 있는 사람의 범위입니다. <code class="kosm-tag-reference" title="건물 출입구=직원·물류용 출입구">entrance=service</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code>처럼 서로 다른 정보를 조합할 수 있습니다.

울타리나 담장의 통과 지점은 상황에 따라 <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=문">[[Key: barrier|barrier=gate]]</code> 또는 <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=장벽이 끊긴 통과 지점">[[Key: barrier|barrier=entrance]]</code>를 사용합니다. 건물 출입구를 <code class="kosm-tag-reference kosm-tag-reference--link" title="장벽·통제 시설=장벽이 끊긴 통과 지점">[[Key: barrier|barrier=entrance]]</code>로 대신하지 않습니다.

휠체어 접근 가능 여부는 문턱·폭·경사·연결 경로를 확인하고 <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성=이용 가능">[[Key: wheelchair|wheelchair=yes]]</code>, <code>limited</code>, <code>no</code>, <code>designated</code> 등으로 기록합니다.

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

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 건물의 주 출입구 || <code class="kosm-tag-reference" title="건물 출입구=주 출입구">entrance=main</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="휠체어 접근성=이용 가능">[[Key: wheelchair|wheelchair=yes]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="OSM 층 레벨">[[Key: level|level=0]]</code> || 출입구의 역할, 휠체어 접근성, 연결 층을 서로 다른 Key로 기록합니다. 노드는 실제 문의 위치에서 건물 외곽선에 연결합니다.
|-
| 직원 전용 후문 || <code class="kosm-tag-reference" title="건물 출입구=직원·물류용 출입구">entrance=service</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code> || <code class="kosm-tag-reference" title="건물 출입구=직원·물류용 출입구">entrance=service</code>는 출입구의 업무상 역할이고 <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=소유자·허가자만">[[Key: access|access=private]]</code>은 이용 가능한 사람의 범위를 뜻합니다.
|-
| 물류 배송 출입구 || <code class="kosm-tag-reference" title="건물 출입구=직원·물류용 출입구">entrance=service</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="일반 접근 조건=배달 차량만">[[Key: access|access=delivery]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="폭">[[Key: width|width=2.4]]</code> || 배송 목적의 접근 조건과 통과 가능한 폭을 출입구 종류와 나누어 기록합니다.
|}

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

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