위성

적외, 가시, 수증기 등 16개 채널로 관측한 기본 관측데이터와 지표면온도, 산불탐지 등 46종의 기상산출물데이터를 영상자료와 데이터파일로 제공합니다.

api 상세
개요

2018년 12월 5일에 발사된 천리안위성 2A호는 천리안위성 1호의 기상관측 역할을 승계하는 차세대 정지궤도 기상위성으로 기상 및 우주기상 관측임무를 수행합니다.
천리안위성 2A호는 16개의 기본채널 관측을 통해 52종의 기상산출물을 생산하며, 국내에서 개발한 우주기상 탑재체로 우주기상 감시 및 위성 운영과 관련되는 현상을 관측합니다.이로써 우리나라의 기상관측, 수치예보, 기후감시, 우주기상감시의 역량을 강화했습니다.

요 소

(기본관측)가시영상(4개), 단파적외영상(1개), 근적외영상(2개), 수증기영상(3개), 적외영상(6개)
(기상산출물)가강수량, 강우강도, 구름수액경로, 구름입자유효반경, 구름층/고도, 구름탐지, 대기불안정도 지수, 대기운동벡터, 산불탐지, 상향장파복사(대기상한), 안개, 에어로졸 광학두께, 에어로졸 입자크기, 연직온도 프로파일, 연직습도 프로파일, 운량, 운상, 운형, 적설/해빙, 지표면온도, 청천복사량, 총오존량, 하향단파복사(표면도달일사량), 해수면온도, 해수면온도 등 총 52종
지 점

전구, 동아시아, 한반도
보유기간

2019년 7월 ∼ 현재
생산주기

- 전구/동아시아: 매시 정각부터 10분 간격
- 한반도: 매시 정각부터 2분 간격

1. 천리안 2A호 기본관측자료 조회

호출URL정보

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/NR016/FD/data?date=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE1B/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE1B/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

VI004 - 가시(0.47μm):파랑
VI005 - 가시(0.51μm):초록
VI006 - 가시(0.64μm):빨강
VI008 - 가시(0.86μm):식생
NR013 - 근적외(1.37μm):권운
NR016 - 근적외(1.6μm):눈/얼음
SW038 - 단파적외(3.8μm):야간안개/하층운
WV063 - 수증기(6.3μm):상층 수증기
WV069 - 수증기(6.9μm):중층 수증기
WV073 - 수증기(7.3μm):하층 수증기
IR087 - 적외(8.7μm):구름상
IR096 - 적외(9.6μm):오존
IR105 - 적외(10.5μm):깨끗한 대기창
IR112 - 적외(11.2μm):대기창
IR123 - 적외(12.3μm):오염된 대기창
IR133 - 적외(13.3μm):이산화탄소

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/SW038/TP/dataList?sDate=202210272350&eDate=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE1B/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE1B/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

VI004 - 가시(0.47μm):파랑
VI005 - 가시(0.51μm):초록
VI006 - 가시(0.64μm):빨강
VI008 - 가시(0.86μm):식생
NR013 - 근적외(1.37μm):권운
NR016 - 근적외(1.6μm):눈/얼음
SW038 - 단파적외(3.8μm):야간안개/하층운
WV063 - 수증기(6.3μm):상층 수증기
WV069 - 수증기(6.9μm):중층 수증기
WV073 - 수증기(7.3μm):하층 수증기
IR087 - 적외(8.7μm):구름상
IR096 - 적외(9.6μm):오존
IR105 - 적외(10.5μm):깨끗한 대기창
IR112 - 적외(11.2μm):대기창
IR123 - 적외(12.3μm):오염된 대기창
IR133 - 적외(13.3μm):이산화탄소

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

다운로드

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/VI004/EA/image?date=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE1B/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE1B/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

VI004 - 가시(0.47μm):파랑
VI005 - 가시(0.51μm):초록
VI006 - 가시(0.64μm):빨강
VI008 - 가시(0.86μm):식생
NR013 - 근적외(1.37μm):권운
NR016 - 근적외(1.6μm):눈/얼음
SW038 - 단파적외(3.8μm):야간안개/하층운
WV063 - 수증기(6.3μm):상층 수증기
WV069 - 수증기(6.9μm):중층 수증기
WV073 - 수증기(7.3μm):하층 수증기
IR087 - 적외(8.7μm):구름상
IR096 - 적외(9.6μm):오존
IR105 - 적외(10.5μm):깨끗한 대기창
IR112 - 적외(11.2μm):대기창
IR123 - 적외(12.3μm):오염된 대기창
IR133 - 적외(13.3μm):이산화탄소

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

