융합기상

기상기후데이터와 에너지, 생활, 교통, 산업 등 타분야 데이터를 융합하거나, 융합에 특화된 데이터를 제공합니다.

api 상세
개요

CCTV 기반 도로날씨정보는 고속도로에 설치되어 있는 도로 CCTV 영상을 활용하여 도로경로별 기상정보(안개, 비, 눈)를 생산하여 안전한 도로주행을 위해 제공하는 정보입니다.
요 소

날씨판별정보(비, 눈, 안개, 맑음)와 강도(강, 중, 약)
지 점

(2024년 기준) 고속도로 11개 노선* 서비스 제공
* 경부선, 서울도시고속, 서해안선, 영동선, 인천공항선, 제2경인선, 중부내륙선, 중부선(2024.12.20.~), 중앙선, 통영대전선, 호남선
보유기간

2016.12.~현재(고속도로 노선별 보유기간은 상이함)
생산주기

실시간
유의사항

고속도로 CCTV 영상 특성 상 야간의 날씨판별 성능이 떨어지므로 주간 시간대의 정보 활용 권장

1. CCTV 기반 도로날씨정보 조회

CCTV 및 노드링크 정보 참고자료

1.1 cctv지점별도로날씨조회(위경도정보/과거자료 포함)

https://apihub.kma.go.kr/api/typ01/url/cctv_ana_info.php?tm1=202312240000&tm2=202312240100&eqp=0500C00001&disp=1&help=1&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)년월일(KST)

기간: 시작시간 또는 시작일

tm2

년월일시분(KST)년월일(KST)

기간: 종료시간 또는 종료일

eqp

CCTV ID

CCTV 지점 ID(0 이거나 없으면 전체지점)

disp

표출

0(빈칸없는 CSV파일), 1(일정 간격)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

TM

관측시각 (KST)

EQP_ID

CCTV ID

STN_NM

CCTV 지점명

LAT

CCTV 설치 위도

LON

CCTV 설치 경도

HT

CCTV 고도

WH_CD

기상코드/ 00(맑음), 11(안개 약), 12(안개 중), 13(안개 강), 21(비 약), 22(비 중), 23(비 강), 31(눈 약), 32(눈 중), 33(눈 강)

FOG_CD

안개코드 / 00(맑음), 11(안개 약), 12(안개 중), 13(안개 강)

RN_CD

강수코드 / 00(맑음), 21(비 약), 22(비 중), 23(비 강)

SN_CD

눈코드 / 00(맑음), 31(눈 약), 32(눈 중), 33(눈 강)

1.2 표준노드링크별도로날씨조회(위경도정보/과거자료 포함)

https://apihub.kma.go.kr/api/typ01/url/cctv_ana_info_link.php?tm1=202312240000&tm2=202312240100&rlink=2600023902&disp=1&help=1&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)년월일(KST)

기간: 시작시간 또는 시작일

tm2

년월일시분(KST)년월일(KST)

기간: 종료시간 또는 종료일

rlink

표준노드링크 ID

표준노드링크 ID(0 이거나 없으면 전체지점)

disp

표출

0(빈칸없는 CSV파일), 1(일정 간격)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

TM

관측시각 (KST)

LINK_ID

표준노드링크 ID

EQP_ID

CCTV ID

STN_NM

CCTV 지점명

LAT

CCTV 설치 위도

LON

CCTV 설치 경도

HT

CCTV 고도

WH_CD

기상코드/ 00(맑음), 11(안개 약), 12(안개 중), 13(안개 강), 21(비 약), 22(비 중), 23(비 강), 31(눈 약), 32(눈 중), 33(눈 강)

FOG_CD

안개코드 / 00(맑음), 11(안개 약), 12(안개 중), 13(안개 강)

RN_CD

강수코드 / 00(맑음), 21(비 약), 22(비 중), 23(비 강)

SN_CD

눈코드 / 00(맑음), 31(눈 약), 32(눈 중), 33(눈 강)

1.3 CCTV지점별 고속도로정보 조회

https://apihub.kma.go.kr/api/typ01/url/cctv_road_info.php?eqp=&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

eqp

CCTV ID

CCTV 지점 ID(0 이거나 없으면 전체지점)

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

EQP_ID

CCTV ID

STN_NM

CCTV 지점명

ROAD_NAME

고속도로명

1.4 CCTV지점별도로날씨조회

