# 위성 API 목록 (05-satellite) - 기상청 API허브

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

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

## 01-gk2a / 01-gk2a-data

- [요소별 자료안내](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/01-gk2a-data/01-element-data-guide.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_meta_list.php` - 기상청에서 제공하는 천리안2A호 위성데이터 요소별 자료설명 제공
- [파일 목록조회](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/01-gk2a-data/02-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_data_list.php` - 기상청에서 제공하는 천리안2A호 위성데이터 파일목록 제공
- [요소별 데이터 다운로드(NC)](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/01-gk2a-data/03-element-data-download-nc.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_nc_down.php` - 기상청에서 제공하는 천리안2A호 위성데이터 요소별 NC 데이터 다운로드
- [요소별 이미지 다운로드](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/01-gk2a-data/04-element-image-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_img_down.php` - 기상청에서 제공하는 천리안2A호 위성데이터 요소별 이미지 다운로드
- [격자자료 조회](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/01-gk2a-data/05-grid-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_data_view.php` - 기상청에서 제공하는 천리안2A호 위성데이터 요소별 일부 격자데이터 문숫자 제공

## 01-gk2a / 02-gk2a-basic-obs

- [천리안 2A호 기본관측자료 데이터 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/02-gk2a-basic-obs/01-gk2a-basic-obs-data-download.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/{dataType}/{area}/data` - 천리안 2A호 기본 관측 채널 자료를 지정한 영역·시각에 대해 데이터 파일로 내려받는 서비스
- [천리안 2A호 기본 관측자료 데이터 목록 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/02-gk2a-basic-obs/02-gk2a-basic-obs-data-list.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/{dataType}/{area}/dataList` - 지정한 기간에 대해 내려받을 수 있는 기본 관측 데이터 파일의 목록을 조회하는 서비스
- [천리안 2A호 기본 관측자료 이미지 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/02-gk2a-basic-obs/03-gk2a-basic-obs-image-download.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/{dataType}/{area}/image` - 천리안 2A호 기본 관측 채널 자료를 지정한 영역·시각에 대해 이미지 파일로 내려받는 서비스
- [천리안 2A호 기본 관측자료 이미지 목록 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/02-gk2a-basic-obs/04-gk2a-basic-obs-image-list.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/{dataType}/{area}/imageList` - 지정한 기간에 대해 내려받을 수 있는 기본 관측 이미지 파일의 목록을 조회하는 서비스

## 01-gk2a / 03-gk2a-products

- [천리안 2A호 기상산출물 데이터 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/03-gk2a-products/01-gk2a-products-data-download.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/{dataType}/{area}/data` - 천리안 2A호 기상산출물을 지정한 영역·시각에 대해 데이터 파일로 내려받는 서비스
- [천리안 2A호 기상산출물 데이터 목록 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/03-gk2a-products/02-gk2a-products-data-list.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/{dataType}/{area}/dataList` - 지정한 기간에 대해 내려받을 수 있는 기상산출물 데이터 파일의 목록을 조회하는 서비스
- [천리안 2A호 기상산출물 이미지 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/03-gk2a-products/03-gk2a-products-image-download.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/{dataType}/{area}/image` - 천리안 2A호 기상산출물을 지정한 영역·시각에 대해 이미지 파일로 내려받는 서비스
- [천리안 2A호 기상산출물 이미지 목록 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/03-gk2a-products/04-gk2a-products-image-list.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/{dataType}/{area}/imageList` - 지정한 기간에 대해 내려받을 수 있는 기상산출물 이미지 파일의 목록을 조회하는 서비스

## 01-gk2a / 04-gk2a-space-weather

- [천리안 2A호 우주기상정보 데이터 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/04-gk2a-space-weather/01-gk2a-space-weather-data-download.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LV1/{dataType}/data` - 천리안 2A호 우주기상 탑재체가 관측한 전자·양성자 플럭스, 자기장, 위성체 내부대전량 자료를 데이터 파일로 내려받는 서비스
- [천리안 2A호 우주 기상정보 데이터 목록 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/04-gk2a-space-weather/02-gk2a-space-weather-data-list.yml) - `GET https://apihub.kma.go.kr/api/typ05/api/GK2A/LV1/{dataType}/dataList` - 지정한 기간에 대해 내려받을 수 있는 우주기상 데이터 파일의 목록을 조회하는 서비스

## 01-gk2a / 05-gk2a-wildfire-data

- [천리안 2A호 산불자료 텍스트 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/05-gk2a-wildfire-data/01-gk2a-wildfire-text.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_txt` - 천리안 2A호의 산불탐지 또는 산불위험도 격자자료를 텍스트로 조회하는 서비스
- [천리안 2A호 산불관련자료 이미지 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/05-gk2a-wildfire-data/02-gk2a-wildfire-image.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_img` - 천리안 2A호의 산불탐지 또는 산불위험도를 분포도 이미지로 조회하는 서비스
- [천리안 2A호 산불자료 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/05-gk2a-wildfire-data/03-gk2a-wildfire-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php` - 천리안 2A호의 산불탐지 또는 산불위험도 자료를 NetCDF 이진 파일 또는 PNG 이미지 파일로 내려받는 서비스

## 01-gk2a / 06-gk2-file-list

- [천리안 2호 위성 데이터 파일 목록 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/06-gk2-file-list/01-gk2-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_list.php` - 지정한 관측일시에 대해 천리안 2A호 위성 데이터 파일의 목록을 조회하는 서비스

## 01-gk2a / 07-gk2a-binary-download

- [천리안2A 파일 다운로드 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/07-gk2a-binary-download/01-gk2a-file-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php` - 천리안 2A호 기본 관측자료(L1B) 또는 기상산출물(L2)을 NetCDF 이진 파일 또는 PNG 이미지 파일로 내려받는 서비스

## 01-gk2a / 08-satellite-products-light

- [천리안위성 2A호 구름 분석 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/01-gk2a-cloud-analysis-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aclaArea` - 구름 분석 정보(CLA)를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 주간 구름산출물 행정구역 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/02-gk2a-daytime-cloud-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2adcoewArea` - 주간 구름 광학 특성 산출물(DCOEW)을 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 안개 행정구역 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/03-gk2a-fog-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2afogArea` - 안개(FOG)를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 에어로졸 산출물 행정구역 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/04-gk2a-aerosol-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aappsArea` - 에어로졸 광학 특성 산출물(APPS)을 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 구름 탐지 행정구역 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/05-gk2a-cloud-detection-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2acldArea` - 구름 탐지(CLD)를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 구름 분석 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/06-gk2a-cloud-analysis-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aclaAll` - 구름 분석정보(CLA)를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 주간 구름산출물 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/07-gk2a-daytime-cloud-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2adcoewAll` - 주간 구름 광학 특성 산출물(DCOEW)을 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 안개 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/08-gk2a-fog-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2afogAll` - 안개(FOG)를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 에어로졸 산출물 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/09-gk2a-aerosol-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aappsAll` - 에어로졸 광학 특성 산출물(APPS)을 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 구름 탐지 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/08-satellite-products-light/10-gk2a-cloud-detection-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2acldAll` - 구름탐지(CLD)를 한반도 전역 격자 자료로 조회하는 경량화 서비스

## 01-gk2a / 09-satellite-basic-obs-light

- [천리안위성 2A호 적외 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/01-gk2a-ir-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aIrAll` - 적외 채널의 관측자료를 한반도 전역 격자자료로 조회하는 경량화 서비스
- [천리안위성 2A호 근적외 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/02-gk2a-near-ir-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aNrAll` - 근적외 채널의 관측자료를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 단파 적외 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/03-gk2a-shortwave-ir-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aSwAll` - 단파적외 채널의 관측자료를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 가시 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/04-gk2a-visible-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aViAll` - 가시 채널의 관측자료를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 수증기 한반도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/05-gk2a-water-vapor-korea.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aWvAll` - 수증기 채널의 관측자료를 한반도 전역 격자 자료로 조회하는 경량화 서비스
- [천리안위성 2A호 적외 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/06-gk2a-ir-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aIrArea` - 적외 채널의 관측자료를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 근적외 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/07-gk2a-near-ir-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aNrArea` - 근적외 채널의 관측자료를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 단파적외 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/08-gk2a-shortwave-ir-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aSwArea` - 단파적외 채널의 관측자료를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 가시 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/09-gk2a-visible-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aViArea` - 가시 채널의 관측자료를 행정구역 단위로 조회하는 경량화 서비스
- [천리안위성 2A호 수증기 행정구역조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/09-satellite-basic-obs-light/10-gk2a-water-vapor-admin-area.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aWvArea` - 수증기 채널의 관측자료를 행정구역 단위로 조회하는 경량화 서비스

## 01-gk2a / 10-graphic-gk2a-dist-map

- [천리안 2A 분포도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/10-graphic-gk2a-dist-map/01-gk2a-dist-map.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/sat/nph-gk2a_img` - 천리안 2A호 관측자료를 지도 배경 위에 그린 분포도 이미지를 조회하는 서비스

## 01-gk2a / 11-graphic-gk2a-dist-map-no-basemap

- [천리안 2A호 분포도 조회서비스(배경지도 없음)](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/11-graphic-gk2a-dist-map-no-basemap/01-gk2a-dist-map-no-basemap.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/sat/nph-gk2a_imgp` - 배경지도 없이 천리안 2A호 관측영상을 생성하고, 투영법과 이미지 경로를 JSON으로 반환하는 서비스

## 01-gk2a / 12-gk2a-grid-latlon

- [천리안 2A호 격자 데이터 위경도 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/12-gk2a-grid-latlon/01-gk2a-grid-latlon.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-gk2a_latlon_api` - 천리안 2A호 관측 격자의 격자점별 경도값 또는 위도값을 조회하는 서비스
- [천리안 2A호 격자 데이터 위경도 파일(NetCDF) 다운로드](https://apihub.kma.go.kr/specs/05-satellite/01-gk2a/12-gk2a-grid-latlon/02-gk2a-grid-latlon-netcdf-download.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/gk2a_latlon_file_down.php` - 천리안 2A 관측 격자의 위경도 정보를 NetCDF 파일로 내려받는 서비스

## 02-coms / 01-coms-file-list

- [천리안 1호 위성 데이터 파일 목록 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/02-coms/01-coms-file-list/01-coms-file-list.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sat_file_list.php` - 천리안 1호 위성이 생산한 데이터 파일의 목록을 관측일 단위로 조회하는 서비스

## 02-coms / 02-coms-binary-data

- [천리안 이진자료 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/02-coms/02-coms-binary-data/01-coms-binary-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sat_data` - 천리안 위성의 채널별 격자자료를 격자수 정보와 함께 조회하는 서비스

## 02-coms / 03-coms-channel-value-by-station

- [천리안 지점별 채널 값 조회 서비스 (단일 위치·단일 채널)](https://apihub.kma.go.kr/specs/05-satellite/02-coms/03-coms-channel-value-by-station/01-coms-channel-value-single-point-single-channel.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-coms_pnt` - 지정한 위경도 한 곳에 대해 하나의 채널값을 기간 단위로 조회하는 서비스
- [천리안 지점별 채널 값 조회 서비스 (단일 위치·전체 채널)](https://apihub.kma.go.kr/specs/05-satellite/02-coms/03-coms-channel-value-by-station/02-coms-channel-value-single-point-all-channel.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/coms_pnt_vars.php` - 지정한 위경도 한 곳에 대해 모든 채널값을 기간 단위로 조회하는 서비스
- [천리안 지점별 채널 값 조회 서비스 (다중 지점·단일 채널)](https://apihub.kma.go.kr/specs/05-satellite/02-coms/03-coms-channel-value-by-station/03-coms-channel-value-multi-point-single-channel.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-coms_stns` - 지정한 여러 관측지점에 대해 하나의 채널값을 기간 단위로 조회하는 서비스
- [천리안 지점별 채널 값 조회서비스 (다중 지점·전체 채널)](https://apihub.kma.go.kr/specs/05-satellite/02-coms/03-coms-channel-value-by-station/04-coms-channel-value-multi-point-all-channel.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/coms_stns_vars.php` - 지정한 여러 관측지점에 대해 모든 채널 값을 기간 단위로 조회하는 서비스

## 02-coms / 04-coms-cloud-amount-by-station

- [천리안 기상관측지점별 운량 자료 조회 서비스](https://apihub.kma.go.kr/specs/05-satellite/02-coms/04-coms-cloud-amount-by-station/01-coms-cloud-amount-by-station.yml) - `GET https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-coms_stn_ca` - 기준 시각을 중심으로 지정한 평균 기간의 지점별 운량 평균값을 조회하는 서비스

## 02-coms / 05-coms-basic-obs

- [천리안 1호 기본 관측자료 조회서비스](https://apihub.kma.go.kr/specs/05-satellite/02-coms/05-coms-basic-obs/01-coms-basic-obs.yml) - `GET https://apihub.kma.go.kr/api/typ04/url/sat_coms_obs_file.php` - 천리안 1호의 기본 관측채널(적외1·적외2·수증기·단파적외·가시) 자료를 영역별로 내려받는 서비스
