Key: amenity 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설">amenity</code> || '''공공·생활 편의시설''' — 방문자와 거주자가 이용하는 음식·교육·공공·교통·편의 시설을 분류합니다. || '''OSM 태그''' || 주로 노드·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:amenity OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="공공·생활 편의시설">amenity=*</code>는 '''생활·공공·편의 서비스를 제공하는 시설의 주된 기능'''을 정하는 지물 핵심 Key입니다. 건물이라는 물리적 대상이 아니라 그 안에서 이루어지는 기능을 가리킵니다.

값의 범위가 넓어 다른 지물 핵심 Key와 경계가 겹칠 때가 있습니다. 상품을 파는 곳은 <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: leisure|leisure=*]]</code>가 더 정확한 경우가 많습니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="공공·생활 편의시설">amenity=*</code>는 일반적으로 '''주로 노드·면'''에 적용합니다.

어떤 형태로 그리는지는 Value마다 다릅니다. OSM Wiki는 세 가지 방식을 예로 듭니다 — 그 자체로 하나의 노드인 <code class="kosm-tag-reference" title="공공·생활 편의시설=제설재 보관함">amenity=grit_bin</code>, 길 위에 놓이는 노드인 <code class="kosm-tag-reference" title="공공·생활 편의시설=주차장 출입구">amenity=parking_entrance</code>, 면으로 그리는 <code class="kosm-tag-reference" title="공공·생활 편의시설=펍">amenity=pub</code>입니다. 그래서 형태는 각 Value 문서에서 확인하는 것이 원칙입니다.

예를 들어 <code class="kosm-tag-reference" title="공공·생활 편의시설=주차장">amenity=parking</code>은 주차 구역을 면으로 그리는 것이 가장 흔한 방식이고, 실제 범위를 모르거나 그릴 수 없을 때 노드를 씁니다. 다만 '''같은 주차장을 노드와 면으로 동시에 표현하지는 않습니다.'''

여러 독립 시설이 입주한 건물 전체에는 하나의 <code class="kosm-tag-reference" title="공공·생활 편의시설">amenity=*</code>를 대표값처럼 붙이지 않습니다.

