이번 주말 뭐하지의 출처와 한계
지금 열리는 축제와 공연을 지도에서. 이 자료가 어디서 왔고, 어떻게 받아 왔고, 무엇을 못 하는지를 적었습니다.
알려진 한계
아래는 이번 주말 뭐하지를 쓰기 전에 반드시 알아야 하는 것들입니다. 한 줄로 먼저 적고, 그 아래에서 각각을 풀어 설명합니다.
- 지방자치단체가 등록한 행사만 들어옵니다. 축제가 많은 지역이 아니라 자료를 성실히 올리는 지역이 많아 보일 수 있습니다
- 1년 내내 열리는 상설 프로그램은 뺐습니다. 기간이 60일을 넘으면 싣지 않습니다
- 요금 정보는 공연, 행사 원천에만 있어, 무료 표시가 없다고 해서 유료라는 뜻은 아닙니다
- 좌표가 없는 행사는 지도에 찍을 자리가 없어 싣지 못했습니다
- 기간과 장소는 주최 측이 신고한 값이며 사정에 따라 바뀔 수 있습니다. 가시기 전에 문의처로 확인하십시오
한계를 더 자세히
이 지도는 작고 매주 바뀝니다
2026-09-28 기준 740건입니다. 다른 지도와 비교하면 매우 적습니다. 적은 이유는 둘입니다. 첫째, 지방자치단체가 공공데이터에 등록한 행사만 들어옵니다. 등록하지 않은 행사는 아예 보이지 않습니다. 둘째, 등록된 것 가운데에서도 지금 열리거나 곧 열리는 것만 남깁니다.
원본 11,561건에서 이미 끝난 행사 10,581건, 기간이 60일을 넘는 상설 등록분 112건, 좌표가 없는 행사 52건, 서로 다른 원천에서 같은 행사로 잡힌 중복 76건을 뺀 나머지입니다. 다음 주에 받으면 끝난 것은 빠지고 새로 시작하는 것이 들어와 목록이 달라집니다.
특정 지역이 많아 보이는 것은 자료 편중입니다
마커가 한쪽에 몰려 있다면 그 지역에 축제가 많아서가 아니라 그 지역의 지방자치단체가 자료를 성실히 올리기 때문일 수 있습니다. 세 원천 모두 지방자치단체가 직접 등록하는 구조라, 등록을 안 하면 아무리 큰 축제라도 이 지도에 나오지 않습니다. 이 편중은 저희가 고칠 수 없습니다. 원천이 더 늘거나 등록이 고르게 이루어지기 전까지는, 지도의 밀도가 실제 축제 분포와 다를 수 있다는 점을 알고 보셔야 합니다.
기간이 60일을 넘는 행사는 뺐습니다
“2026년 1월 1일~12월 31일 문화가 있는 날”처럼 1년 내내 열리는 상설 프로그램이 표준데이터에 등록돼 있습니다. 이런 것을 남겨 두면 어느 주말을 찍어도 똑같이 걸려서 화면 대부분이 상설 프로그램으로 채워지고, 이번 주말에 진짜 새로 열리는 행사가 묻힙니다.
잣대를 7일로 잡으면 3주짜리 축제가 전부 빠지고, 잣대 없이 두면 상설이 진짜를 덮습니다. 60일은 통상적인 지역 축제의 최대 기간으로 본 값이며, 이번 수집분에서 이 기준으로 빠진 등록분은 112건입니다.
요금 정보는 한 원천에만 있습니다
세 원천 가운데 요금 필드가 있는 것은 전국공연행사정보표준데이터(15013106)뿐입니다. 한국관광공사 축제 자료와 전국문화축제표준데이터에는 요금을 적는 칸 자체가 없습니다. 그래서 무료 표시가 없는 행사가 유료라는 뜻은 아닙니다. 요금을 모르는 것입니다. 모르는 것을 유료로 적지 않습니다. “무료” 고르개를 켜면 확인된 무료 행사만 보이고, 나머지는 무료인지 아닌지 알 수 없는 상태입니다.
좌표가 없는 행사는 싣지 못했습니다
지도에 찍으려면 좌표가 있어야 합니다. 종료, 상설 필터를 거친 뒤 좌표가 없는 행사가 52건이었고 이 행사는 싣지 못했습니다. 좌표를 지어내면(지오코딩) 실제 장소와 다를 수 있고 그 사실이 화면에 드러나지 않으므로, 지어내지 않고 뺍니다.
좌표 채움률은 원천마다 다릅니다. 한국관광공사 축제 자료는 거의 100%이지만 표준데이터 두 종은 그보다 낮습니다. 이번 수집에서 창 안 레코드의 좌표 채움률은 94%입니다.
기간과 장소는 주최 측 신고값입니다
화면에 적힌 시작일, 종료일, 장소는 주최 측이 원천에 적어 낸 값 그대로입니다. 우천이나 주최 측 사정 등으로 날짜가 바뀌거나 장소가 옮겨져도, 원천이 갱신되기 전까지는 이 지도에 반영되지 않습니다. 가시기 전에 문의처로 확인하십시오.
어디서 어떻게 받아 오나
공공데이터포털(data.go.kr)의 오픈API 세 곳에서 받아 합칩니다. 셋 다 활용신청 승인 후 발급받은 인증키가 필요합니다. 같은 주말을 세 원천으로 재 봤을 때 서로 겹치는 행사가 거의 없었습니다. 한 곳만 쓰면 나머지 둘이 통째로 빠지는 것이 셋을 합친 이유입니다.
한국관광공사 국문관광정보 (15101578)
GET https://apis.data.go.kr/B551011/KorService2/searchFestival2?serviceKey=…&_type=json&eventStartDate=…&numOfRows=1000&pageNo=N- 관광공사가 관리하는 축제 정보입니다. 좌표 채움률이 가장 높고 대표 이미지가 있어, 같은 행사가 여러 원천에서 나오면 이쪽을 우선합니다.
eventStartDate는 “그 날짜 이후 시작하는 축제”를 뜻합니다. 오늘 날짜를 주면 이미 진행 중인 축제가 통째로 빠지므로, 과거 날짜를 넣고 클라이언트에서 거릅니다. 구KorService1은 폐기됐습니다.- 이번 발행에서 200건입니다.
전국문화축제표준데이터 (15013104)
GET https://api.data.go.kr/openapi/tn_pubr_public_cltur_fstvl_api?serviceKey=…&type=json&pageNo=N&numOfRows=1000- 지방자치단체가 직접 등록하는 축제 자료입니다.
- 이번 발행에서 160건입니다.
전국공연행사정보표준데이터 (15013106)
GET https://api.data.go.kr/openapi/tn_pubr_public_pblprfr_event_info_api?serviceKey=…&type=json&pageNo=N&numOfRows=1000- 공연과 전시가 주를 이루며, 세 원천 가운데 유일하게 요금 필드(chrgeInfo)가 있습니다.
- 이번 발행에서 380건입니다.
우리가 손댄 것
원본을 그대로 쓰지 않은 부분입니다. 아래가 전부입니다.
- 합치기: 세 원천의 필드 이름이 다릅니다(title / fstvlNm / eventNm 등). 이름, 시작일, 종료일, 주소, 좌표, 전화번호를 하나의 모양으로 맞춥니다.
- 거르기: 종료일이 지난 행사(10,581건), 기간이 60일을 넘는 등록분(112건), 좌표가 없는 행사(52건)를 뺍니다.
- 중복 제거: 이름을 세게 정규화하고(공백, 괄호, 회차 표기 제거) 시작일을 붙여 키를 만듭니다. 같은 키가 여러 원천에서 나오면 한국관광공사 > 전국문화축제 > 전국공연행사 순으로 하나만 남깁니다. 이번 수집에서 76건이 중복이었습니다.
- 시군구 코드 붙이기: 주소를 읽어 행정안전부 5자리 코드를 붙입니다. 원본에는 없는 항목입니다. 주소로 붙이지 못한 곳은 좌표로 한 번 더 시도합니다.
- 주말 판정: 행사 기간에 토요일이나 일요일이 하루라도 들어가면 “주말에 열림” 파셋을 켭니다. 기간이 7일 이상이면 주말이 반드시 끼므로 검사 없이 참으로 잡습니다.
- 좌표: 손대지 않았습니다. 원천이 부여한 값을 그대로 씁니다. 없으면 뺍니다.
새로 고치기와 검사
주 1회 자동으로 세 원천을 다시 받습니다. 받을 때마다 일곱 가지를 검사하고, 하나라도 통과하지 못하면 새 자료를 발행하지 않고 멈춥니다. 이전에 발행한 자료가 그대로 남습니다.
- 발행 대상이 200건 이상인가
- 앞으로 30일 안에 열리는 행사가 100건 이상인가
- 좌표 채움률(창 안 레코드 기준)이 80% 이상인가
- 위도 33.0에서 38.7까지, 경도 124.5에서 131.0까지를 벗어난 좌표가 0건인가
- 원천별 id 에 겹치는 것이 없는가
- 행사가 있는 시도가 12곳 이상인가
- 시군구 매칭률이 90% 이상인가
이번 수집에서 앞으로 7일 안에 열리는 행사는 143건, 30일 안에 열리는 행사는 420건입니다.
이 자료로 하면 안 되는 것
- 특정 지역의 축제 수를 견주기. 위에 적은 대로, 많이 보이는 지역은 축제가 많은 곳이 아니라 자료를 성실히 올리는 곳일 수 있습니다.
- 과거 행사를 찾기. 끝난 행사는 다음 수집에서 빠집니다. 이 도구는 아카이브가 아닙니다.
- 요금이 비어 있으면 유료라고 단정하기. 요금 필드가 있는 원천이 하나뿐이라, 비어 있는 것은 모르는 것입니다.
- 장소나 일정을 확인 없이 믿기. 기간과 장소는 주최 측 신고값이며, 현장 사정으로 바뀔 수 있습니다.
한눈에 보는 사실
| 출처 기관 | 한국관광공사, 행정안전부(지자체) |
|---|---|
| 원본 | https://www.data.go.kr/data/15101578/openapi.do |
| 이용조건 | 저작자표시, 자료 설명 화면에서 자세히 |
| 자료 기준일 | |
| 마지막으로 받은 때 | 2026-09-27 |
| 담긴 곳 | 740건 |
| 새로 고침 주기 | 주 1회 자동으로 받습니다. 14일 넘게 새 자료를 받지 못하면 화면 위 줄이 받는 것이 늦어짐으로 바뀝니다. |
자주 묻는 질문
- 이번 주말 축제 어디서 하나요?
- 지도를 열면 지금 열리고 있거나 곧 열리는 축제와 공연이 전부 보입니다. "이번 주말" 고르개를 켜면 이번 주 토·일에 열리는 것만 남습니다. 이번 주말에 해당하는 행사가 적으면 자동으로 다음 창까지 넓혀서 보여 드립니다.
- 왜 우리 동네 축제가 없나요?
- 이 지도는 지방자치단체가 공공데이터에 등록한 행사만 담습니다. 등록하지 않은 행사는 들어올 방법이 없습니다. 축제가 많은 동네가 아니라 자료를 성실히 올리는 동네가 많아 보이는 것은 이 때문입니다.
- 작년 축제가 나오지 않는 이유는?
- 이미 끝난 행사는 싣지 않습니다. 이 도구가 답하는 질문은 "지금 뭐 하지"이고, 검색하면 작년 축제만 나오는 것이 이 도구를 만든 이유였습니다. 종료일이 오늘보다 이르면 목록에서 빠집니다.
- 무료 축제만 볼 수 있나요?
- "무료" 고르개를 켜면 무료로 표시된 행사만 남습니다. 다만 요금 정보는 세 원천 가운데 하나(전국공연행사정보표준데이터)에만 있어, 무료 표시가 없다고 해서 유료라는 뜻은 아닙니다.
- 다음 주에도 같은 목록인가요?
- 아닙니다. 매주 자동으로 원천 자료를 다시 받아 끝난 행사를 빼고 새로 열리는 행사를 더합니다. 다음 주에 보시면 목록이 달라져 있습니다.
- 데이터를 그대로 내려받을 수 있나요?
- 자료 쪽에서 담긴 행사 전부를 CSV 로 내려받을 수 있습니다. 인용하실 때는 원 출처가 한국관광공사와 행정안전부이고 받아서 정리한 곳은 최고수 공작소라는 점을 함께 밝혀 주시면 됩니다.
- 얼마나 자주 새로 고치나요?
- 주 1회 자동으로 다시 받아 옵니다. 14일이 넘도록 새 자료를 받지 못하면 화면 위 줄이 "새로 고침이 밀림"으로 바뀌고 며칠 밀렸는지 함께 적습니다.
틀린 값을 찾으셨다면
한국관광공사, 행정안전부(지자체)가 공개한 원본이 틀린 경우 저희가 고칠 수 없습니다. 해당 기관에 정정을 요청하고, 그동안 이 페이지에 한계 표기를 답니다. 저희 쪽 가공이 틀렸다면 알려 주세요. 어느 축제·공연행사의 어느 항목인지 알려 주시면 확인해서 고치고 바뀐 것에 남깁니다.