융합기상

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

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

체감온도