기상청 API허브

해양관측

해양기상부이, 등표기상관측장비, 파고부이 등으로 관측한 파고, 파주기, 파향, 수온 등의 데이터를 제공합니다.

api 상세
개요	해양기상부이는 해수면에서 해양기상현상을 다양한 기상장비로 측정하고, 그 값을 일정한 물리량으로 변환 · 처리한 후에 위성 등 원격통신을 이용하여 관측 자료를 전송합니다. 파고부이는 해양기상부이보다 근해에 설치하여, 연안바다의 복잡한 지형에 의해 국지적으로 서로 달리 나타나는 파고를 관측하는 장비입니다. 파고, 파주기 관측의 경우는 해양기상부이와 마찬가지로 해수면에서 파고부이 몸체가 움직이는 가속도를 측정하여 분석합니다.
요 소	(해양기상부이) 기온, 바람, 기압, 습도, 파도 / (파고부이) 수온, 파도
지 점	(해양기상부이) 17지점 / (파고부이) 59지점
보유기간	(해양기상부이) 1996년 7월 ~ 현재(지점별 상이함)/ (파고부이) 2009년 1월 ~ 현재(지점별 상이함)
생산주기	매시 30분 및 정시(00분), 일 자료

1. 해양 종합 관측자료 조회

호출URL정보

해양기상종합관측(해양기상부이·파고부이·표류부이 등)

https://apihub.kma.go.kr/api/typ01/url/sea_obs.php?tm=202301241200&stn=0&help=1&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
tm	년월일시분(KST)	요청한 시간에서 가장 가까운 생산시각의 자료를 표출 (없으면 현재시간기준)
stn	지점번호	해당 지점의 정보 표출 (0 이거나 없으면 전체지점)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
TP	관측종류	STN_ID	지점 ID
STN_KO	지점명	TM	관측시각(KST, 년월일시분)
WH	유의파고 (m)	WD	풍향 (degree)
WS	풍속 (m/s)	WS_GST	GUST 풍속 (m/s)
TW	해수면 온도 (C)	TA	기온 (C)
PA	해면기압 (hPa)	HM	상대습도 (%)

호출URL정보

해양기상부이(기간조회)

https://apihub.kma.go.kr/api/typ01/url/kma_buoy2.php?tm1=202307231200&tm2=202307241200&stn=0&help=1&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
tm1	기간조회 시작시각	년월일시분(KST)
tm2	기간조회 종료시각	년월일시분(KST)
stn	지점번호	해당 지점의 정보 표출 (0 이거나 없으면 전체지점)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

2. 기상청 부이자료 조회

호출URL정보

해양기상부이

https://apihub.kma.go.kr/api/typ01/url/kma_buoy.php?tm=202301241200&stn=0&help=1&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
tm	년월일시분(KST)	시간 (없으면 현재시간)
stn	지점번호	해당 지점의 정보 표출 (0 이거나 없으면 전체지점)
help	도움말	1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
TM	관측시간 (KST)	STN	BUOY 지점 ID
WD1	센서1의 풍향 (degree)	WS1	센서1의 풍속 (m/s)
WS1_GST	센서1의 GUST 풍속 (m/s)	WD2	센서2의 풍향 (degree)
WS2	센서2의 풍속 (m/s)	WS2_GST	센서2의 GUST 풍속 (m/s)
PA	해면기압 (hPa)	HM	상대습도 (%)
TA	기온 (C)	TW	해수면 온도 (C)
WH_MAX	최대파고 (m)	WH_SIG	유의파고 (m)
WH_AVE	평균파고 (m)	WP	파주기 (sec)
WO	파향 (degree)

3. 해양기상월보 조회

호출URL정보

일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
note	일러두기

호출URL정보

지점일람표(부이)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역코드	stn_ko	지역명(국문)
stn_en	지역명(영문)	lat	북위
lon	동경	form	부이 형태
ht_wh	파고센서 수심	ht_ta	온.습도계 높이
ht_pa	기압계 높이	ht_wd	풍향.풍속계 높이
ht_tw	수온센서 수심

호출URL정보

지점일람표(등표)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역코드	stn_ko	지역명(국문)
stn_en	지역명(영문)	lat	북위
lon	동경	ht_wh	파고센서 수심
ht_ta	온.습도계 높이	ht_pa	기압계 높이
ht_wd	풍향.풍속계 높이	ht_tw	수온센서 수심

호출URL정보

지점일람표(파고부이)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역코드	stn_ko	지역명(국문)
stn_en	지역명(영문)	lat	북위
lon	동경	ht_wh	파고센서 수심
ht_tw	수온센서 수심

호출URL정보

관측개시연도조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getObsOpenYear?pageNo=1&numOfRows=10&dataType=XML&year=2017&month=02&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역코드	stn_ko	지역명(국문)
stn_en	지역명(영문)	obs_start_year	관측 개시
replacement_year	교체 시기	water_depth	수심
telemetry	통신방법	obs_element	관측요소
obs_interval	관측주기	stn_id	지점번호
stn_ko	지점 명(국문)	stn_en	지점 명(영문)
obs_start_year	관측 개시	replacement_year	교체 시기
water_depth	해발고도	telemetry	통신방법
obs_element	관측요소	obs_interval	관측주기
stn_id	지점 번호	stn_ko	지점 명(국문)
stn_en	지점 명(영문)	obs_start_year	관측 개시
replacement_year	교체 시기	water_depth	수심
telemetry	통신방법	obs_element	관측요소
obs_interval	관측주기

호출URL정보

