Key: description 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="보충 설명">description</code> || '''보충 설명''' — 다른 구조화된 태그만으로 설명하기 어려운 유용한 정보를 짧은 문장으로 기록합니다. || '''OSM 태그''' || 모든 형태 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:description OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="보충 설명">description=*</code>은 '''다른 태그로는 표현하기 어려운 객관적 보충 사실'''을 짧게 적는 자리입니다. 무엇을 적어야 한다는 규칙이 없는 만큼, 남용하기 쉬운 Key이기도 합니다.

홍보 문구·주관적 평가·편집 메모는 넣지 않습니다. 이름·주소·운영시간처럼 전용 Key가 있는 정보는 그 Key로 옮깁니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="보충 설명">description=*</code>는 일반적으로 '''모든 형태'''에 적용합니다.

보충 사실이 설명하는 정확한 객체에 붙입니다. 관계 전체의 설명을 개별 구성원마다 복사하지 않습니다.

==== Value 선택 ====
다른 구조화된 태그로 표현하기 어려운 객관적 보충 사실만 짧게 적습니다. 홍보 문구·평가·편집 메모·긴 역사 서술을 넣지 말고, 이름이나 주소처럼 전용 Key가 있는 정보는 그 Key로 옮깁니다.

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

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="보충 설명">description=보행자 전용 출입구</code> || 대상에 대한 보충 설명 || 다른 구조화된 태그로 표현하기 어려운 사실을 ‘보행자 전용 출입구’처럼 짧게 보충합니다. 이름·업종·접근성처럼 전용 Key가 있는 정보는 설명문에 대신 넣지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:description Key 문서에서 확인]
|}

=== 함께 사용하는 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: 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: opening_hours:kitchen|opening_hours:kitchen]]</code> || 음식점 전체 영업시간과 다른 주방·주문 가능 시간을 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:opening_hours%3Akitchen 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: email|email]]</code> || 시설의 공식 전자우편 주소를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:email OSM Wiki]
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="최근 확인일">[[Key: check_date|check_date]]</code> || 해당 정보를 마지막으로 현장·자료에서 확인한 날짜를 기록합니다. || [https://wiki.openstreetmap.org/wiki/Key:check_date OSM Wiki]
|}

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

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