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