해양기상부이월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역번호	stn_ko	관측 지점명(국문)
va_val_02	최대파고 최대	va_val_03	최대파고 나타난 날
va_val_04	3.0M 이상 최대파고 일수	va_val_05	5.0M 이상 최대파고 일수
va_val_06	평균 유의파고	va_val_11	파주기 평균
va_val_12	파주기 최대	va_val_13	파주기

호출URL정보

해양기상부이월요약자료(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyMmSumry2?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역번호	stn_ko	관측 지점명(국문)
va_val_02	최대파고 최대	va_val_03	최대파고 나타난 날
va_val_04	3.0M 이상 최대파고 일수	va_val_05	5.0M 이상 최대파고 일수
va_val_06	평균 유의파고	va_val_11	파주기 평균
va_val_12	파주기 최대	va_val_13	파주기 나타난날

호출URL정보

일별(부이)기상자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyBuoy?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=22101&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
station	지점번호	지점번호
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역번호	stn_ko	관측 지점명(국문)
stn_en	관측 지점명(영문)	tm	날짜
wh_sig	유의파고 평균	wh_max_	최대파고 최고
wh_max_hh	최대파고 시간	wp	파주기 평균
wp_	파주기 최고	ws	평균풍속
pa	평균 현지기압	hm	평균습도
Z	평균기온	tw	평균수온

호출URL정보

등표기상관측장비월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역번호	stn_ko	관측 지점명(국문)
va_val_02	최대파고 최대	va_val_03	최대파고 나타난 날
va_val_04	3.0M 이상 최대파고 일수	va_val_05	5.0M 이상 최대파고 일수
va_val_06	평균 유의파고	va_val_11	평균 파주기
va_val_12	최대 파주기	va_val_13	파주기 나타난 날
va_val_14	수위 평균	va_val_15	수위 최대
va_val_16	수온 나타난 날

호출URL정보

등표기상관측장비월요약자료(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsMmSumry2?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지역번호	stn_ko	관측 지점명(국문)
Va_val_01	바람 평균풍속	va_val_02	최대순간 풍속
va_val_03	최대순간 풍향	va_val_04	최대순간 나타난 날
va_val_05	평균해면기압	va_val_06	기온 평균
va_val_07	기온 일 최고	va_val_08	기온 나타난 날
va_val_09	기온 일 최저	va_val_10	기온 나타난 날
va_val_11	수온 평균	va_val_12	수온 일평균최고
va_val_13	일평균최고수온 나타난	va_val_14	일평균최저 수온 일최저
va_val_15	일평균최저 수온 나타난 날	va_val_16	평균습도

호출URL정보

일별(등표)기상자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyLhaws?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=955&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
station	지점번호	’지점번호’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지점번호	stn_ko	관측 지점명(국문)
stn_en	관측 지점명(영문)	tm	날짜
wh_sig	평균 유의파고	wh_max_	최대파고 최고
wh_max_hh	최대파고 시간	wp	파주기 평균
wp_	파주기 최고	ls	수위 평균
ls_	수위 최고	ws	바람 평균 풍속
gt	최대순간 풍속	gt_wd	최대순간 풍향
pa	평균 해면기압	ta	기온 평균
ta_	기온 최고	ta__	기온 최저
tw	평균수온	tw_	평균습도

호출URL정보

파고부이월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지점번호	stn_ko	관측 지점명(국문)
va_val_02	최대파고 최대	va_val_03	최대파고 나타난 날
va_val_04	최대파고 일수 3.0m 이상	va_val_05	최대파고 일수 5.0m 이상
va_val_06	유의파고 평균	va_val_11	파주기 평균
va_val_12	파주기 최대	va_val_13	파주기 나타난 날

호출URL정보

파고부이월요약자료(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyMmSumry2?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지점번호	stn_ko	관측 지점명(국문)
va_val_12	수온 평균	va_val_13	수온 일 평균최고
va_val_14	수온 나타난 날	va_val_15	수온 일평균최저
va_val_16	수온 나타난 날

호출URL정보

일별(파고부이)기상자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyWaveBuoy?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=22441&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
pageNo	페이지 번호	페이지번호
numOfRows	한 페이지 결과 수	한 페이지 결과 수
dataType	응답자료형식	요청자료형식(XML/JSON)Default: XML
year	발표년도	‘2016년 발표’
month	발표월	‘16년 09월 발표’
station	지점번호	’지점번호’
authKey	인증키	발급된 API 인증키

출력결과

출력결과
변수명	의미(단위)	변수명	의미(단위)
resultCode	결과코드	resultMsg	결과메시지
numOfRows	한 페이지 결과 수	pageNo	페이지 번호
totalCount	전체 결과 수	dataType	데이터 타입
stn_id	지점번호	stn_ko	지점명(국문)
stn_en	지점명(영문)	tm	날짜
wh_sig	유의파고 평균	wh_max_	최대파고 최고
wh_max_hh	최대파고 시간	wp	파주기 평균
wp_	파주기 최고	tw	평균수온

4. (그래픽) 해양관측 공간분포 조회(배경지도 없음)

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

호출URL정보

해양:파고

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-sea_obs_imgp1?authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명	의미	설명
PROJ	경량화 PROJECT ID
STARTX	시작 X 좌표
STARTY	시작 Y 좌표
ENDX	종료 X 좌표
ENDY	종료 Y 좌표
ZOOMLVL	현재 줌 Level
tm	현재시각
tm_st	시작 시각
map	지도종류
grid	격자크기	km
itv	분석간격	분
dataDtlCd	경량화 Layer Name
obs	변수 구분	예: ta
stn	지점정보	0:최대최소값만, 1:영역내 지점값 포함, 2:지점값만 객관분석없음
size	이미지크기	픽셀
selWs	풍속단위	kh: km/h, ms: m/s
authKey	인증키