# 융합기상 API 목록 (10-convergence-weather) - 기상청 API허브

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

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

## 01-high-res-grid / 01-high-res-grid-500m

- [고해상도 격자 자료 전체영역 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/01-high-res-grid-full-area.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_api` - 남한지역 500m 해상도 고해상도 격자 자료를 요소 하나에 대해 전체영역으로 조회하는 서비스
- [고해상도 격자 자료 특정지점 단일요소 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/02-high-res-grid-point-single-element.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_pt_api` - 지정한 위·경도 지점의 고해상도 격자 자료를 요소 하나에 대해 기간 단위로 조회하는 서비스
- [고해상도 격자 자료 특정지점 다중요소 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/03-high-res-grid-point-multi-element.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_nc_var.php` - 지정한 위·경도 지점의 고해상도 격자 자료를 여러 요소에 대해 한 번에 조회하는 서비스
- [고해상도 격자 자료 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/04-high-res-grid-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_grid_nc_down.php` - 고해상도 격자 자료를 NetCDF 파일로 내려받는 서비스
- [고해상도 격자 자료 분포도 이미지 조회서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/05-high-res-grid-dist-map-image.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_nc_img` - 고해상도 격자자료를 지도 위에 표출한 분포도 이미지를 조회하는 서비스
- [고해상도 격자 자료 위경도 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/01-high-res-grid-500m/06-high-res-grid-latlon.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sfc_obs_latlon_api`

## 01-high-res-grid / 02-high-res-grid-500m-stats

- [격자 통계 특정지점 연평균 조회서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/02-high-res-grid-500m-stats/01-high-res-grid-point-annual-mean.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_pt_api.php`
- [격자 통계 구역 연평균 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/02-high-res-grid-500m-stats/02-admin-area-annual-mean.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_area_api.php` - 연평균 격자 통계값을 행정구역 단위 또는 두 지점으로 지정한 사각 구역 단위로 조회하는 서비스
- [격자 통계 전체영역 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/02-high-res-grid-500m-stats/03-grid-stats-full-area-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_grid_nc_sts_down.php` - 전체영역의 연평균 격자 통계값을 NetCDF4 파일로 내려받는 서비스
- [격자 통계 연평균 분포도 이미지 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/01-high-res-grid/02-high-res-grid-500m-stats/04-grid-stats-annual-mean-map-image.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sfc_obs_nc_sts_img.php` - 연평균 격자 통계값을 행정구역·전체영역·특정구역 단위의 분포도 이미지로 조회하는 서비스

## 02-energy-support / 01-gk2a-ai-solar-radiation

- [인공지능 기반 일사량 이미지 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/02-energy-support/01-gk2a-ai-solar-radiation/01-gk2a-ai-solar-radiation-korea.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_img` - 천리안2A호 자료에 인공지능기법(CNN)을 적용하여 산출한 한반도 전천일사량 분포도 이미지를 조회하는 서비스
- [인공지능 기반 일사량 텍스트 조회서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/02-energy-support/01-gk2a-ai-solar-radiation/02-ai-solar-radiation-text.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_txt`
- [인공지능기반 일사량 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/02-energy-support/01-gk2a-ai-solar-radiation/03-ai-solar-radiation-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php` - 인공지능기반 한반도 일사량 자료를 NetCDF 파일 또는 PNG 이미지 파일로 내려받는 서비스

## 02-energy-support / 02-reanalysis-wind-field

- [재현 바람장 남한 영역 격자 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/02-energy-support/02-reanalysis-wind-field/01-reanalysis-wind-south-korea-grid.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rawm_data_api` - 남한 영역의 재현 바람장 격자 자료를 고도별 풍향·풍속 변수로 조회하는 서비스
- [재현 바람장 위경도 추출 조회서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/02-energy-support/02-reanalysis-wind-field/02-reanalysis-wind-latlon-extract.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-rawm_latlon_api` - 지정한 위·경도 지점의 재현 바람장 자료를 고도별로 기간 단위로 추출하여 조회하는 서비스

## 03-life-safety / 01-life-weather-index

- [대상 환경별 체감온도(여름철) 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/01-life-weather-index/01-apparent-temp-summer-by-environment.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/LivingWthrIdxServiceV3/getSenTaIdxV3` - 노인·어린이·농촌·건설 현장 등 대상 환경별 여름철 체감온도 지수를 동네예보 지점 단위로 조회하는 서비스
- [자외선지수 조회서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/01-life-weather-index/02-uv-index.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/LivingWthrIdxServiceV3/getUVIdxV3` - 동네예보 지점별 자외선지수를 오늘·내일·모레 예측값으로 조회하는 서비스
- [대기 정체 지수 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/01-life-weather-index/03-air-stagnation-index.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/LivingWthrIdxServiceV3/getAirDiffusionIdxV3` - 동네예보 지점별 대기 정체 지수를 3시간 간격 예측값으로 조회하는 서비스

## 03-life-safety / 02-health-weather-index

- [꽃가루농도위험지수(참나무) 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/02-health-weather-index/01-pollen-risk-index-oak.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/HealthWthrIdxServiceV2/getOakPollenRiskIdxV2` - 동네예보 지점별 참나무 꽃가루농도위험지수를 오늘·내일·모레 예측값으로 조회하는 서비스
- [꽃가루농도위험지수(소나무) 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/02-health-weather-index/02-pollen-risk-index-pine.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/HealthWthrIdxServiceV2/getPinePollenRiskIdxV2` - 동네예보 지점별 소나무 꽃가루농도위험지수를 오늘·내일·모레 예측값으로 조회하는 서비스
- [꽃가루농도위험지수(잡초류) 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/03-life-safety/02-health-weather-index/03-pollen-risk-index-weeds.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/HealthWthrIdxServiceV2/getWeedsPollenRiskndxV2`

## 04-traffic-safety / 01-cctv-road-weather

- [CCTV 지점별 도로 날씨 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/01-cctv-road-weather/01-cctv-road-weather.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/cctv_ana_info.php` - 고속도로 CCTV 지점별로 판별한 도로날씨(안개·비·눈)와 강도를 기간 단위로 조회하는 서비스
- [표준노드 링크별 도로 날씨 조회 서비스 (위경도·과거 자료 포함)](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/01-cctv-road-weather/02-road-weather-by-node-link.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/cctv_ana_info_link.php` - 표준노드 링크 단위로 매핑된 CCTV 도로 날씨 판별 결과를 기간 단위로 조회하는 서비스
- [CCTV 지점별 고속도로 정보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/01-cctv-road-weather/03-cctv-highway-info.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/cctv_road_info.php` - CCTV 지점이 속한 고속도로 노선명을 조회하는 서비스
- [CCTV 지점별 도로날씨 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/01-cctv-road-weather/04-cctv-road-weather.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/RoadWthrInfoService/getCctvStnRoadWthr`
- [표준노드 링크별 도로 날씨 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/01-cctv-road-weather/05-road-weather-by-node-link.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/RoadWthrInfoService/getStdNodeLinkRoadWw` - 표준노드 링크별 도로 날씨 판별 결과를 XML/JSON 형식으로 조회하는 서비스

## 04-traffic-safety / 02-road-hazard-weather

- [도로 위험기상정보 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/02-road-hazard-weather/01-road-hazard-weather-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ04/url/road_file_down.php` - 고속도로 노선별 도로 위험기상정보(도로 살얼음·안개)를 ZIP 파일로 내려받는 서비스

## 04-traffic-safety / 03-road-weather-obs

- [도로 기상관측정보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/04-traffic-safety/03-road-weather-obs/01-road-weather-obs.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/road_stn_obs.php` - 도로 기상관측소의 관측자료를 지점번호·고속도로 노선·관측소 종류 중 하나의 기준으로 조회하는 서비스

## 05-industry / 01-tour-course-weather

- [시군구별 관광 기후지수 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/01-tour-course-weather/01-tourism-climate-index-by-district.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/TourStnInfoService/getCityTourClmIdx` - 관광코스별 관광지의 관광 기후지수와 상세 날씨를 조회하는 서비스
- [관광지 동네예보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/01-tour-course-weather/02-tour-course-spot-weather.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/TourStnInfoService/getTourStnVilageFcst`

## 05-industry / 02-crop-main-producing-area

- [주산지 특보현황 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/01-main-producing-area-warning-status.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandPwn`
- [주산지 동네예보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/02-main-producing-area-village-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandVilageFcst`
- [주산지 동네예보 실황 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/03-main-producing-area-village-nowcast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandVilageNcst`
- [월 통계 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/04-monthly-stats.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getMmStatistics` - 작물별 농업 주산지의 월 단위 기상통계(평균·최고·최저기온, 습도, 강수량, 풍속, 일조)를 조회하는 서비스
- [순 통계 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/05-ten-day-stats.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getPureStatistics`
- [일 통계 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/02-crop-main-producing-area/06-daily-stats.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getDayStatistics` - 작물별 농업 주산지의 일 단위 기상통계를 조회하는 서비스

## 05-industry / 03-beach-forecast

- [해수욕장 초단기 예보 조회](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/01-beach-very-short-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getUltraSrtFcstBeach` - 해변코드별 해수욕장의 초단기예보를 조회하는 서비스
- [해수욕장 파고 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/02-beach-wave-height.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getWhBuoyBeach` - 해변 코드별 해수욕장 인근 부이의 파고 관측값을 조회하는 서비스
- [해수욕장 조석정보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/03-beach-tide-info.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getTideInfoBeach`
- [해수욕장 일출·일몰 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/04-beach-sunrise-sunset.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getSunInfoBeach`
- [해수욕장 수온 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/05-beach-water-temp.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getTwBuoyBeach`
- [해수욕장 단기예보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/03-beach-forecast/06-beach-short-term-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getVilageFcstBeach`

## 05-industry / 04-frost-probability-forecast

- [서리 발생 가능성 예측정보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/04-frost-probability-forecast/01-frost-probability-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/FrstFcstInfoService/getFrstOcurFcst`

## 05-industry / 05-mountain-forecast

- [산악 예보 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/05-mountain-forecast/01-mountain-forecast.yml) - `GET https://apihub.kma.go.kr/api/typ08/getMountainWeather` - 산악 예보 지점번호별 산악 지역의 예보를 조회하는 서비스

## 05-industry / 06-power-weather-index

- [전력기상지수 조회 서비스](https://apihub.kma.go.kr/specs/10-convergence-weather/05-industry/06-power-weather-index/01-power-weather-index.yml) - `GET https://apihub.kma.go.kr/api/typ08/getPowerWeather`
