최고수 공작소공공데이터 지도와 도구
자동으로 받는 중 출처 행정안전부 자료 기준일 마지막으로 받은 때 14:31 KST 담긴 곳 12,764 이 자료의 문제 자료 설명

한파쉼터 현황

행정안전부 재난안전데이터공유플랫폼이 공개하는 전국 한파쉼터의 이름·도로명주소·좌표·이용가능인원·운영시간입니다. 같은 부처의 무더위쉼터와 같은 플랫폼이지만 항목 이름이 전혀 달라 별개 자료로 다룹니다.

인용과 내려받기

행정안전부, 「한파쉼터 현황」, 2026-08-09 기준. 최고수 공작소 가공. https://python-choigosu.com/data/cold-shelter-2026/ (확인일: YYYY-MM-DD).

기준일 2026-08-09 은 원본 기관이 공개한 자료의 날짜이고, 최종 수집은 2026-08-09 입니다. 이 주소는 최신 수집분을 가리키므로, 특정 시점을 인용하실 때는 위 기준일을 함께 적어 주십시오 — 그 시점의 원본은 아래 스냅샷 이력에 그대로 남아 있습니다.

CSV 재배포 없음 — 위 접근 경로의 원본이 전체입니다 기관 원본 페이지 필드 사전

UTF-8 BOM 을 붙였습니다. 한국어 Windows 의 Excel 은 BOM 이 없는 UTF-8 CSV 를 cp949 로 해석해 상호와 주소가 전부 깨집니다. 이 파일의 1차 독자가 기자와 연구자이고 그들이 여는 도구가 대부분 Excel 이므로, 그쪽이 바로 열리는 쪽을 골랐습니다. pandas·R·duckdb 로 읽으실 때는 인코딩을 utf-8-sig 로 지정하시면 됩니다 (지정하지 않으면 첫 열 이름 앞에 보이지 않는 문자가 붙습니다 — 그렇게 눈에 보이는 실패가 되도록 고른 것입니다). 줄바꿈은 CRLF(RFC 4180), 참·거짓 항목은 참일 때 Y, 아니면 빈 칸입니다.

이용조건이 미확인인 동안 원본 전량을 그대로 재배포하지 않으며, 이 CSV 는 주소를 정리하고 시군구 코드를 붙인 가공본입니다.

출처와 이용조건

한파쉼터 현황의 출처 기관·원본·이용조건·마지막으로 받은 때·담긴 곳 수
자료 IDcold-shelter-2026
출처 기관행정안전부
원본 https://www.safetydata.go.kr/disaster-data/view?dataSn=966
이용조건 공공누리 유형 미확인

활용신청 승인으로 받았고 이용조건 원문은 미확인입니다. 플랫폼이 별도의 공공누리 유형이나 이용조건을 명시하는지 확인되면 여기에 적습니다.

데이터 기준일
최종 수집
담긴 곳 53,026
기간2026
지역대한민국
새로 고침 주기 주 1회 자동으로 받음 · 30일이 넘으면 밀렸다고 적음
쓰는 도구 한파쉼터 지도

어느 경로로 받았나

재현에 필요한 것을 전부 적습니다. 공식 오픈API 인지 아닌지도 그대로 밝힙니다 — 경로를 숨기면 재현할 수 없고, 재현할 수 없는 자료는 인용할 가치가 없습니다.

  1. HTTP GET (오픈API) 인증 필요

    https://www.safetydata.go.kr/V2/api/DSSP-IF-10804

    파라미터 serviceKey · returnType=json · pageNo · numOfRows=1000

    재난안전데이터공유플랫폼의 공식 오픈API 입니다. 활용신청 승인 후 발급받은 인증키가 필요합니다. 이 플랫폼은 활용신청 건마다 인증키를 따로 발급하므로 무더위쉼터 키로는 부를 수 없습니다 (권한 없음 코드 20). numOfRows=1000 기준 54회로 전량 수집이 끝납니다.

커버리지

한파쉼터 현황의 지역 커버리지
범위전국 17개 시·도 전부. 원본에 행정구역코드가 없어 주소로 먼저 붙이고, 주소만으로 확정되지 않는 곳은 좌표로 시군구를 판정했습니다. 원본이 2026년 인천 행정구역 개편을 아직 반영하지 않아 그 지역은 좌표 판정이 유일한 방법이었습니다.
데이터가 있는 지역 0개 시군구 · 16개 시도
지역 페이지 0개. 담긴 곳이 3건 미만인 지역은 만들지 않습니다 — 내용 없는 페이지를 대량 생산하지 않기 위해서입니다.
지역 미매칭 2건이 어느 시군구에도 붙지 않았습니다

스냅샷 이력

