무더위쉼터 지도의 출처와 한계
행정안전부가 공개하는 전국 무더위쉼터. 이 자료가 어디서 왔고, 어떻게 받아 왔고, 무엇을 못 하는지를 적었습니다.
알려진 한계
아래는 무더위쉼터 지도를 쓰기 전에 반드시 알아야 하는 것들입니다. 한 줄로 먼저 적고, 그 아래에서 각각을 풀어 설명합니다.
- 유형 코드(FCLTY_TY·FCLTY_SCLAS)의 뜻이 공식 명세에 정의돼 있지 않아 해석하지 않았습니다
- 운영시간은 지자체가 신고한 값 그대로이며 실제와 다를 수 있습니다
- 에어컨·선풍기 대수는 신고 시점 기준이며 현재 가동 상태를 뜻하지 않습니다
- 야간 개방 여부가 기록된 곳이 드물어 실제보다 적게 나옵니다
- 한 곳 마커의 숫자는 수용 인원(USE_PSBL_NMPR)이며 신고 시점 기준입니다
한계를 더 자세히
유형 코드를 해석하지 않았습니다
원본에는 시설유형 중분류(FCLTY_TY)와 소분류(FCLTY_SCLAS) 코드가 들어 있지만, 이 코드가 무엇을 뜻하는지는 공식 명세에 정의돼 있지 않습니다. 코드표를 찾을 수 없으므로 해석하지 않고 원본 값 그대로 실었습니다. 뜻을 지어내면 틀릴 수 있고 그 사실이 화면에 드러나지 않습니다.
운영시간은 신고값입니다
지자체가 기관에 보고한 시간 그대로이며 현장 사정(임시 폐쇄·시설 점검 등)은 반영되지 않습니다. 평일과 주말·공휴일 운영시간을 따로 보여 주지만 둘 다 신고값이고, 특히 공휴일 운영 여부는 실제와 다를 수 있습니다.
에어컨·선풍기 대수는 신고 시점 기준입니다
에어컨 대수(COLR_HOLD_ARCNDTN)와 선풍기 대수(COLR_HOLD_ELEFN)는 지자체가 쉼터를 등록하거나 갱신할 때 적어 낸 값입니다. 현재 가동 중인 대수를 뜻하지 않고, 고장·교체·이동이 반영되지 않습니다. 화면의 “에어컨” 토글은 이 대수가 1대 이상인 곳을 걸러 내며, 2026-09-14 기준 58,772곳이 해당합니다.
야간 개방 여부가 기록된 곳이 드뭅니다
야간 개방 필드(CHCK_MATTER_NIGHT_OPN_AT)에 Y가 기록된 곳은 2026-09-14 기준 2,020곳뿐입니다. 실제로 야간에 여는 곳이 더 많을 수 있지만 기록되지 않은 곳은 잡아낼 방법이 없습니다. 이 토글을 끄면 전체가 나오고, 켜면 기록된 곳만 남습니다 — 켠 결과가 야간 쉼터의 전부는 아닙니다.
한 곳 마커의 숫자는 수용 인원입니다
지도에서 한 곳을 나타내는 마커 안의 숫자는 수용 인원(USE_PSBL_NMPR)입니다. 지자체가 신고한 시점의 최대 정원이며, 현재 이용 가능한 자리 수를 뜻하지 않습니다. 61,751곳 가운데 58,635곳에 수용 인원이 기록돼 있고, 중앙값은 25명입니다. 기록이 없는 곳은 0으로 채우지 않고 비워 둡니다.
여름 도구입니다
무더위쉼터는 폭염 대비 시설이므로 여름철에 운영합니다. 운영 기간 밖에는 문이 닫혀 있을 수 있고, 이 자료에는 “지금 운영 중인지” 필드가 없어 문이 닫혔는지 열렸는지 알 수 없습니다. 겨울에 갈 곳을 찾으신다면 한파쉼터 지도를 보시기 바랍니다.
어디서 어떻게 받아 오나
재난안전데이터공유플랫폼(safetydata.go.kr)의 무더위쉼터 인터페이스 DSSP-IF-10942를 공식 오픈API 로 받습니다. 활용신청 승인 후 발급받은 인증키가 필요하며, 이 플랫폼은 활용신청 건마다 인증키를 따로 발급합니다.
GET https://www.safetydata.go.kr/V2/api/DSSP-IF-10942?serviceKey=…&returnType=json&pageNo=N&numOfRows=1000- 한 번 새로 고칠 때 요청 약 62회입니다 (1,000건씩 페이지네이션). 일 호출 한도가 1,000회이며 전량 수집은 그 안에 넉넉히 들어갑니다.
이용조건 원문은 확인하지 못했습니다. 활용신청 승인으로 받았고, 플랫폼이 별도의 공공누리 유형이나 이용조건을 명시하는지 확인되면 여기에 적겠습니다. 지금은 “이용조건 미확인”으로 등재돼 있습니다.
우리가 손댄 것
원본을 그대로 쓰지 않은 부분입니다. 아래가 전부입니다.
- 시·군·구 코드 붙이기 — 원본의 행정구역코드(ARCD) 앞 5자리를 행정안전부 시군구 코드로 잘라 붙였습니다. ARCD가 없거나 우리 경계 코드에 없는 값은 시군구를 확정하지 못합니다. 이번 수집분에서 미매칭은 909건입니다.
- 운영시간 조립 — 평일과 주말·공휴일 운영 시작·종료 시각(HHMM 네 자리)을 “평일 HH:MM
HH:MM · 주말 HH:MMHH:MM” 형태로 합쳤습니다. 계산하지 않고 신고값 그대로 보여 줍니다. - 플래그 4종 산출 — 에어컨 대수가 1대 이상이면 “에어컨 보유”, 주말 운영시간이 등록돼 있으면 “주말 운영”, 야간 개방 필드가 Y이면 “야간 개방”, 숙박 가능 필드가 Y이면 “숙박 가능”으로 잡았습니다.
- 주소 정리 — 이름과 주소에서 불필요한 공백과 특수문자를 정리했습니다.
- 좌표 — 손대지 않았습니다. 기관이 부여한 값을 그대로 씁니다. 비어 있으면 비워 둡니다.
새로 고치기와 검사
주 1회 자동으로 다시 받습니다. 받을 때마다 다섯 가지를 검사하고, 하나라도 통과하지 못하면 새 자료를 버리고 바로 앞 자료를 그대로 씁니다.
- 총 건수가 50,000건 이상인가
- 좌표 채움률이 99% 이상인가
- 위도 33.0–38.7 · 경도 124.5–131.0 을 벗어난 좌표가 0건인가
- 시설번호(RSTR_FCLTY_NO)에 겹치는 것이 없는가
- ARCD→시군구 조인률이 98% 이상인가
이 자료로 하면 안 되는 것
- 실시간 운영 상태를 확인하기. 이 자료에는 현재 문을 열었는지가 없습니다.
- 남은 수용 인원을 확인하기. 수용 인원은 최대 정원이며 현재 이용 인원은 이 자료에 없습니다.
- 시설유형별로 비교하기. 유형 코드의 뜻이 정의돼 있지 않아 어떤 종류인지 알 수 없습니다.
- 겨울에 갈 곳을 찾기. 무더위쉼터는 여름 시설이며 운영 기간 밖에는 대부분 닫혀 있습니다.
한눈에 보는 사실
| 출처 기관 | 행정안전부 |
|---|---|
| 원본 | https://www.safetydata.go.kr/ |
| 이용조건 | 이용조건 미확인 · 자료 설명 화면에서 자세히 |
| 자료 기준일 | |
| 마지막으로 받은 때 | 2026-09-14 |
| 담긴 곳 | 61,751곳 |
| 새로 고침 주기 | 주 1회 자동으로 받습니다. 14일 넘게 새 자료를 받지 못하면 화면 위 줄이 받는 것이 늦어짐으로 바뀝니다. |
| 지역 화면 | 256개 전부 보기 . 담긴 곳이 3곳 미만인 지역은 만들지 않습니다. |
자주 묻는 질문
- 지금 무더위쉼터가 문을 열었나요?
- 이 자료에는 현재 운영 상태가 없습니다. 화면의 운영시간은 지자체가 신고한 값이며 실제와 다를 수 있습니다. 무더위쉼터는 여름철에 운영하므로 그 밖의 기간에는 문이 닫혀 있을 수 있습니다. 가기 전에 해당 시설에 확인해 주세요.
- 에어컨 있는 쉼터만 볼 수 있나요?
- 네. 화면 위 "에어컨" 고르개를 켜면 에어컨을 1대 이상 갖춘 곳만 남습니다. 2026-09-14 기준 58,772곳이 해당합니다. 에어컨 대수는 신고 시점 기준이며 현재 가동 상태를 뜻하지 않습니다.
- 수용 인원 숫자는 무슨 뜻인가요?
- 지자체가 신고한 최대 수용 가능 인원입니다. 현재 남은 자리를 뜻하지 않습니다. 61,751곳 가운데 58,635곳에 수용 인원이 기록돼 있고 중앙값은 25명입니다.
- 야간에 여는 쉼터가 왜 이렇게 적나요?
- 야간 개방 여부 필드에 값이 기록된 곳만 야간으로 잡으며, 2026-09-14 기준 2,020곳뿐입니다. 실제로 야간에 여는 곳이 더 많을 수 있지만 기록돼 있지 않으면 알 방법이 없습니다.
- 겨울에도 쉼터를 찾을 수 있나요?
- 무더위쉼터는 여름 시설이라 운영 기간 밖에는 대부분 문을 닫습니다. 겨울에 갈 곳을 찾으신다면 같은 재난안전데이터공유플랫폼에서 받은 한파쉼터 지도를 보시기 바랍니다.
- 얼마나 자주 새로 고치나요?
- 주 1회 자동으로 다시 받아 옵니다. 14일이 넘도록 새 자료를 받지 못하면 화면 위 줄이 "새로 고침이 밀림"으로 바뀌고 며칠 밀렸는지 함께 적습니다.
- 데이터를 그대로 내려받을 수 있나요?
- 자료 설명 화면에서 담긴 곳 전부를 CSV 로 내려받을 수 있습니다. 다만 이 자료의 이용조건 원문이 확인되지 않았으므로, 재배포하실 때는 재난안전데이터공유플랫폼의 이용조건을 직접 확인해 주시기 바랍니다.
틀린 값을 찾으셨다면
행정안전부가 공개한 원본이 틀린 경우 저희가 고칠 수 없습니다. 해당 기관에 정정을 요청하고, 그동안 이 페이지에 한계 표기를 답니다. 저희 쪽 가공이 틀렸다면 알려 주세요 — 어느 무더위쉼터의 어느 항목인지 알려 주시면 확인해서 고치고 바뀐 것에 남깁니다.