레이더

지점별 데이터와 이를 합성한 강수지역, 강수세기, 이동속도 등의 데이터를 영상자료와 데이터파일로 제공합니다.

api 상세
개요

지형차폐의 영향이 없는 지상에 가장 가까운 고도각 자료로 추정한 레이더 강우량(HSR: Hybrid Surface Rainfall)으로, 지형에코와 비기상에코 등의 영향을 최소화하여 레이더 강우량의 정확도를 향상시켰고, 에코고도를 함께 제공하여 레이더양상 분석능력을 강화하였습니다.
요 소

반사도(CZ), 차등반사도(DR), 비차등위상차(KD), 고도각, 고도값
지 점

관악산, 오성산, 구덕산, 고산, 강릉, 백령도, 진도, 광덕산, 면봉산, 인천공항, 성산
보유기간

2016년 ~ 현재
생산주기

분(5분 주기) 자료

1. 레이더 파일 목록 조회

호출URL정보

레이더 지점별 파일 목록

https://apihub.kma.go.kr/api/typ01/url/rdr_stn_file_list.php?stn=KWK&rdr=HSR&tm=20210815&size=Y&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

tm

년월일(KST)

관측일

stn

레이더 지점코드

KWK(관악산) 등

rdr

자료 종류

RAW(원시자료), QCD(QC된 자료), HSR, HCI(수상체), PTY(밝은띠), LNG(480km), LQC(480km QCD)

cmp

합성 종류

HSP(최적2), HSR(최적), HCI(수상체), HAIL(우박), LNG(480km), LNP(480km),
OTH(국외), PPI(PPI0), CPP(CAPPI), CMX(CMAX)

ext

유관기관 포함

Y(유관기관 포함 합성자료,기본), K(기상청 자료만 합성)

size

파일 크기

Y : 파일 크기(bytes) 같이 표시 (속도가 느림)

filter

포함여부

파일명에서 filter 문자열이 포함된 것만 표시 (없으면 모두 표시)

authKey

인증키

발급된 API 인증키

호출URL정보

레이더 합성파일 목록

https://apihub.kma.go.kr/api/typ01/url/rdr_cmp_file_list.php?cmp=HSR&tm=20210815&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

tm

년월일(KST)

관측일

stn

레이더 지점코드

KWK(관악산) 등

rdr

자료 종류

RAW(원시자료), QCD(QC된 자료), HSR, HCI(수상체), PTY(밝은띠), LNG(480km), LQC(480km QCD)

cmp

합성 종류

HSP(최적2), HSR(최적), HCI(수상체), HAIL(우박), LNG(480km), LNP(480km),
OTH(국외), PPI(PPI0), CPP(CAPPI), CMX(CMAX)

ext

유관기관 포함

Y(유관기관 포함 합성자료,기본), K(기상청 자료만 합성)

size

파일 크기

Y : 파일 크기(bytes) 같이 표시 (속도가 느림)

filter

포함여부

파일명에서 filter 문자열이 포함된 것만 표시 (없으면 모두 표시)

authKey

인증키

발급된 API 인증키

2. 레이더 합성자료 (500m해상도, 5분주기) 조회

레이더 합성자료(500m해상도) 포맷정보 참고자료

호출URL정보

HSR 합성파일 정보

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp_inf?tm=201807091620&cmp=HSR&qcd=MSK&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

tm

년월일시분(KST)

합성자료의 시각 (없으면 가장 최근파일의 시간)

cmp

합성종류

HSR, HCI, HAIL, LNG, PPI, CPP, CMX, NUM,
PCPH(HSR기반 PCP), PCPP(PPI기반 PCP)

qcd

합성대상

cmp=HSR이면 qcd=KMA 또는 NQC,EXT,MSK
cmp=HCI,HAIL이면, qcd=KMA,EXT
cmp=PPI,CPP,CMX,LNG,NUM이면, qcd=NQC,QCD,EXT
cmp=PCPH이면, qcd=KMA,MSK,EXT
cmp=PCPP이면, qcd=NQC,QCD,EXT

obs

요소

ECHO(dBZ값*100), EBH(고도값(m))

acc

누적기간(분)

누적강수(PCP*)인 경우, 60의 배수만 가능

map

지도영역