자료조회

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE1B/VI005/FD/imageList?sDate=202210272350&eDate=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE1B/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE1B/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

VI004 - 가시(0.47μm):파랑
VI005 - 가시(0.51μm):초록
VI006 - 가시(0.64μm):빨강
VI008 - 가시(0.86μm):식생
NR013 - 근적외(1.37μm):권운
NR016 - 근적외(1.6μm):눈/얼음
SW038 - 단파적외(3.8μm):야간안개/하층운
WV063 - 수증기(6.3μm):상층 수증기
WV069 - 수증기(6.9μm):중층 수증기
WV073 - 수증기(7.3μm):하층 수증기
IR087 - 적외(8.7μm):구름상
IR096 - 적외(9.6μm):오존
IR105 - 적외(10.5μm):깨끗한 대기창
IR112 - 적외(11.2μm):대기창
IR123 - 적외(12.3μm):오염된 대기창
IR133 - 적외(13.3μm):이산화탄소

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

2. 천리안 2A호 기상산출물 조회

호출URL정보

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/CI/ELA/data?date=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE2/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE2/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

AMV-VI006-CD - 대기운동벡터(가시/0.64μm/구름표적)
AMV-SW038-CD - 대기운동벡터(단파적외/3.8μm/구름표적)
AMV-WV063-CS - 대기운동벡터(상층수증기/청천표적)
AMV-WV063-CD - 대기운동벡터(상층수증기/구름표적)
AMV-WV069-CS - 대기운동벡터(중층수증기/청천표적)
AMV-WV069-CD - 대기운동벡터(중층수증기/구름표적)
AMV-WV073-CS - 대기운동벡터(하층수증기/청천표적)
AMV-WV073-CD - 대기운동벡터(하층수증기/구름표적)
AMV-IR105-CD - 대기운동벡터(적외/10.5μm/구름표적)
AMV-IR112-CD - 대기운동벡터(적외/11.2μm/구름표적)
CLD - 구름탐지
CTPS - 운정산출물(운상, 운정온도/고도/기압)
CLA - 구름분석정보(운형, 위성운량, 지상운량, 구름층고도)
CTCLUST - 클러스터링기법 운형
DCOEW - 주간구름광학특성산출물(구름광학두께, 구름입자유효반경, 수적광학경로, 빙정광학경로)
NCOT - 주야간구름광학두께(적외채널기반)
CI - 대류운 발생 탐지
OT - 성층권 침투 대류운 탐지
FOG - 안개
ICING - 착빙
TFTD - 대류권계면 접힘 난류 탐지
RR - 강우강도
QPN - 초단기 강수예측(잠재강우량, 강우확률)
TQPROF - 연직온습도프로파일(온도, 비습, 상대습도)
TPW - 가강수량(총가강수량, 하층가강수량, 중층가강수량, 상층가강수량)
AII - 대기불안정도
ANN - 인공지능기반 대류가용잠재에너지(CAPE) 및 가강수량(TPW)
ADPS - 에어로졸 탐지 산출물(황사, 연무, 화산재 탐지)
APPS - 에어로졸 광학특성 산출물(에어로졸광학두께 @ 0.55 μm, 황사광학두께 @ 11 μm & @ 0.55 μm, 에어로졸입자크기지수(옹스트롱 지수)
AVIS - 에어로졸 시정
VAP - 화산재 산출물(고도/양)
TOZ - 총오존량
SO2D - 이산화황탐지
FF - 산불탐지
LST - 지표면온도
SAL - 지표면반사도
LSE - 지표면방출율
VGT - 식생정보(식생지수(NDVI), 식생률)
SCSI - 적설/해빙(10분 주기)
SD - 적설깊이
SSC - 해류
SST - 해수면온도(10분 주기)
RAD - 복사량
CSR - 청천복사량
SWRAD - 단파복사(지면 흡수단파복사, 지면 하향단파복사, 대기상한 상향단파복사)
LWRAD - 장파복사(지면 하향장파복사, 지면 상향장파복사, 대기상한 상향장파복사)

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/SO2D/KO/dataList?sDate=202210272350&eDate=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE2/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE2/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

AMV-VI006-CD - 대기운동벡터(가시/0.64μm/구름표적)
AMV-SW038-CD - 대기운동벡터(단파적외/3.8μm/구름표적)
AMV-WV063-CS - 대기운동벡터(상층수증기/청천표적)
AMV-WV063-CD - 대기운동벡터(상층수증기/구름표적)
AMV-WV069-CS - 대기운동벡터(중층수증기/청천표적)
AMV-WV069-CD - 대기운동벡터(중층수증기/구름표적)
AMV-WV073-CS - 대기운동벡터(하층수증기/청천표적)
AMV-WV073-CD - 대기운동벡터(하층수증기/구름표적)
AMV-IR105-CD - 대기운동벡터(적외/10.5μm/구름표적)
AMV-IR112-CD - 대기운동벡터(적외/11.2μm/구름표적)
CLD - 구름탐지
CTPS - 운정산출물(운상, 운정온도/고도/기압)
CLA - 구름분석정보(운형, 위성운량, 지상운량, 구름층고도)
CTCLUST - 클러스터링기법 운형
DCOEW - 주간구름광학특성산출물(구름광학두께, 구름입자유효반경, 수적광학경로, 빙정광학경로)
NCOT - 주야간구름광학두께(적외채널기반)
CI - 대류운 발생 탐지
OT - 성층권 침투 대류운 탐지
FOG - 안개
ICING - 착빙
TFTD - 대류권계면 접힘 난류 탐지
RR - 강우강도
QPN - 초단기 강수예측(잠재강우량, 강우확률)
TQPROF - 연직온습도프로파일(온도, 비습, 상대습도)
TPW - 가강수량(총가강수량, 하층가강수량, 중층가강수량, 상층가강수량)
AII - 대기불안정도
ANN - 인공지능기반 대류가용잠재에너지(CAPE) 및 가강수량(TPW)
ADPS - 에어로졸 탐지 산출물(황사, 연무, 화산재 탐지)
APPS - 에어로졸 광학특성 산출물(에어로졸광학두께 @ 0.55 μm, 황사광학두께 @ 11 μm & @ 0.55 μm, 에어로졸입자크기지수(옹스트롱 지수)
AVIS - 에어로졸 시정
VAP - 화산재 산출물(고도/양)
TOZ - 총오존량
SO2D - 이산화황탐지
FF - 산불탐지
LST - 지표면온도
SAL - 지표면반사도
LSE - 지표면방출율
VGT - 식생정보(식생지수(NDVI), 식생률)
SCSI - 적설/해빙(10분 주기)
SD - 적설깊이
SSC - 해류
SST - 해수면온도(10분 주기)
RAD - 복사량
CSR - 청천복사량
SWRAD - 단파복사(지면 흡수단파복사, 지면 하향단파복사, 대기상한 상향단파복사)
LWRAD - 장파복사(지면 하향장파복사, 지면 상향장파복사, 대기상한 상향장파복사)

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

다운로드

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/CLD/EA/image?date=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE2/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE2/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

AMV-VI006-CD - 대기운동벡터(가시/0.64μm/구름표적)
AMV-SW038-CD - 대기운동벡터(단파적외/3.8μm/구름표적)
AMV-WV063-CS - 대기운동벡터(상층수증기/청천표적)
AMV-WV063-CD - 대기운동벡터(상층수증기/구름표적)
AMV-WV069-CS - 대기운동벡터(중층수증기/청천표적)
AMV-WV069-CD - 대기운동벡터(중층수증기/구름표적)
AMV-WV073-CS - 대기운동벡터(하층수증기/청천표적)
AMV-WV073-CD - 대기운동벡터(하층수증기/구름표적)
AMV-IR105-CD - 대기운동벡터(적외/10.5μm/구름표적)
AMV-IR112-CD - 대기운동벡터(적외/11.2μm/구름표적)
CLD - 구름탐지
CTPS - 운정산출물(운상, 운정온도/고도/기압)
CLA - 구름분석정보(운형, 위성운량, 지상운량, 구름층고도)
CTCLUST - 클러스터링기법 운형
DCOEW - 주간구름광학특성산출물(구름광학두께, 구름입자유효반경, 수적광학경로, 빙정광학경로)
NCOT - 주야간구름광학두께(적외채널기반)
CI - 대류운 발생 탐지
OT - 성층권 침투 대류운 탐지
FOG - 안개
ICING - 착빙
TFTD - 대류권계면 접힘 난류 탐지
RR - 강우강도
QPN - 초단기 강수예측(잠재강우량, 강우확률)
TQPROF - 연직온습도프로파일(온도, 비습, 상대습도)
TPW - 가강수량(총가강수량, 하층가강수량, 중층가강수량, 상층가강수량)
AII - 대기불안정도
ANN - 인공지능기반 대류가용잠재에너지(CAPE) 및 가강수량(TPW)
ADPS - 에어로졸 탐지 산출물(황사, 연무, 화산재 탐지)
APPS - 에어로졸 광학특성 산출물(에어로졸광학두께 @ 0.55 μm, 황사광학두께 @ 11 μm & @ 0.55 μm, 에어로졸입자크기지수(옹스트롱 지수)
AVIS - 에어로졸 시정
VAP - 화산재 산출물(고도/양)
TOZ - 총오존량
SO2D - 이산화황탐지
FF - 산불탐지
LST - 지표면온도
SAL - 지표면반사도
LSE - 지표면방출율
VGT - 식생정보(식생지수(NDVI), 식생률)
SCSI - 적설/해빙(10분 주기)
SD - 적설깊이
SSC - 해류
SST - 해수면온도(10분 주기)
RAD - 복사량
CSR - 청천복사량
SWRAD - 단파복사(지면 흡수단파복사, 지면 하향단파복사, 대기상한 상향단파복사)
LWRAD - 장파복사(지면 하향장파복사, 지면 상향장파복사, 대기상한 상향장파복사)

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

자료조회

https://apihub.kma.go.kr/api/typ05/api/GK2A/LE2/RR/EA/imageList?sDate=202210272350&eDate=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path 의미

(다운로드)
/api/GK2A/LE2/{자료종류}/{영역}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LE2/{자료종류}/{영역}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

AMV-VI006-CD - 대기운동벡터(가시/0.64μm/구름표적)
AMV-SW038-CD - 대기운동벡터(단파적외/3.8μm/구름표적)
AMV-WV063-CS - 대기운동벡터(상층수증기/청천표적)
AMV-WV063-CD - 대기운동벡터(상층수증기/구름표적)
AMV-WV069-CS - 대기운동벡터(중층수증기/청천표적)
AMV-WV069-CD - 대기운동벡터(중층수증기/구름표적)
AMV-WV073-CS - 대기운동벡터(하층수증기/청천표적)
AMV-WV073-CD - 대기운동벡터(하층수증기/구름표적)
AMV-IR105-CD - 대기운동벡터(적외/10.5μm/구름표적)
AMV-IR112-CD - 대기운동벡터(적외/11.2μm/구름표적)
CLD - 구름탐지
CTPS - 운정산출물(운상, 운정온도/고도/기압)
CLA - 구름분석정보(운형, 위성운량, 지상운량, 구름층고도)
CTCLUST - 클러스터링기법 운형
DCOEW - 주간구름광학특성산출물(구름광학두께, 구름입자유효반경, 수적광학경로, 빙정광학경로)
NCOT - 주야간구름광학두께(적외채널기반)
CI - 대류운 발생 탐지
OT - 성층권 침투 대류운 탐지
FOG - 안개
ICING - 착빙
TFTD - 대류권계면 접힘 난류 탐지
RR - 강우강도
QPN - 초단기 강수예측(잠재강우량, 강우확률)
TQPROF - 연직온습도프로파일(온도, 비습, 상대습도)
TPW - 가강수량(총가강수량, 하층가강수량, 중층가강수량, 상층가강수량)
AII - 대기불안정도
ANN - 인공지능기반 대류가용잠재에너지(CAPE) 및 가강수량(TPW)
ADPS - 에어로졸 탐지 산출물(황사, 연무, 화산재 탐지)
APPS - 에어로졸 광학특성 산출물(에어로졸광학두께 @ 0.55 μm, 황사광학두께 @ 11 μm & @ 0.55 μm, 에어로졸입자크기지수(옹스트롱 지수)
AVIS - 에어로졸 시정
VAP - 화산재 산출물(고도/양)
TOZ - 총오존량
SO2D - 이산화황탐지
FF - 산불탐지
LST - 지표면온도
SAL - 지표면반사도
LSE - 지표면방출율
VGT - 식생정보(식생지수(NDVI), 식생률)
SCSI - 적설/해빙(10분 주기)
SD - 적설깊이
SSC - 해류
SST - 해수면온도(10분 주기)
RAD - 복사량
CSR - 청천복사량
SWRAD - 단파복사(지면 흡수단파복사, 지면 하향단파복사, 대기상한 상향단파복사)
LWRAD - 장파복사(지면 하향장파복사, 지면 상향장파복사, 대기상한 상향장파복사)

영역

관측 영역

FD - 전구
EA - 동아시아
ELA - 확장지역
KO - 한반도

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

3. 천리안 2A호 우주기상정보 조회

호출URL정보

다운로드

https://apihub.kma.go.kr/api/typ05/api/GK2A/LV1/PD-E-1M/NA/data?date=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path의미

(다운로드)
/api/GK2A/LV1/{자료종류}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LV1/{자료종류}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

PD-E-1M/NA - 전자 플럭스(1분 평균 자료)PD-E-5M/NA - 전자 플럭스(5분 평균 자료)PD-P-1M/NA - 양성자 플럭스(1분 평균 자료)PD-P-5M/NA - 양성자 플럭스(5분 평균 자료)MG-1M/NA - 자기장(1분 평균 자료)MG-5M/NA - 자기장(5분 평균 자료)CM-1M/NA - 위성체 내부대전량(1분 평균 자료)CM-5M/NA - 위성체 내부대전량(5분 평균 자료)

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

호출URL정보

자료조회

https://apihub.kma.go.kr/api/typ05/api/GK2A/LV1/PD-E-1M/NA/dataList?sDate=202210272350&eDate=202210272350&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

URL

Path의미

(다운로드)
/api/GK2A/LV1/{자료종류}/{자료형식}?date={요청시각}
(자료조회)
/api/GK2A/LV1/{자료종류}/{검색방식}?sDate={관측시작시간}&eDate={관측종료시간}&format={포맷}

자료종류

요청 자료 종류

PD-E-1M/NA - 전자 플럭스(1분 평균 자료)PD-E-5M/NA - 전자 플럭스(5분 평균 자료)PD-P-1M/NA - 양성자 플럭스(1분 평균 자료)PD-P-5M/NA - 양성자 플럭스(5분 평균 자료)MG-1M/NA - 자기장(1분 평균 자료)MG-5M/NA - 자기장(5분 평균 자료)CM-1M/NA - 위성체 내부대전량(1분 평균 자료)CM-5M/NA - 위성체 내부대전량(5분 평균 자료)

sDate

관측시작시간

조회 시작 시각, yyyymmddHHMM

eDate

관측종료시간

조회 종료 시각, yyyymmddHHMM

date

요청시각

다운로드 요청 파일 관측 시각, yyyymmddHHMM

format

포맷

조회 결과 파일 포맷(json, xml, text)

authKey

인증키

발급된 API 인증키

4. 천리안 2A 산불 관련(산불탐지, 산불위험도) 자료 조회

투영법, 기준점 참고자료

산불위험도 도움말(pdf) (API에서는 한반도영역만 제공) ※ 산불위험도 데이터는 `22.3.14. 이후부터 데이터 보유 참고자료

호출URL정보

텍스트

https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_txt?tm=202203140900&obs=fr&help=1&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm(공통)

기준시간(KST)

yyyymmddhhmm(년월일시분(KST)/ff(10분간격), fr(하루 1회(00UTC)))

obs(공통)

종류

ff(산불탐지), fr(산불위험도)

size(이미지)

이미지크기

기본:600px(이미지크기 설정)

help(텍스트)

자료도움말

경로, 격자 등 자료 도움말

tm

기준시간(UTC)

yyyymmddhhmm(년월일시분(UTC)/ff(10분간격), fr(하루 1회(00UTC)))

typ

종류

bin(nc파일), img(png이미지파일)

lvl

레벨

l2(산불탐지), l4(산불위험)

dat

자료

ff(산불탐지), fr(산불위험도)

are

영역(고정)

ko(한반도)

authKey

인증키

발급된 API 인증키

출력결과

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

설명자료

#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음

값

일사량(아래에서 위로, 왼쪽에서 오른쪽 순서로 값을 표출)

기준점

좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N
우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N
좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N
우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

호출URL정보

이미지

https://apihub.kma.go.kr/api/typ01/cgi-bin/sat/nph-sat_ana_img?obs=fr&tm=202203140900&size=600&sat=G&map=H1&xp=-9999&yp=-9999&zoom=1.3&scn=ko&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm(공통)

기준시간(KST)

yyyymmddhhmm(년월일시분(KST)/ff(10분간격), fr(하루 1회(00UTC)))

obs(공통)

종류

ff(산불탐지), fr(산불위험도)

size(이미지)

이미지크기

기본:600px(이미지크기 설정)

help(텍스트)

자료도움말

경로, 격자 등 자료 도움말

tm

기준시간(UTC)

yyyymmddhhmm(년월일시분(UTC)/ff(10분간격), fr(하루 1회(00UTC)))

typ

종류

bin(nc파일), img(png이미지파일)

lvl

레벨

l2(산불탐지), l4(산불위험)

dat

자료

ff(산불탐지), fr(산불위험도)

are

영역(고정)

ko(한반도)

authKey

인증키

발급된 API 인증키

출력결과

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

설명자료

#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음

값

일사량(아래에서 위로, 왼쪽에서 오른쪽 순서로 값을 표출)

기준점

좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N
우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N
좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N
우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

호출URL정보

이진 파일 다운로드(NetCDF)

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?lvl=l2&dat=ff&are=ko&tm=202101151000&typ=bin&authKey=-oe-oHSOQSKHvqB0juEieQ

이미지 파일 다운로드(png)

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?lvl=l4&dat=fr&are=ko&tm=202203140000&typ=img&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm(공통)

기준시간(KST)

yyyymmddhhmm(년월일시분(KST)/ff(10분간격), fr(하루 1회(00UTC)))

obs(공통)

종류

ff(산불탐지), fr(산불위험도)

size(이미지)

이미지크기

기본:600px(이미지크기 설정)

help(텍스트)

자료도움말

경로, 격자 등 자료 도움말

tm

기준시간(UTC)

yyyymmddhhmm(년월일시분(UTC)/ff(10분간격), fr(하루 1회(00UTC)))

typ

종류

bin(nc파일), img(png이미지파일)

lvl

레벨

l2(산불탐지), l4(산불위험)

dat

자료

ff(산불탐지), fr(산불위험도)

are

영역(고정)

ko(한반도)

authKey

인증키

발급된 API 인증키

출력결과

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

설명자료

#으로 시작하는 줄은 설명자료 표출이니 처리하지 않음

값

일사량(아래에서 위로, 왼쪽에서 오른쪽 순서로 값을 표출)

기준점

좌상단 경도 -899000m/113.996418E, 위도 899000m/45.728965N
우상단 경도 899000m/138.003582E, 위도 899000m/45.728965N
좌하단 경도 -899000m/116.753260E, 위도 -899000m/29.312252N
우하단 경도 899000m/135.246740E, 위도 -899000m/29.312252N

5. 천리안 2호 위성 데이터 파일 목록 조회

호출URL정보

천리안 2A호 목록

https://apihub.kma.go.kr/api/typ01/url/sat_file_list.php?sat=GK2A&vars=L1B&area=EA&fmt=bin&tm=20210815&size=Y&filter=nc&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm

년월일시(UTC)

관측일시

sat

위성종류

GK2A(천리안 2A호)

size

파일 크기

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

filter

포함여부

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

6. 천리안2A 이진 파일 다운로드

GK2A 레벨1 참고자료

호출URL정보

천리안2A 기본관측자료 이진 파일(NetCDF) 내려받기

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?typ=bin&lvl=l1b&are=ea&chn=vi004&tm=202101151000&authKey=-oe-oHSOQSKHvqB0juEieQ

천리안2A 기상산출물 이진 파일(NetCDF) 내려받기

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?typ=bin&lvl=l2&are=ko&dat=adps&tm=202301151000&authKey=-oe-oHSOQSKHvqB0juEieQ

천리안2A 기본관측자료 이미지 파일(PNG) 내려받기

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?typ=img&lvl=l1b&are=ea&chn=vi004&tm=202101150300&authKey=-oe-oHSOQSKHvqB0juEieQ

천리안2A 기상산출물 이미지 파일(PNG) 내려받기

https://apihub.kma.go.kr/api/typ01/url/sat_file_down2.php?typ=img&lvl=l2&are=ko&dat=adps&tm=202301151000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm

년월일시분(UTC)

관측 시간

lvl

레벨

L1B(레벨1B), L2(레벨2)

chn

L1B 채널번호

VI004(가시 파랑), VI005(가시 초록), VI006(가시 빨강), VI008(가시 식생),NR013(근적외 권운), NR016(근적외 눈/얼음), SW038(단파적외 야간안개/하층운), WV063(상층 수증기), WV069(중층 수증기), WV073(하층 수증기), IR087(적외 구름상), IR096(적외 오존), IR105(적외 깨끗한 대기창),IR112(적외 대기창), IR123(적외 오염된 대기창), IR133(적외 이산화탄소)

dat

L2 산출물

CLD(구름탐지), CTPS(운정산출물), CLA(구름분석정보), CTCLUST(클러스터링기법 운형)DCOEW(주간구름광학특성산출물), CI(대류운발생탐지), OT(성층권 침투대류운 탐지), FOG(안개)ICING(착빙), TFTD(대류권계면 접힘 난류 탐지), RR(강우강도), QPN(초단기 강수예측)TQPROF(연직온습도프로파일), TPW(가강수량), AII(대기불안정도),VAP(화산재 산출물)ANN(인공지능기반 대류가용잠재에너지), ADPS(에어로졸 탐지 산출물),TOZ(총오존량)APPS(에어로졸 광학특성 산출물), SO2D(이산화황탐지), FF(산불탐지),LST(지표면온도)SAL(지표면반사도), LSE(지표면방출율), VGT(식생정보), SCSI(적설/해빙),SD(적설깊이), SSC(해류)SST(해수면온도), RAD(복사량), CSR(청천복사량), SWRAD(단파복사),LWRAD(장파복사)

are

영역

EA(동아시아), ELA(동아시아 확장), FD(전구), KO(한반도), LA(지역관측/L1B), TP(태풍/L1B)

map

도법

LC(Lambert Conic), GE(GEOS)

authKey

인증키

발급된 API 인증키

7. 위성자료 기상산출물 경량화 조회

위성자료 기상산출물 경량화 조회 활용가이드 참고자료

위성자료 기상산출물 경량화 조회 격자 위경도 (행정구역코드) 참고자료

호출URL정보

천리안위성2A호 구름분석 행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aclaArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=ca&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

dongCode

동코드

동코드(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

value

값

호출URL정보

천리안위성2A호 주간구름산출물 행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2adcoewArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=cer&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

dongCode

동코드

동코드(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

천리안위성2A호 안개 행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2afogArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=fog&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

dongCode

동코드

동코드(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

value

값

호출URL정보

천리안위성2A호 에어로졸 산출물 행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aappsArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=aep&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

dongCode

동코드

동코드(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

value

값

호출URL정보

천리안위성2A호 구름탐지 행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2acldArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=cld&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

dongCode

동코드

동코드(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

value

값

호출URL정보

천리안위성2A호 구름분석 한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aclaAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=ca&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

value

값

호출URL정보

천리안위성2A호 주간구름 산출물 한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2adcoewAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=cer&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호 안개 한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2afogAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=fog&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

value

값

호출URL정보

천리안위성2A호 에어로졸 산출물 한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2aappsAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=202011290000&resultType=aep&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

데이터 타입

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

응답자료형식

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

value

값

호출URL정보

천리안위성2A호 구름탐지 한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/CloudSatlitInfoService/getGk2acldAll?pageNo=1&numOfRows=10&dataType=xml&dateTime=202011290000&resultType=cld&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

관측시간(참고 참조)

resultType

출력 변수

출력 변수(참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

value

값

8. 위성자료 기본 관측자료 경량화 조회

위성자료 기본관측자료 경량화 조회 활용가이드 참고자료

위성자료 기본관측자료 경량화 조회 격자 위경도 (행정구역코드) 참고자료

호출URL정보

천리안위성2A호적외한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aIrAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=087&unitType=R&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호근적외한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aNrAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=013&unitType=R&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호단파적외한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aSwAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=038&unitType=R&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호가시한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aViAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=004&unitType=R&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호수증기한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aWvAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=063&unitType=lat&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

gridKm

격자 크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

천리안위성2A호적외행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aIrArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=087&unitType=R&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

dongCode

동코드

동코드(첨부파일 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

천리안위성2A호근적외행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aNrArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=016&unitType=R&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

dongCode

동코드

동코드(첨부파일 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

천리안위성2A호단파적외행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aSwArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=038&unitType=R&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

dongCode

동코드

동코드(첨부파일 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

천리안위성2A호가시행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aViArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=004&unitType=R&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

dongCode

동코드

동코드(첨부파일 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

호출URL정보

천리안위성2A호수증기행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrSatlitInfoService/getGk2aWvArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&waveType=063&unitType=R&dongCode=1100000000&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

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

dateTime

관측시간

정시부터 2분간격 YYYYMMDDHHMM (2일 ~ 6시간 전까지 조회가능)

waveType

파장 타입

파장 타입 087, 096...(활용가이드 하단 참고 참조)

unitType

유닛 타입

유닛 타입 R, A, EBT, BT (활용가이드 하단 참고 참조)

dongCode

동코드

동코드(첨부파일 참조)

authKey

인증키

발급된 API 인증키

출력결과

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

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

9. (그래픽) 천리안 2A 분포도

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/sat/nph-gk2a_img?tm=202212221045&obs=ir105&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

tm

조회할 자료시각

obs

API종류

map

지도종류

grid

격자크기(km)

legend

범례 표시 여부

size

이미지 크기

itv

시간간격

gov

기관코드

authKey

인증키

발급된 API 인증키

10. (그래픽) 천리안 2A호 분포도 조회(배경지도 없음)

출력결과는 투영법, 이미지파일 위치 등이 JSON 포맷으로 표출됨 ※ url 이후 나오는 경로 앞에 https://apihub.kma.go.kr을 붙여서 사용

호출URL정보

천리안2A(IR2

https://apihub.kma.go.kr/api/typ03/cgi/sat/nph-gk2a_imgp?PROJ=LCC&cmp=SAT&obs=ir123&qcd=NQC&grid=2&itv=10&tm_mode=m10&data0=RCM&level=C&map=R&dtm=m0&zoom_level=0&zoom_rate=2&zoom_x=0000000&zoom_y=0000000&auto_man=a&mode=H&umove=10&fmove=2&dmove=180&bmove=10&winnum=0&rand=10&size=320&an_frn=1&an_itv=1&river=on&road=on&city=on&gis_auto=on&stnname=on&ctrl=0&dataDtlCd=rdr_rdr_sat_ir123_0&data1=r01&data2=rdr_sat_ir123&data3=0&overlay=spr&color=C4&effect=N&height=320&qpf=M&ef=&band1=ir123&legend=1&scn=ea&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307201700&tm_st=202307201700&tm_ed=202307201700&tm2=202307201700&authKey=-oe-oHSOQSKHvqB0juEieQ

요청인자

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

PROJ

경량화 PROJECT ID

cmp

HSR, HCI, PPI, CPP, CMX

obs

변수 구분 (예: ta)

STARTX

시작 X 좌표

STARTY

시작 Y 좌표

ENDX

종료 X 좌표

ENDY

종료 Y 좌표

ZOOMLVL

현재 줌 Level

tm

현재시각

tm_st

시작 시각

qcd

AWS3 QCD 자료

grid

격자크기(km)

itv

표출시간단위(분)

tm_mode

data0

자료종류

level

이미지 단계표

map

지도종류

dtm

시간이동단위 및 이동값

zoom_level

zoom_rate

확대율

zoom_x

X축 확대지역

zoom_y

Y축 확대지역

auto_man

자동여부

mode

표출양식

html(H), image(I), auto(A), file(F)

umove

최근 및 과거자료 찾기 위한 시간이동 간격(분)

fmove

최근 자료파일의 생성 지연 시각(분)

dmove

최근 자료파일을 찾기 위한 시간(분)

bmove

요청시간 직전의 자료파일을 찾기 위한 시간(분)

winnum

WINDOW 번호(for auto mode)

rand

난수

size

이미지크기(픽셀)

an_frn

동화 프레임수

an_itv

동화 시간간격(분)

river

road

city

gis_auto

stnname

지점명

ctrl

dataDtlCd

경량화 Layer Name

data1

변수종류

data2

변수종류

data3

변수종류

overlay

이미지 중첩

color

요청한 색상표

effect

이미지 효과

height

별도의 color level bar image height

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

ef

예측시간

legend

범례표시 여부

band1

천리안2A 관측채널&파장

scn

천리안2A 관측영역

authKey

인증키

발급된 API 인증키