==== Value 선택 ====
생활·공공·편의 서비스를 제공하는 시설의 주기능을 분류합니다. 한 건물 안에 학교·카페·병원처럼 독립 시설이 여럿이면 건물 전체에 값을 쌓지 말고 각 시설을 별도 객체로 표현하며, 상점 업종은 가능한 경우 <code class="kosm-tag-reference kosm-tag-reference--link" title="상점 유형">[[Key: shop|shop=*]]</code>을 우선합니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="건물">[[Key: building|building=*]]</code> || 건물의 건축적·물리적 유형 || <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=창고">[[Key: building|building=warehouse]]</code> — 창고형 건물
|-
| <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
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=음식점">amenity=restaurant</code> || 음식점 || 주문한 식사를 좌석에서 먹는 것이 중심인 음식점에 사용합니다. 빠른 조리·포장 중심이면 <code>fast_food</code>, 음료와 가벼운 식사가 중심이면 <code>cafe</code>를 검토하고 음식 종류는 <code class="kosm-tag-reference kosm-tag-reference--link" title="음식 종류">[[Key: cuisine|cuisine=*]]</code>로 별도 기록합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Drestaurant Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=학교">amenity=school</code> || 학교 || 초·중등 교육기관의 학교 부지 전체에 주로 사용합니다. 개별 학교 건물은 <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=학교 건물">[[Key: building|building=school]]</code>로 별도 표현할 수 있으며, 이름·운영 주체·출입 조건은 학교 시설 객체에 적습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dschool Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=패스트푸드점">amenity=fast_food</code> || 패스트푸드점 || 빠른 주문·조리와 포장 또는 간단한 좌석 이용이 중심인 음식점에 사용합니다. 일반 좌석 서비스 음식점인 <code>restaurant</code>와 실제 운영 형태를 비교하고 <code class="kosm-tag-reference kosm-tag-reference--link" title="포장">[[Key: takeaway|takeaway=*]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="드라이브스루">[[Key: drive_through|drive_through=*]]</code>를 필요에 따라 추가합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dfast_food Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=종교 시설">amenity=place_of_worship</code> || 종교 시설 || 예배·의례가 실제로 이루어지는 종교 시설에 사용합니다. 건축적 형태는 <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=교회 건물">[[Key: building|building=church]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="건물=사찰 건물">[[Key: building|building=temple]]</code> 등으로 별도 기록하고 종교·종파는 관련 세부 Key를 사용합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=카페">amenity=cafe</code> || 카페 || 커피·차 등 음료가 중심이고 가벼운 식사를 함께 제공하는 카페에 사용합니다. 주된 기능이 정식 식사 제공이면 <code>restaurant</code>, 주류와 유흥 분위기가 중심이면 <code>bar</code>를 검토합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dcafe Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=바">amenity=bar</code> || 주류를 중심으로 제공하는 바 || 주류 판매와 현장 음용이 중심인 상업 시설에 사용합니다. 음식점이 술도 판매한다는 이유만으로 적용하지 않고 영업의 주된 성격을 기준으로 합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dbar Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=주민·공동체 시설">amenity=community_centre</code> || 주민·공동체 시설 || 지역 주민이나 특정 공동체가 회의·교육·행사를 위해 이용하는 시설에 사용합니다. 행정기관 사무소나 단순 대관 공간과 실제 주된 운영 목적을 비교합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dcommunity_centre Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=주유소">amenity=fuel</code> || 주유소 || 일반 이용자에게 차량 연료를 판매하는 주유·충전 시설에 사용합니다. 판매 연료 종류, 운영시간, 브랜드와 대형차 이용 가능 여부는 각각의 보조 Key로 기록합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dfuel Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=의원">amenity=doctors</code> || 의원 || 여러 과를 갖춘 병원보다 소규모 의사 진료 시설에 사용하는 전통적인 <code class="kosm-tag-reference" title="공공·생활 편의시설">amenity</code> 태그입니다. <code class="kosm-tag-reference kosm-tag-reference--link" title="의료·보건=의사 진료소">[[Key: healthcare|healthcare=doctor]]</code>와의 지역별 사용 관행을 확인하고 같은 시설을 중복 객체로 만들지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Ddoctors Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=약국">amenity=pharmacy</code> || 약국 || 의약품을 조제·판매하는 약국에 사용합니다. 일반 건강용품점과 구분하고 처방전 조제 여부 등 확인 가능한 속성은 별도 Key로 추가합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dpharmacy Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=주차장">amenity=parking</code> || 주차장 || 차량을 주차하도록 마련된 공간 전체에 사용합니다. 주차장 진입 지점은 <code class="kosm-tag-reference" title="공공·생활 편의시설=주차장 출입구">amenity=parking_entrance</code>, 내부 통로는 <code class="kosm-tag-reference kosm-tag-reference--link" title="도로·보행로=서비스 도로">[[Key: highway|highway=service]]</code>와 <code class="kosm-tag-reference kosm-tag-reference--link" title="서비스 도로·철도 세부 유형=주차 구획 사이 통로">[[Key: service|service=parking_aisle]]</code>로 별도 표현합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dparking Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=벤치">amenity=bench</code> || 벤치 || 여러 사람이 앉을 수 있도록 고정 설치된 벤치의 실제 위치에 노드로 사용합니다. 정류장에 좌석이 있다는 속성만 기록할 때는 정류장 객체의 <code class="kosm-tag-reference" title="벤치 제공 여부=있음">bench=yes</code>와 구분합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dbench Tag 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="공공·생활 편의시설=공중화장실">amenity=toilets</code> || 공중화장실 || 독립적으로 이용할 수 있는 공중화장실의 위치나 범위에 사용합니다. 음식점·시설 내부에서 이용객에게 제공되는 화장실 여부는 그 시설의 <code class="kosm-tag-reference kosm-tag-reference--link" title="화장실 제공 여부">[[Key: toilets|toilets=yes/no]]</code> 속성으로 기록합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:amenity%3Dtoilets Tag 문서에서 확인]
|}

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

{| class="wikitable"
! 관련 Key !! 역할 !! 공식 문서
|-
| <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: brand|brand]]</code> || 시설이 사용하는 브랜드를 운영 주체와 구분하여 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:brand OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="운영 주체">[[Key: operator|operator]]</code> || 시설이나 서비스를 실제로 운영하는 기관 또는 사업자를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:operator OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="운영시간">[[Key: opening_hours|opening_hours]]</code> || 시설이 실제로 운영되거나 개방되는 요일과 시간을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:opening_hours OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="전화번호">[[Key: phone|phone]]</code> || 시설의 대표 연락처를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:phone OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="웹사이트">[[Key: website|website]]</code> || 시설 또는 운영 주체의 공식 웹페이지를 연결합니다. || [https://wiki.openstreetmap.org/wiki/Key:website 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]
|}

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

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 일반 음식점 || <code class="kosm-tag-reference" title="공공·생활 편의시설=음식점">amenity=restaurant</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=예시식당]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="음식 종류=한국 음식">[[Key: cuisine|cuisine=korean]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="운영시간">[[Key: opening_hours|opening_hours=Mo-Su 11:00-21:00]]</code> || 시설의 종류를 <code class="kosm-tag-reference" title="공공·생활 편의시설">amenity=*</code>로 정하고 이름·음식 종류·영업시간을 각각 별도 속성으로 추가합니다.
|-
| 공중화장실 || <code class="kosm-tag-reference" title="공공·생활 편의시설=공중화장실">amenity=toilets</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="일반 접근 조건=통행 가능">[[Key: access|access=yes]]</code> || 시설 유형과 휠체어 접근성, 일반 이용 가능 여부를 구분해 기록합니다.
|}

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

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