HB(한반도,기본), HR(레이더영역), HC(480km영역

disp

제공방식

A(ASCII방식), B(Bianry)

자료포맷

설명

disp=A 인경우
#으로 시작하는 줄은 주석줄이니 처리하지 않음
주석이 아닌 처음 줄은 X,Y축 격자수를 표시 (예: 2305, 2881,=)
다음줄부터 ,로 구분하여 10개 격자씩 출력
XY영역으로 볼때, 왼쪽 아래에서 오른쪽 위로 수평 우선으로 출력
X축 한 라인이 끝날때 10개가 아니어도 ,=으로 종료하고 다음줄로 넘어감
표출되는 값은 정수이며, dbz*100이 된 값임
레이더 관측영역밖이면 -30000, 레이더관측영역안에서 에코가 탐지되지 않
은 경우는 -25000
disp=B의 경우,
short로 모두 출력하며, 처음 4byte는 nx(X축 격자점수, 2byte), ny(Y축 격자
점수, 2byte)이며
그 다음부터는 nx*ny개의 격자점의 값이 short로 출력됨

authKey

인증키

발급된 API 인증키

호출URL정보

HSR에 마스킹처리

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp1_api?tm=201807091620&cmp=HSR&qcd=MSK&obs=ECHO&map=HB&disp=A&authKey=L7BLiqT7RsiwS4qk-8bIhQ

HSR기반 1시간 누적

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp1_api?tm=201807091620&cmp=PCPH&qcd=MSK&obs=ECHO&acc=60&map=HB&disp=A&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

tm

년월일시분(KST)

합성자료의 시각 (없으면 가장 최근파일의 시간)

cmp

합성종류

HSR, HCI, HAIL, LNG, PPI, CPP, CMX, NUM,
PCPH(HSR기반 PCP), PCPP(PPI기반 PCP)

qcd

합성대상

cmp=HSR이면 qcd=KMA 또는 NQC,EXT,MSK
cmp=HCI,HAIL이면, qcd=KMA,EXT
cmp=PPI,CPP,CMX,LNG,NUM이면, qcd=NQC,QCD,EXT
cmp=PCPH이면, qcd=KMA,MSK,EXT
cmp=PCPP이면, qcd=NQC,QCD,EXT

obs

요소

ECHO(dBZ값*100), EBH(고도값(m))

acc

누적기간(분)

누적강수(PCP*)인 경우, 60의 배수만 가능

map

지도영역

HB(한반도,기본), HR(레이더영역), HC(480km영역

disp

제공방식

A(ASCII방식), B(Bianry)

자료포맷

설명

disp=A 인경우
#으로 시작하는 줄은 주석줄이니 처리하지 않음
주석이 아닌 처음 줄은 X,Y축 격자수를 표시 (예: 2305, 2881,=)
다음줄부터 ,로 구분하여 10개 격자씩 출력
XY영역으로 볼때, 왼쪽 아래에서 오른쪽 위로 수평 우선으로 출력
X축 한 라인이 끝날때 10개가 아니어도 ,=으로 종료하고 다음줄로 넘어감
표출되는 값은 정수이며, dbz*100이 된 값임
레이더 관측영역밖이면 -30000, 레이더관측영역안에서 에코가 탐지되지 않
은 경우는 -25000
disp=B의 경우,
short로 모두 출력하며, 처음 4byte는 nx(X축 격자점수, 2byte), ny(Y축 격자
점수, 2byte)이며
그 다음부터는 nx*ny개의 격자점의 값이 short로 출력됨

authKey

인증키

발급된 API 인증키

3. 행정구역별 레이더합성자료 조회

호출URL정보

레이더합성장한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getCompCappiQcdAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&compType=CPP&dataTypeCd=CZ&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

dateTime

관측시간

자료 시간 간격 : 5분 YYYYMMDDHH24MI(최근 2일까지 조회가능)

compType

합성 타입

CPP, PPI, CMX, HSP (활용가이드 하단 첨부 참조)

dataTypeCd

자료구분코드

CZ, RN(활용가이드 하단 첨부 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

레이더합성장행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getCompCappiQcdArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&compType=CPP&dataTypeCd=CZ&dongCode=1100000000&authKey=L7BLiqT7RsiwS4qk-8bIhQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

dateTime

관측시간

자료 시간 간격 : 5분 YYYYMMDDHH24MI(최근 2일까지 조회가능)

compType

합성 타입

CPP, PPI, CMX, HSP (활용가이드 하단 첨부 참조)

dataTypeCd

자료구분코드

CZ, RN(활용가이드 하단 첨부 참조)

dongCode

행정구역 코드

행정구역 코드(첨부파일 참고)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값