해양관측

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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=ArDk5uWmThKw5Oblpv4SFg

요청인자

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

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

인증키