받은 원본을 항목을 골라내지 않고 통째로 압축해 보관해 둡니다. 필요한 것만 남기면 공공데이터의 항목이 바뀐 사실 자체를 영원히 알 수 없기 때문입니다. 원본 API 가 죽어도 이 스냅샷만으로 사이트를 다시 빌드할 수 있습니다.

원본 스냅샷 파일 목록
수집일 파일 구분 크기(압축)
data/raw/hanpa-swimteo/2026-08-09.json.gz 본체 3.3MB

가공 산출물: data/dist/hanpa-swimteo/index.json 1.5MB · data/dist/hanpa-swimteo/meta.json 322B

보존 정책 — 최신 1개와 매월 1일자 수집분은 영구 보관하고, 그 사이 주간 수집분은 정리합니다.

알려진 한계

  • 운영시간을 적어 내지 않은 곳이 22.9%입니다 — 시간이 비어 있다고 문을 닫는 곳은 아닙니다
  • 평일 운영시간은 14.2%만 적혀 있어, 평일에 여는지로는 거를 수 없게 두었습니다
  • 야간 개방 여부가 기록된 곳이 드물어 실제보다 적게 나옵니다
  • 운영시간은 지자체가 신고한 값 그대로이며 실제와 다를 수 있습니다
  • 유형 코드(FCLT_TYPE·FCLTY_SCLAS)의 뜻이 공식 명세에 정의돼 있지 않아 해석하지 않았습니다
  • 같은 시설번호를 서로 다른 쉼터가 나눠 쓰는 곳이 5건 있어, 그 곳들만 번호 뒤에 구분 표시를 붙였습니다
  • 원본이 2026년 인천 행정구역 개편을 아직 반영하지 않아, 그 지역은 좌표로 시군구를 확정했습니다
  • 한 곳 마커의 숫자는 이용가능 인원(UTZTN_PSBLTY_TNOP)이며 신고 시점 기준입니다

각 항목을 풀어 쓴 설명과 자주 묻는 질문은 한파쉼터 지도 자료 설명에 있습니다. 여기 적힌 출처나 이용조건이 틀렸다면 알려 주세요.

형식

아래 열 이름이 CSV 의 머리글이자 JSON 파일의 키입니다. 채움률은 이번 수집분 0건을 직접 세어 계산했습니다. 참·거짓 항목은 참인 건수만 셉니다 — 원본이 참일 때만 기록하기 때문입니다.

한파쉼터 현황의 필드 목록과 채움률
이름 채움률 설명
id 시설번호 string 0.0% (0) 한파쉼터 고유번호. 같은 번호를 서로 다른 쉼터가 나눠 쓰는 곳이 5건 있어 그 곳들만 구분 표시를 붙였습니다.
원본 항목 REARE_FCLT_NO
name 쉼터 이름 string 0.0% (0) 쉼터 명칭.
원본 항목 REARE_NM
lat 위도 coordinate 0.0% (0) WGS84 위도. 채움률 100%입니다.
원본 항목 LAT
lng 경도 coordinate 0.0% (0) WGS84 경도. 항목 이름이 LOT 이며 무더위쉼터(LO)와 다릅니다.
원본 항목 LOT
addr 도로명주소 string 0.0% (0) 도로명 상세주소.
원본 항목 RONA_DADDR
sgg 시군구 코드 string 0.0% (0) 행정표준코드 5자리. 원본에 없어 주소·좌표로 우리가 붙인 값입니다.
capacity 이용가능 인원 number 0.0% (0) 이용 가능 인원(명). 채움률 98.1%이며 값이 없으면 0으로 싣고 화면에서는 모름으로 적습니다.
원본 항목 UTZTN_PSBLTY_TNOP
hours 운영시간 string 0.0% (0) 지자체 신고값 그대로입니다. 22.9%가 비어 있습니다.
note 비고 string 0.0% (0) 지자체가 적어 낸 참고 사항.
원본 항목 RMRK
type 시설유형 중분류 string 0.0% (0) 코드의 뜻이 공식 명세에 정의돼 있지 않아 해석하지 않았습니다.
원본 항목 FCLT_TYPE
subtype 시설유형 소분류 string 0.0% (0) 코드의 뜻이 공식 명세에 정의돼 있지 않아 해석하지 않았습니다.
원본 항목 FCLTY_SCLAS
flags.weekend 주말·공휴일 운영 boolean 0.0% (0) 토·일·공휴일 운영시간이 등록돼 있으면 참. 셋의 신고율이 사실상 같아 하나로 합쳤습니다.
flags.night 야간 개방 boolean 0.0% (0) 야간 운영시간이 등록돼 있으면 참. 기록된 곳이 드물어 실제보다 적게 나옵니다.