https://apihub.kma.go.kr/api/typ02/openApi/RoadWthrInfoService/getCctvStnRoadWthr?pageNo=1&numOfRows=10&dataType=XML&eqmtId=0500C00001&hhCode=00&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

eqmtId

CCTV ID

CCTV 아이디

hhCode

시간코드

최근 결과 시간

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseDate

수집날짜

baseTime

수집시간

weatherNm

날씨명

1.5 표준노드링크별도로날씨조회

https://apihub.kma.go.kr/api/typ02/openApi/RoadWthrInfoService/getStdNodeLinkRoadWw?pageNo=1&numOfRows=10&dataType=XML&stdLinkId=2370012300&hhCode=00&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

stdLinkId

표준노드링크 ID

표준노드링크 ID

hhCode

시간 코드

최근 결과 시간

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseData

수집날짜

baseTime

수집시간

weatherNm

날씨명

cctvId

CCTV 수집 　ID

cctvNm

수집 CCTV 명

2. 도로위험기상정보

도로위험기상정보 파일포맷정의서 참고자료

2.1 도로위험기상정보

https://apihub.kma.go.kr/api/typ04/url/road_file_down.php?tm=202512150100&roadNum=045&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

tm

기준시각

년월일시분(UTC)
※ 서비스 기간 : 2025. 12. 15 ~
※ 변수 미입력시 최신자료 호출
※ (도로살얼음) 11.15 ~ 3.15/ (안개) 연중

roadNum

고속도로명

고속도로별 노선번호(예시. 045:중부내륙선)
- 고속도로(노선번호): 중부내륙선(045), 경부선(001), 무안광주대구선(012), 서해안선(015), 새만금포항선(020), 호남선(025), 순천완주선(027), 서산영덕선(030), 통영대전중부선(035), 영동선(050), 중앙선(055), 호남선의지선(251)
※ 미선택시 자료 다운로드가 불가합니다.

authKey

인증키

발급된 API 인증키
출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

Zip File

자세한 정보는 파일포맷정의서에서 확인해주세요

3. 도로기상관측정보

도로기상관측지점 참고자료

3.1.1 지점번호로 조회

https://apihub.kma.go.kr/api/typ01/url/road_stn_obs.php?mode=1&tm1=202603251012&tm2=202603251035&var=11102&help=1&disp=0&authKey=9FWE1RN2S4iVhNUTdguIAQ

3.1.2 고속도로 노선으로 조회

https://apihub.kma.go.kr/api/typ01/url/road_stn_obs.php?mode=2&tm1=202603231012&var=12&disp=0&help=1&authKey=9FWE1RN2S4iVhNUTdguIAQ

3.1.3 관측소 종류로 조회

https://apihub.kma.go.kr/api/typ01/url/road_stn_obs.php?mode=3&tm1=202603071010&help=1&var=2&disp=1&authKey=9FWE1RN2S4iVhNUTdguIAQ

요청인자
데이터 기본 정보
인자명 의미 설명

mode

조회기준 선택

1: 지점번호로 조회
2: 고속도로 노선으로 조회
3: 관측소 종류로 조회

tm1

시작시간

시작시간(YYYYMMDDHHMI, 년월일시분, KST)
조회할 시간구간의 시작시간(없으면 현재시각과 같음) / 단일지점 조회기간은 24시간으로 제한
※ 2024. 1. 1.부터 조회가 가능하며 제공시작 시점은 지점마다 차이가 있습니다.

tm2

종료시간

종료시간(YYYYMMDDHHMI, 년월일시분, KST)
조회할 시간구간의 종료시간(없으면 시작시간과 같음) / 단일지점 조회기간은 24시간으로 제한

var

조회번호

mode에 선택한 기준에 대한 번호
- (mode=1) 관측지점 번호 / 0이거나 없으면 전체지점
- (mode=2) 고속도로 노선 번호 / 11-중부내륙, 12-서해안, 13-경부선, 14-무안광주대구선, 23-호남선, 24-새만금포항선, 33-통영-대전중부선, 34-순천완주선, 43-영동선, 44-서산영덕선, 53-중앙선, 54-호남선의지선
- (mode=3) 관측소 종류 번호 / 1-거점, 2-기본, 3-목표(안개), 4-목표(결빙)
※ mode=1의 전체지점 조회시, mode=2 또는 3으로 호출시 tm1 기준 시각 데이터만 제공

disp

표출형태

0: 변수별로 일정한 길이 유지
1: 구분자(,)로구분

help

도움말

1: 표시
2: 표시하지않음