융합기상

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

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={인증키입력}

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

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={인증키입력}

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

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={인증키입력}

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

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={인증키입력}

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

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={인증키입력}

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

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={인증키입력}

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

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. 도로기상관측정보

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

노면상태 코드(SFS) 참고자료

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={인증키입력}

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={인증키입력}

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={인증키입력}

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

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: 표시하지않음