기상청 API허브

융합기상

기상기후데이터와 에너지, 생활, 교통, 산업 등 타분야 데이터를 융합하거나, 융합에 특화된 데이터를 제공합니다.

1. 관광코스별 관광지 상세 날씨 조회

관광코스별 관광지 상세날씨 조회 지점 정보 참고자료

호출URL정보

시군구별관광기후지수조회

https://apihub.kma.go.kr/api/typ02/openApi/TourStnInfoService/getCityTourClmIdx?pageNo=1&numOfRows=10&dataType=XML&CURRENT_DATE=2018123110&DAY=3&CITY_AREA_ID=5013000000&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(XML/JSON)
CURRENT_DATE	현재시각	2016-12-01 01시부터 조회
HOUR	예보기간	CURRENT_DATE부터 24시간 후까지의 자료 호출 (#별첨2 참고)
COURSE_ID	코스ID	관광 코스ID
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
tm	예보시각	courseId	코스ID
courseAreaId	코스-지역아이디	courseAreaName	코스-지역이름
spotAreaId	관광지-지역아이디	spotAreaName	관광지-지역 이름
courseName	코스 명	spotName	관광지명
thema	테마	th3	일 3시간 기온
maxTa	최고기온	minTa	최저기온
wd	풍향	ws	풍속
sky	하늘상태	rhm	습도
pop	강수확률	rn	강수량

호출URL정보

동네예보조회

https://apihub.kma.go.kr/api/typ02/openApi/TourStnInfoService/getTourStnVilageFcst?pageNo=1&numOfRows=10&dataType=XML&CURRENT_DATE=2019122010&HOUR=24&COURSE_ID=1&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(XML/JSON)
CURRENT_DATE	현재시각	2016-12-01 01시부터 조회
HOUR	예보기간	CURRENT_DATE부터 24시간 후까지의 자료 호출 (#별첨2 참고)
COURSE_ID	코스ID	관광 코스ID
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
tm	예보시각	courseId	코스ID
courseAreaId	코스-지역아이디	courseAreaName	코스-지역이름
spotAreaId	관광지-지역아이디	spotAreaName	관광지-지역 이름
courseName	코스 명	spotName	관광지명
thema	테마	th3	일 3시간 기온
maxTa	최고기온	minTa	최저기온
wd	풍향	ws	풍속
sky	하늘상태	rhm	습도
pop	강수확률	rn	강수량

2. 작물별 농업주산지 상세날씨 조회

호출URL정보

주산지특보현황조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandPwn?pageNo=1&numOfRows=10&dataType=XML&CURRENT_TM=2019100516&AREA_ID=4122000000&PA_CROP_SPE_ID=PA130201&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
CURRENT_TM	현재 시각	현재 시각(YYYYMMDDHH)
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물병 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
tm	현재 시각	areaId	지역 아이디
areaName	지역 이름	paCropSpeId	작물별 특성 아이디
paCropName	작물 명	paCropSpeName	작물병 특성 이름
wrnCd	특보 코드

호출URL정보

주산지동네예보조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandVilageFcst?pageNo=1&numOfRows=10&dataType=XML&CURRENT_TM=2016120102&HOUR=24&AREA_ID=4122000000&PA_CROP_SPE_ID=PA130201&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
CURRENT_TM	현재 시각	2016-12-01 02시 부터 조회(YYYYMMDDHH)
HOUR	예보기간	예보기간
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물병 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
tm	현재 시각	areaId	지역 아이디
areaName	지역 이름	paCropSpeId	작물별 특성 아이디
paCropName	작물 명	paCropSpeName	작물병 특성 이름
pop	월 강수량	rhm	습도
sky	하늘상태	th3	3시간기온
wd	풍향	ws	풍속
maxTa	최고기온	minTa	최저기온
rn	강수량

호출URL정보

주산지동네예보실황조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getFmlandVilageNcst?pageNo=1&numOfRows=10&dataType=XML&CURRENT_TM=2016120102&AREA_ID=4122000000&PA_CROP_SPE_ID=PA130201&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
CURRENT_TM	현재 시각	현재시각(YYYYMMDDHH)
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물병 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
tm	현재 시각	areaId	지역 아이디
areaName	지역 이름	paCropSpeId	작물별 특성 아이디
paCropName	작물 명	paCropSpeName	작물병 특성 이름
ta	기온	rhm	습도
sky	하늘상태	ws	풍속
wd	풍향	pop	월 강수량
rn	강수량

호출URL정보

월통계조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getMmStatistics?pageNo=1&numOfRows=10&dataType=XML&ST_YM=201601&ED_YM=201601&AREA_ID=4211000000&PA_CROP_SPE_ID=PA020101&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
ST_YM	시작 연월	월통계 시작 연월(YYYYMM)
ED_YM	종료 연월	월통계 종료 연월(YYYYMM)
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물병 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
ym	연원	areaId	지역 아이디
areaName	지역 이름	paCropSpeId	작물별 특성 아이디
paCropName	작물 명	paCropSpeName	작물병 특성 이름
mnhAvgTa	월 평균기온	mnhMaxTa	월 최고기온
mnhMinTa	월 최저기온	mnhAvgRhm	월 평균상대습도
mnhMinRhm	월 최저상대 습도	mnhSumRn	월 강수량
mnhAvgWs	월 평균풍속	mnhSumSs	월 누적일조시간
wmCount	특보 발효 여부	wmCd	특보 코드

호출URL정보

순통계조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getPureStatistics?pageNo=1&numOfRows=10&dataType=XML&ST_YM=201601&ED_YM=201601&TDOM_CD=DB005001&AREA_ID=4211000000&PA_CROP_SPE_ID=PA020101&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
ST_YM	시작 연월	순통계 시작 연월(YYYYMM)
ED_YM	종료 연월	순통계 종료 연월(YYYYMM)
TDOM_CD	순코드	DB005001:초순 DB005002:중순 DB005003:하순
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물병 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
ym	연원	areaId	지역 아이디
areaName	지역 이름	paCropSpeId	작물별 특성 아이디
paCropName	작물 명	paCropSpeName	작물병 특성 이름
tdomAvgTa	순 평균기온	tdomMaxTa	순 최고기온
tdomMinTa	순 최저기온	tdomAvgRhm	순 평균상대습도
tdomCd	순코드	tdomMinRhm	순 최저상대 습도
tdomSumRn	순 강수량	tdomAvgWs	순 평균풍속
tdomSumSs	순 누적일조시간	wmCount	특보 발효 여부
wmCd	특보 코드

호출URL정보

일통계조회

https://apihub.kma.go.kr/api/typ02/openApi/FmlandWthrInfoService/getDayStatistics?pageNo=1&numOfRows=10&dataType=XML&ST_YMD=20161201&ED_YMD=20161201&AREA_ID=4122000000&PA_CROP_SPE_ID=PA130201&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
ST_YMD	시작 연월일	일통계 시작 날짜(YYYYMMDD)
ED_YMD	종료 연월일	일통계 종료 날짜(YYYYMMDD)
AREA_ID	지역 아이디	지역 아이디(활용가이드 하단첨부 참고)
PA_CROP_SPE_ID	작물별 특성 아이디	주산지 작물별 특성 아이디(활용가이드 하단첨부 참고)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
ymd	연원일	areaId	지역 아이디
areaName	지역 이름	paCropName	작물 명
paCropSpeId	작물별 특성아이디	paCropSpeName	작물별 특성 이름
dayAvgTa	일 평균기온	dayMaxTa	일 최고기온
dayMinTa	일 최저기온	dayAvgRhm	일 평균상대습도
dayMinRhm	일 최저상대습도	daySumRn	일 강수량
dayAvgWs	일 평균풍속	daySumSs	일 누적일조시간
wmCount	특보 발효 여부	wmCd	특보 코드

3. 해수욕장예보 조회

호출URL정보

해수욕장 초단기예보조회

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getUltraSrtFcstBeach?numOfRows=10&pageNo=1&dataType=JSON&base_date=20220622&base_time=1230&beach_num=1&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
baes_date	발표일자	22년6월22일 발표
base_time	발표시각	12시 30분
beach_num	해변코드	해변코드 1번
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachNum	해변코드	baseDate	발표일자
baseTime	발표시각	category	자료구분코드
fcstDate	예보일자	fcstTime	예보시간
fcstValue	예보 값	nx	X좌표
ny	Y좌표

호출URL정보

해수욕장 파고조회

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getWhBuoyBeach?numOfRows=1&pageNo=10&dataType=JSON&beach_num=1&searchTime=202205011600&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
beach_num	해변코드	해변코드
searchTime	관측시간(년월일시분)	년월일시분
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachnum	해변코드	tm	관측시간(년월일시분)
wh	파고

호출URL정보

해수욕장 조석정보

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getTideInfoBeach?numOfRows=1&pageNo=10&dataType=JSON&base_date=20220620&beach_num=1&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
base_date	발표일자	22년 6월 20일 발표
beach_num	해변코드	해변코드 1번
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachNum	해변코드	baseDate	발표일자
tiStnld	조석_지점명	tiTime	간만조 시간
tiType	간만조 구분	tilevel	간만조 수위

호출URL정보

해수욕장 일출일몰조회

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getSunInfoBeach?numOfRows=1&pageNo=10&dataType=JSON&Base_date=20220501&beach_num=1&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
Base_date	발표일자	22년 5월 1일 발표
beach_num	해변코드	해변코드 1번
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachNum	해변코드	baseDate	발표일자
sunrise	일출시각	sunset	일몰시각

호출URL정보

해수욕장 수온조회

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getTwBuoyBeach?numOfRows=1&pageNo=10&dataType=JSON&beach_num=1&searchTime=202205011600&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
beach_num	해변코드	해변코드
searchTime	관측시간(년월일시분)	년월일시분
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachNum	해변코드	tm	관측시간(년월일시분)
tw	수온

호출URL정보

해수욕장 단기예보조회

https://apihub.kma.go.kr/api/typ02/openApi/BeachInfoservice/getVilageFcstBeach?numOfRows=1&pageNo=10&dataType=JSON&base_date=20220622&base_time=1100&beach_num=1&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
numOfRows	한 페이지 결과 수	한 페이지 결과 수
pageNo	페이지 번호	페이지 번호
dataType	응답자료형식	요청자료형식(JSON)
base_date	발표일자	22년6월22일 발표
base_time	발표시각	11시 00분
beach_num	해변코드	해변코드 1번
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	데이터 총 개수	resultCode	응답메시지 코드
resultMsg	응답메시지 내용	dataType	데이터 타입
beachNum	해변코드	baseDate	발표일자
baseTime	발표시각	category	자료구분코드
fcstDate	예보일자	fcstTime	예보시간
fcstValue	예보 값	Nx	X좌표
ny	Y좌표

4. 서리발생 가능성 예측정보 조회

활용 가이드 참고자료

호출URL정보

서리발생예측정보조회

https://apihub.kma.go.kr/api/typ02/openApi/FrstFcstInfoService/getFrstOcurFcst?pageNo=1&numOfRows=10&dataType=XML&BASE_DATE=20170121&BASE_TIME=0500&LAT=36.5&LON=128.0&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
BASE_DATE	생성일자	‘17년01월21일 생성
BASE_TIME	생성시간	05시 생성
LAT	위도	36.5
LON	경도	128.0
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
BASE_DATE	생성일자	BASE_TIME	생성시간
FCST_DATE	예측일자	FCST_TIME	예측시간
DAY	선행일	VALUE	서리 발생 가능성(%)

5. 산악예보 조회

활용 가이드 참고자료

호출URL정보

https://apihub.kma.go.kr/api/typ08/getMountainWeather?mountainNum=5&base_date=20221125&base_time=1400&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
mountainNum	산 번호
base_date	일자
base_time	시각
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
mountainNum	산악예보 지점번호	baseDate	발표일자
baseTime	발표시각	category	자료 구분 코드
fcstDate	예보일자	fcstTime	에보시간
fcstValue	예보 값	nx	X좌표
ny	Y좌표

6. 전력기상지수 조회서비스

전력기상지수 설명자료 참고자료

호출URL정보

전력기상지수 조회

https://apihub.kma.go.kr/api/typ08/getPowerWeather?tm=202309260500&authKey=-oaVHnMzRGmGlR5zM5RpHA

요청인자

데이터 기본 정보
인자명	의미	설명
tm	발표시각	단기예보 발표시각 기준(YYYYMMDDHHMI) (02:00, 05:00, 08:00, 11:00, 14:00, 17:00, 20:00, 23:00)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
crtnTime	발표시각(KST)	fcstTime	예측시간(KST)
lat	위도	lon	경도
x	동네예보 격자 x좌표	y	동네예보 격자 y좌표
data	예측데이터	elec_idx	전력기상지수
senta_idx	체감온도