Key: opening hours 문서 원본 보기

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

=== Key 개요 ===
{| class="wikitable"
! Key !! 의미 !! 태그 구분 !! 적용 형태 !! 값 형식 !! 공식 문서
|-
| <code class="kosm-tag-reference" title="운영시간">opening_hours</code> || '''운영시간''' — 시설이나 장소가 문을 여는 요일과 시간을 OSM 운영시간 문법으로 기록합니다. || '''OSM 태그''' || 주로 노드·면 || <code>text</code> || [https://wiki.openstreetmap.org/wiki/Key:opening_hours OSM Wiki]
|}

=== 어떻게 사용하나요? ===
<code class="kosm-tag-reference" title="운영시간">opening_hours=*</code>는 '''시설이 실제로 문을 여는 시간'''을 OSM의 표준 시간 문법으로 담습니다. 자유롭게 쓰는 설명문이 아니라 기계가 읽는 형식이라는 점이 핵심입니다.

요일·공휴일·휴무·자정 넘김 규칙이 정해져 있어 문법을 지키지 않으면 값이 무시됩니다. 복잡한 값은 평가 도구로 검증하는 것이 안전합니다.

==== 적용 대상 ====
<code class="kosm-tag-reference" title="운영시간">opening_hours=*</code>는 일반적으로 '''주로 노드·면'''에 적용합니다.

영업·개방 시간이 적용되는 시설·출입구·서비스 객체에 붙입니다. 같은 건물 안 시설마다 시간이 다르면 각 POI에 따로 기록합니다.

==== Value 선택 ====
OSM 표준 시간 문법으로 실제 개방 시간을 기록합니다. 요일·공휴일·휴무·자정 넘김 규칙이 복잡하므로 평가 도구로 값을 검증하고, 예약제나 계절 영업을 단순한 평일 시간으로 축약하지 않습니다.

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

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

{| class="wikitable"
! Key !! 무엇을 기록하나요? !! 예시·구분 기준
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="주방 운영시간">[[Key: opening_hours:kitchen|opening_hours:kitchen=*]]</code> || 시설 전체 영업시간과 다른 주방·주문 가능 시간 || 음식점에서 선택적으로 사용
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="존재·사용 시작 시점">[[Key: start_date|start_date=*]]</code> || 지물이 현재 형태로 존재하거나 사용되기 시작한 시점 || 착공일·확인일과 구분
|-
| <code class="kosm-tag-reference kosm-tag-reference--link" title="최근 확인일">[[Key: check_date|check_date=*]]</code> || 정보를 마지막으로 확인한 날짜 || 시설의 시작일이 아님
|}

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

{| class="wikitable"
! Value !! 의미 !! 언제·어떻게 사용하나요? !! 태그 구분 !! OSM Wiki
|-
| <code class="kosm-tag-reference" title="운영시간">opening_hours=Mo-Su 10:00-22:00</code> || 매일 10시부터 22시까지 || 월요일부터 일요일까지 매일 10:00~22:00로 같은 영업시간이 확인될 때 사용합니다. 공휴일 운영이 다르면 <code>PH</code> 규칙을 추가하고 자정 이후까지 영업하면 날짜가 넘어가는 시간 범위를 정확히 적습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:opening_hours Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="운영시간">opening_hours=Mo-Sa 11:00-21:00; Su off</code> || 월~토 11시부터 21시, 일요일 휴무 || 월요일부터 토요일까지 11:00~21:00에 운영하고 일요일은 휴무일 때 사용합니다. 서로 다른 요일 규칙은 세미콜론으로 나누며 실제 공휴일 운영은 별도로 확인합니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Key:opening_hours Key 문서에서 확인]
|-
| <code class="kosm-tag-reference" title="운영시간">opening_hours=24/7</code> || 항상 운영 || 요일과 공휴일을 포함해 연중무휴 24시간 이용할 수 있을 때만 사용합니다. 단순히 영업시간을 알 수 없거나 무인 출입이 일부 시간에만 가능할 때는 적용하지 않습니다. || '''OSM 태그''' || [https://wiki.openstreetmap.org/wiki/Tag:opening_hours%3D24%2F7 Tag 문서에서 확인]
|}

=== 값 입력 방법 ===
요일과 시간을 OSM의 운영시간 문법으로 입력합니다.

* <code>Mo-Fr 09:00-18:00</code> — 월요일부터 금요일까지 09:00~18:00
* <code>Mo-Fr 09:00-18:00; Sa 09:00-13:00</code> — 서로 다른 규칙은 세미콜론으로 구분
* <code>Mo-Fr 09:00-12:00,13:00-18:00</code> — 같은 날의 여러 시간대는 쉼표로 구분
* <code>24/7</code> — 항상 운영
* <code>PH off</code> — 공휴일 휴무

=== 함께 사용하는 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: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]
|}

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

{| class="wikitable"
! 사용 장면 !! 태그 조합 !! 조합하는 이유
|-
| 평일과 토요일 시간이 다른 카페 || <code class="kosm-tag-reference kosm-tag-reference--link" title="공공·생활 편의시설=카페">[[Key: amenity|amenity=cafe]]</code>, <code class="kosm-tag-reference kosm-tag-reference--link" title="이름">[[Key: name|name=예시카페]]</code>, <code class="kosm-tag-reference" title="운영시간">opening_hours=Mo-Fr 09:00-18:00; Sa 10:00-15:00; Su off</code> || 운영시간은 시설의 지물 핵심 태그에 추가합니다. 서로 다른 요일 규칙은 세미콜론으로 나눕니다.
|}

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

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