융합기상

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

api 상세
개요

CCTV 기반 도로날씨정보는 도로에 설치되어 있는 고정식 관측장비 뿐만 아니라, 도로 CCTV, 차량부착 센터 등 도로의 방대한 빅데이터를 활용하여 도로경로별 기상정보(안개, 비, 눈 등)를 생산하여 안전한 도로주행을 위해 제공하는 정보입니다.

요 소

위험기상정보(비, 눈, 안개, 양호)와 강도(강, 중, 약)

지 점

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

보유기간

2016.12~현재

생산주기

실시간

유의사항

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

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

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

호출URL정보

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

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

요청인자

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

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(눈 강)

호출URL정보

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

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

요청인자

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

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(눈 강)

호출URL정보

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

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

요청인자

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

eqp

CCTV ID

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

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

EQP_ID

CCTV ID

STN_NM

CCTV 지점명

ROAD_NAME

고속도로명

호출URL정보

CCTV지점별도로날씨조회

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

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

eqmtId

CCTV ID

CCTV 아이디

hhCode

시간코드

최근 결과 시간

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

baseDate

수집날짜

baseTime

수집시간

weatherNm

날씨명

호출URL정보

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

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

요청인자

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

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 명