# 레이더 API 목록 (04-radar) - 기상청 API허브

> 기상청 API허브 '레이더' 분류의 API 39개 목록입니다. 항목마다 API 이름(명세 주소 연결), 요청 주소, 설명 순서로 적었습니다.
> 필요한 API 를 고른 뒤 연결된 명세(OpenAPI 3.0.3 yml)를 열면 요청 인자와 응답 형식을 볼 수 있습니다.

- 호출 방법·인증키 안내: https://apihub.kma.go.kr/llms.txt
- 모든 요청은 HTTP GET 이며 인증키를 `authKey` 쿼리 인자로 붙입니다.

## 01-radar-precip-hsr / 01-radar-file-list

- [레이더 지점별 파일 목록 조회서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/01-radar-file-list/01-radar-site-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_stn_file_list.php` - 특정 관측일에 대해 레이더 지점별로 생산된 자료 파일의 목록을 조회하는 서비스
- [레이더 합성 파일 목록 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/01-radar-file-list/02-radar-composite-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_cmp_file_list.php` - 특정 관측일에 대해 합성 종류별로 생산된 레이더 합성자료 파일의 목록을 조회하는 서비스

## 01-radar-precip-hsr / 02-radar-composite-data

- [HSR 합성파일 정보 조회서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/02-radar-composite-data/01-hsr-composite-file-info.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp_inf` - 지정한 시각의 레이더 합성자료 파일에 대한 정보를 조회하는 서비스
- [레이더 합성자료 조회서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/02-radar-composite-data/02-radar-composite-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp1_api` - 지정한 시각의 레이더 합성자료를 500m 해상도 격자값으로 조회하는 서비스 (ASCII 또는 Binary)

## 01-radar-precip-hsr / 03-radar-composite-by-admin-area

- [레이더합성장 행정구역 조회서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/03-radar-composite-by-admin-area/01-radar-composite-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getCompCappiQcdArea` - 지정한 행정구역에 해당하는 레이더 합성장 값을 행정구역 좌표와 함께 조회하는 서비스
- [레이더 합성장 한반도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/03-radar-composite-by-admin-area/01-radar-composite-by-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getCompCappiQcdAll` - 한반도 전역의 레이더 합성장 격자 자료를 격자 정보(격자 크기·좌표 개수·기준점)와 함께 조회하는 서비스

## 01-radar-precip-hsr / 04-radar-composite-grid-latlon

- [레이더 합성장 격자 데이터 위경도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/04-radar-composite-grid-latlon/01-radar-composite-grid-latlon.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_latlon_api` - 레이더 합성장 격자의 격자점별 경도값 또는 위도값을 조회하는 서비스
- [레이더 합성장 격자데이터 위경도 파일(NetCDF) 다운로드 서비스](https://apihub.kma.go.kr/specs/04-radar/01-radar-precip-hsr/04-radar-composite-grid-latlon/02-radar-composite-grid-latlon-netcdf-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_latlon_file_down.php` - 레이더 합성장 격자의 위경도 정보를 NetCDF 파일로 내려받는 서비스

## 02-radar-precip / 01-radar-composite-download

- [레이더합성자료 다운로드 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/01-radar-composite-download/01-radar-composite-download.yml) - `GET https://apihub.kma.go.kr/api/typ04/url/rdr_cmp_file.php` - 지정한 시각의 레이더 합성자료를 이진파일 또는 이미지파일로 내려받는 서비스

## 02-radar-precip / 02-radar-composite-by-admin-area

- [레이더지점별 QCD 한반도 조회서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/02-radar-composite-by-admin-area/01-radar-site-qcd-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getSiteCappiQcdAll` - 지정한 레이더 지점의 QC된 CAPPI 자료를 한반도 전역 격자값으로 조회하는 서비스
- [레이더지점별 QCD 행정구역 조회서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/02-radar-composite-by-admin-area/02-radar-site-qcd-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getSiteCappiQcdArea` - 지정한 레이더 지점의 QC된 CAPPI 자료를 행정구역 단위 값으로 조회하는 서비스

## 02-radar-precip / 03-graphic-radar-dist-map

- [HSR 분포도 조회서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/03-graphic-radar-dist-map/01-hsr-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_cmp1_img` - HSR 등 레이더 합성자료를 지도 배경 위에 그린 분포도 이미지를 조회하는 서비스
- [레이더 바람장(WISSDOM) 분포도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/03-graphic-radar-dist-map/02-radar-wind-wissdom-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_wis_ana_img` - 레이더 바람장 분석장(WISSDOM)을 지정 고도에 대해 그린 분포도 이미지를 조회하는 서비스
- [빙결고도 분포도 조회서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/03-graphic-radar-dist-map/03-freezing-level-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_obs_taH_img` - 레이더 자료로 산출한 빙결고도의 분포도 이미지를 조회하는 서비스
- [초단기 강수 예측 분포도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/03-graphic-radar-dist-map/04-very-short-precip-forecast-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-qpf_ana_img` - 레이더 기반 초단기 강수 예측(QPF) 결과를 예측 시간별 분포도 이미지로 조회하는 서비스

## 02-radar-precip / 04-graphic-radar-composite-image

- [레이더-HSR 합성영상 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/04-graphic-radar-composite-image/01-radar-hsr-composite-image.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_cmp1_imgp` - 배경지도 없이 레이더 HSR 합성영상을 생성하고, 투영법과 이미지 경로를 JSON으로 반환하는 서비스
- [레이더-바람 합성영상 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/04-graphic-radar-composite-image/02-radar-wind-composite-image.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_wis_ana_imgp` - 배경지도 없이 레이더 바람장(WISSDOM) 영상을 생성하고, 투영법과 이미지 경로를 JSON으로 반환하는 서비스
- [레이더-빙결고도 합성영상 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/04-graphic-radar-composite-image/03-radar-freezing-level-composite-image.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_obs_taH_imgp` - 배경지도 없이 빙결고도 영상을 생성하고, 투영법과 이미지 경로를 JSON으로 반환하는 서비스
- [레이더-1시간 강수 예측 합성영상 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/02-radar-precip/04-graphic-radar-composite-image/04-radar-1h-precip-forecast-composite-image.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-qpf_ana_imgp` - 배경지도 없이 초단기 강수 예측(QPF) 영상을 생성하고, 투영법과 이미지 경로를 JSON으로 반환하는 서비스

## 03-radar-raw-data / 01-radar-site-data

- [UF 파일 목록 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/01-uf-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_uf_list.php` - 지정한 시각을 기준으로 레이더 사이트의 UF 파일 목록을 조회하는 서비스
- [UF 파일 목록과 크기 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/02-uf-file-list-with-size.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_file_list.php` - 지정한 관측일의 레이더 파일 목록을 파일 크기와 함께 조회하는 서비스
- [UF 정보 조회서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/03-uf-info.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_uf_inf` - 지정한 시각·지점의 UF 파일에 담긴 관측 정보(제원)를 조회하는 서비스
- [UF 자료 SWEEP 조회서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/04-uf-sweep.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_uf_data` - 지정한 시각·지점의 UF 자료를 Volume·SWEEP 단위로 조회하는 서비스
- [UF파일 다운로드 서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/05-uf-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_file_down.php` - 지정한 시각·지점의 레이더 UF 파일을 내려받는 서비스
- [NC파일 다운로드 서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/01-radar-site-data/06-nc-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/rdr_file_down_nc.php` - 지정한 시각·지점의 레이더 자료를 NetCDF(NC) 파일로 내려받는 서비스

## 03-radar-raw-data / 02-radar-site-download

- [레이더 사이트 자료 다운로드 서비스](https://apihub.kma.go.kr/specs/04-radar/03-radar-raw-data/02-radar-site-download/01-radar-site-download.yml) - `GET https://apihub.kma.go.kr/api/typ04/url/rdr_site_file.php` - 지정한 시각·지점의 레이더 사이트 자료를 QCD·원시자료·이미지 중 선택하여 내려받는 서비스

## 04-radar-aws-composite / 01-radar-aws-composite

- [레이더 AWS 전체지점 합성자료 조회서비스](https://apihub.kma.go.kr/specs/04-radar/04-radar-aws-composite/01-radar-aws-composite/01-radar-aws-all-station-composite.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp_aws_all_pt_data` - 지정한 시각에 대해 전체 AWS 지점의 레이더 합성자료 에코값과 에코 고도를 조회하는 서비스
- [레이더 AWS 지점별 합성자료 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/04-radar-aws-composite/01-radar-aws-composite/02-radar-aws-station-composite.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rdr_cmp_aws_pt_data` - 특정 AWS 지점에 대해 레이더 합성자료의 에코 값과 에코 고도를 기간 단위로 조회하는 서비스

## 05-lightning-obs / 01-lightning-raw-data

- [낙뢰 관측 조회 서비스 (1세대)](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/01-lightning-raw-data/01-lightning-obs-gen1.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_kma_np1.php` - 1988년 8월 15일부터 1998년 2월 7일까지의 낙뢰 관측자료(관측일시·위경도·강도)를 기간 단위로 조회하는 서비스
- [낙뢰 관측 조회 서비스 (2세대)](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/01-lightning-raw-data/02-lightning-obs-gen2.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_kma_np2.php` - 1998년 2월 7일부터 2001년 12월 31일까지의 낙뢰 관측자료(관측일시·위경도·강도·다중성·위치계산방식 등)를 기간 단위로 조회하는 서비스
- [낙뢰 관측 조회 서비스 (3세대)](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/01-lightning-raw-data/03-lightning-obs-gen3.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_kma_np3.php` - 2002년 1월 1일부터 2019년 6월 14일까지의 낙뢰 관측자료(관측일시·위경도·강도·확률 타원·낙뢰 종류 등)를 기간 단위로 조회하는 서비스
- [낙뢰 관측 조회 서비스 (신 낙뢰 관측자료)](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/01-lightning-raw-data/04-lightning-obs-new-system.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_kma_nx1.php` - 2015년 4월 1일 이후의 신 낙뢰 관측자료(스트로크 ID·WGS84 좌표·고도·강도·낙뢰 타입·품질 정보 등)를 기간 단위로 조회하는 서비스

## 05-lightning-obs / 02-lightning-detection-data

- [낙뢰 탐지자료 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/02-lightning-detection-data/01-lightning-detection-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_pnt.php` - 기준 시각의 전후 일정 시간 내에 탐지된 낙뢰를 위치·강도·종류와 함께 조회하는 서비스 (중심 위경도와 반경 지정 가능)

## 05-lightning-obs / 03-lightning-count-by-station

- [낙뢰 관측지점별 횟수 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/03-lightning-count-by-station/01-lightning-count-by-station.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_stn.php` - ASOS 또는 AWS 지점을 기준으로 지정 반경 내에서 발생한 낙뢰 횟수를 오전·오후 및 지상·구름 간으로 구분하여 조회하는 서비스

## 05-lightning-obs / 04-graphic-lightning-dist-map

- [낙뢰 강도 분포도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/04-graphic-lightning-dist-map/01-lightning-intensity-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/lgt/nph-lgt_str_img` - 낙뢰 강도(lgt_str)를 객관 분석하여 지도 배경 위에 그린 분포도 이미지를 조회하는 서비스
- [낙뢰 강도합 분포도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/04-graphic-lightning-dist-map/02-lightning-intensity-sum-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/lgt/nph-lgt_ana_img` - 낙뢰 강도합(lgt_stc)을 객관 분석하여 지도 배경 위에 그린 분포도 이미지를 조회하는 서비스
- [낙뢰 분포도 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/04-graphic-lightning-dist-map/03-lightning-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/lgt/nph-lgt_dst_img` - 낙뢰 발생(lgt_dst)을 객관 분석하여 지도 배경 위에 그린 분포도 이미지를 조회하는 서비스

## 05-lightning-obs / 05-lightning-by-admin-area

- [행정구역별 낙뢰 발생 정보 조회 서비스](https://apihub.kma.go.kr/specs/04-radar/05-lightning-obs/05-lightning-by-admin-area/01-lightning-by-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/lgt_admndst_cnt.php` - 기준 시각으로부터 지정한 시간차 만큼의 기간에 대해 시도 또는 시군구 단위 낙뢰 발생 횟수를 조회하는 서비스

## 06-radar-station-info

- [레이더 관측지점 정보 조회서비스](https://apihub.kma.go.kr/specs/04-radar/06-radar-station-info/01-radar-station-info.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WethrBasicInfoService/getRadarObsStn` - 레이더 관측지점의 지점번호·지점코드·지점명·경위도·안테나 해발고도·관측반경 과 관측 시작·종료시각 등 지점 메타정보를 조회하는 서비스
