산업특화
산업분야에서 필요로하는 데이터를 묶음으로 제공합니다.
1. 지상관측데이터 일통계(일사, 일조, 구름, 기온, 습도) 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/url/sun_sfc_day.php?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
stn |
지점번호 |
해당 지점의 정보 표출 (0 이거나 없으면 전체지점) |
|
tm1 |
년월일(KST) |
기간: 시작일 (yyyymmdd / 없으면 현재시간) |
|
tm2 |
년월일(KST) |
기간: 종료일 (yyyymmdd / 없으면 현재시간) |
|
help |
도움말추가 |
1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음) |
|
disp |
표출 |
1(빈칸없는 CSV파일), 0(일정 간격) |
|
authKey |
인증키 |
발급된 API 인증키 |
2. 지상관측데이터 평년값(일조, 구름, 기온, 습도) 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/url/sun_sfc_norm.php?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
stn |
지점번호 |
해당 지점의 정보 표출 (0 이거나 없으면 전체지점) |
|
norm |
평년종류 |
D(일), S(순), M(월), Y(연) |
|
tmst |
평년기간 |
1991(1961~1990년), 2001(1971~2000년), 2011(1981~2010년), 2021(1991~2020년) |
|
MM1 |
시작 월 |
기간 : MM1월 DD1일 ~ MM2월 DD2일 |
|
DD1 |
시작 일 |
순별 평년값인 경우, 100(상순), 200(중순), 300(하순) |
|
MM2 |
종료 월 |
||
DD2 |
종료 일 |
||
authKey |
인증키 |
발급된 API 인증키 |
3. 관측-통계(일사, 일조) 묶음형 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sun_sfc_sts_pkg?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
stn |
지점번호 |
해당 지점의 정보 표출 (0 이거나 없으면 전체지점) |
|
tm1 |
년월일시분(KST) |
기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간) |
|
tm2 |
년월일시분(KST) |
기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간) |
|
mode |
자료종류 |
조회 자료 종류 (si:일조시간, ss:일사량) |
|
help |
도움말추가 |
1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음) |
|
disp |
표출 |
1(빈칸없는 CSV파일), 0(일정 간격) |
|
authKey |
인증키 |
발급된 API 인증키 |
4. 천리안2A호 인공지능 기반 일사량 데이터 지점 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_sat_ana_txt?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
tm1 |
년월일시분(UTC) |
기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간 / 30분 간격) |
|
tm2 |
년월일시분(UTC) |
기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간 / 30분 간격) |
|
int |
자료간격 |
읽어들일 생산시간 간격(분), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (30분 단위) |
|
lat |
위도 |
가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1) |
|
lon |
경도 |
가장 가까운 격자점 값을 사용 |
|
area |
|
행정구역 코드 |
입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1) |
authKey |
인증키 |
발급된 API 인증키 |
5. 천리안2A호 기상산출물(복사, 구름, 안개)지점 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_sat_txt?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
tm1 |
년월일시분(UTC) |
기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간) |
|
tm2 |
년월일시분(UTC) |
기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간) |
|
int |
자료간격 |
읽어들일 생산시간 간격(분), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (10분 단위) |
|
varn |
자료종류 |
조회 자료 종류 (ASR=지면 흡수단파복사, DSR=지면 하향단파복사, FOG=안개, CA=운량, CLL=구름층 고도, CT=운형) |
|
lat |
위도 |
가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1) |
|
lon |
경도 |
가장 가까운 격자점 값을 사용 |
|
area |
|
행정구역 코드 |
입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1) |
authKey |
인증키 |
발급된 API 인증키 |
6. 수치모델 데이터(복사, 기온, 구름, 강설) 지점 조회서비스
호출URL정보
생성 URL
https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_nwp_txt?authKey=h_qh_CRpRaK6ofwkaQWirQ
요청인자
| 인자명 | 입력 | 의미 | 설명 |
|---|---|---|---|
nwp |
모델 구분 |
UMG(UM-전구모델), KIMG(KIM-전구모델), KIMR(KIM-지역모델) |
|
varn |
자료종류 |
조회 자료 종류 (모델에 따라 선택 가능한 자료종류에 차이발생) |
|
tm |
발표시간(UTC) |
발표시간 (yyyymmdd / 6시간 간격) |
|
tmef1 |
발효시각(UTC) |
기간: 발표시각 기준 발효시간 시작점 (yyyymmddhhmm / 6시간 간격) |
|
tmef2 |
발효시각(UTC) |
기간: 발표시각 기준 발효시간 종료점 (yyyymmddhhmm / 6시간 간격) |
|
int |
자료간격 |
읽어들일 생산시간 간격(시간), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (3시간 단위) |
|
lat |
위도 |
가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1) |
|
lon |
경도 |
가장 가까운 격자점 값을 사용 |
|
area |
|
행정구역 코드 |
입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1) |
authKey |
인증키 |
발급된 API 인증키 |