Key: entrance

K-OSM Feature Key Reference로 돌아가기

Key 개요

Key	의미	태그 구분	적용 형태	값 형식	공식 문서
entrance	건물 출입구 — 건물이나 시설에 들어가는 실제 위치와 출입구 종류를 뜻합니다.	OOSM 태그	건물 외곽의 노드	text	OSM Wiki

어떻게 사용하나요?

entrance=*는 건물이나 구역의 경계를 실제로 통과하는 지점과 그 지점의 역할을 뜻합니다. 문이라는 물건이 아니라 ‘드나드는 곳’이라는 위치 정보입니다.

주 출입구·부출입구·업무용·출구 전용처럼 역할을 나눌 뿐, 누가 통과할 수 있는지는 말하지 않습니다. 통행 권한은 access=*, 휠체어 이용 가능성은 wheelchair=*가 담습니다.

적용 대상

entrance=*는 일반적으로 건물 외곽의 노드에 적용합니다.

건물·시설 경계를 실제로 통과하는 지점의 노드에 적용하고 가능하면 외곽선과 노드를 공유합니다. 건물 내부의 일반 문은 실내 매핑의 door=*와 구분합니다.

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

Value 선택

entrance=*는 건물이나 둘러싸인 영역에 실제로 들어가거나 나오는 위치와 출입구의 종류를 뜻합니다. 일반적으로 출입구가 있는 지점에 노드를 만들고 건물·영역의 외곽선에 연결합니다.

이 Key는 출입구의 역할을 설명할 뿐, 누가 통과할 수 있는지는 결정하지 않습니다. 공개·사유·배송 전용 같은 접근 조건은 access=*, 휠체어 접근성은 wheelchair=*처럼 별도의 속성으로 기록합니다.

건물 내부의 일반 문을 모두 entrance=*로 표시하지는 않습니다. 내부 문과 실내 이동 구조를 세밀하게 표현할 때는 실내 지도 문법과 door=*를 함께 검토합니다.

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

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

비슷한 Key와 구분하기

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

Key	무엇을 기록하나요?	예시·구분 기준
door=*	그 위치에 설치된 문의 물리적 형식	door=sliding — 미닫이문
access=*	누가 공식적으로 통과할 수 있는지	access=private — 사적 이용자만 허용
barrier=*	울타리·담장·볼라드 같은 물리적 통행 장벽	barrier=gate — 장벽을 통과하는 문
railway=subway_entrance	지상에서 지하철역으로 연결되는 역 출입구	일반 건물 출입구와 구분

주요 Value

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

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

함께 사용하는 Key

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

관련 Key	역할	공식 문서
building	출입구가 연결되는 건물의 물리적 유형과 외곽을 표현합니다.	OSM Wiki
building:use	건물의 건축적 유형과 구분하여 현재의 전반적인 이용 방식을 기록합니다.	OSM Wiki
building:main_use	K-OSM 분류 기준에서 건축물의 대표 주용도를 기록합니다.	-
building:levels	건물의 지상층 수를 기록합니다.	OSM Wiki
height	건물이나 구조물의 실제 높이를 미터 단위로 기록합니다.	OSM Wiki
amenity	방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다.	OSM Wiki
shop	상품을 판매하거나 소비자 대상 서비스를 제공하는 상점의 업종을 분류합니다.	OSM Wiki
door	출입구에 설치된 미닫이문·회전문·여닫이문 등의 문 형식을 나타냅니다.	OSM Wiki
automatic_door	자동문의 작동 방식이나 감지 방식을 나타냅니다.	OSM Wiki
width	통행 가능한 문·길·시설의 폭을 나타냅니다.	OSM Wiki
level	출입구나 시설이 연결되는 층을 기록합니다.	OSM Wiki
wheelchair	휠체어 사용자가 이용할 수 있는 정도를 기록합니다.	OSM Wiki
access	법적·공식적으로 허용되는 출입 또는 통행 대상을 기록합니다.	OSM Wiki

entrance=*는 출입구의 종류이고 access=*는 통과할 수 있는 사람의 범위입니다. entrance=service와 access=private처럼 서로 다른 정보를 조합할 수 있습니다.

울타리나 담장의 통과 지점은 상황에 따라 barrier=gate 또는 barrier=entrance를 사용합니다. 건물 출입구를 barrier=entrance로 대신하지 않습니다.

휠체어 접근 가능 여부는 문턱·폭·경사·연결 경로를 확인하고 wheelchair=yes, limited, no, designated 등으로 기록합니다.

대표 태그 조합

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

사용 장면	태그 조합	조합하는 이유
건물의 주 출입구	entrance=main, wheelchair=yes, level=0	출입구의 역할, 휠체어 접근성, 연결 층을 서로 다른 Key로 기록합니다. 노드는 실제 문의 위치에서 건물 외곽선에 연결합니다.
직원 전용 후문	entrance=service, access=private	entrance=service는 출입구의 업무상 역할이고 access=private은 이용 가능한 사람의 범위를 뜻합니다.
물류 배송 출입구	entrance=service, access=delivery, width=2.4	배송 목적의 접근 조건과 통과 가능한 폭을 출입구 종류와 나누어 기록합니다.

참고 문서

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