# 해양관측 API 목록 (02-marine-obs) - 기상청 API허브

> 기상청 API허브 '해양관측' 분류의 API 22개 목록입니다. 항목마다 API 이름(명세 주소 연결), 요청 주소, 설명 순서로 적었습니다.
> 필요한 API 를 고른 뒤 연결된 명세(OpenAPI 3.0.3 yml)를 열면 요청 인자와 응답 형식을 볼 수 있습니다.

- 호출 방법·인증키 안내: https://apihub.kma.go.kr/llms.txt
- 모든 요청은 HTTP GET 이며 인증키를 `authKey` 쿼리 인자로 붙입니다.

## 01-marine-buoy / 01-marine-integrated-obs

- [해양 기상종합관측 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/01-marine-integrated-obs/01-marine-integrated-obs.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/sea_obs.php` - 해양기상부이·파고 부이·표류부이 등 해양관측 장비의 관측자료를 관측종류 구분과 함께 통합 조회하는 서비스
- [해양기상부이 기간 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/01-marine-integrated-obs/02-marine-buoy-period.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/kma_buoy2.php` - 지정한 기간의 해양기상부이 관측자료를 지점별로 조회하는 서비스

## 01-marine-buoy / 02-kma-buoy-data

- [해양기상부이 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/02-kma-buoy-data/01-marine-buoy.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/kma_buoy.php` - 해양기상부이가 관측한 바람·기압·습도·기온·수온·파고·파주기·파향을 지점별로 조회하는 서비스

## 01-marine-buoy / 03-marine-monthly-report

- [일러두기 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/01-notes.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getNote` - 해양 기상 월보의 일러두기(자료 이용 시 유의사항) 본문을 조회하는 서비스
- [지점 일람표(부이) 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/02-station-list-buoy.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyLstTbl` - 해양기상부이 관측지점의 위경도, 부이 형태 및 센서 설치 수심·높이를 조회하는 서비스
- [지점 일람표(등표) 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/03-station-list-lighthouse.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsLstTbl` - 등표 기상관측장비 관측지점의 위경도 및 센서 설치 수심·높이를 조회하는 서비스
- [지점 일람표(파고부이) 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/04-station-list-wave-buoy.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyLstTbl` - 파고부이 관측지점의 위경도 및 파고·수온 센서 수심을 조회하는 서비스
- [관측개시연도 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/05-obs-start-year.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getObsOpenYear` - 해양관측 지점별 관측 개시연도, 장비 교체 시기, 수심, 통신 방법, 관측 요소 및 관측 주기를 조회하는 서비스
- [해양기상부이 월요약자료 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/06-marine-buoy-monthly-summary.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyMmSumry` - 해양기상부이 지점별 월 요약자료(최대파고, 유의파고, 파주기)를 조회하는 서비스
- [해양기상부이 월요약자료(2) 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/07-marine-buoy-monthly-summary-2.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getBuoyMmSumry2` - 해양기상부이 지점별 월 요약자료를 조회하는 서비스(2)
- [일별(부이) 기상자료 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/08-daily-buoy-weather.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyBuoy` - 특정 해양기상부이 지점의 일별 기상자료(파고·파주기·풍속·기압·습도·기온·수온)를 조회하는 서비스
- [등표 기상관측장비 월요약자료 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/09-lighthouse-monthly-summary.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsMmSumry` - 등표 기상관측장비 지점별 월 요약자료(파고·파주기·수위)를 조회하는 서비스
- [등표 기상관측장비 월요약자료(2) 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/10-lighthouse-monthly-summary-2.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getLhawsMmSumry2` - 등표 기상관측장비 지점별 월 요약자료(바람·기압·기온·수온·습도)를 조회하는 서비스
- [일별(등표) 기상자료 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/11-daily-lighthouse-weather.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyLhaws` - 특정 등표기상관측장비 지점의 일별 기상자료(파고·파주기·수위·바람·기압·기온·수온)를 조회하는 서비스
- [파고부이 월요약자료 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/12-wave-buoy-monthly-summary.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyMmSumry` - 파고부이 지점별 월 요약자료(최대파고·유의파고·파주기)를 조회하는 서비스
- [파고부이 월요약자료(2) 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/13-wave-buoy-monthly-summary-2.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getWaveBuoyMmSumry2` - 파고부이 지점별 월 요약 수온자료를 조회하는 서비스
- [일별(파고부이) 기상자료 조회서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/03-marine-monthly-report/14-daily-wave-buoy-weather.yml) - `GET https://apihub.kma.go.kr/api/typ02/openApi/SeaMtlyInfoService/getDailyWaveBuoy` - 특정 파고부이 지점의 일별 기상자료(파고·파주기·수온)를 조회하는 서비스

## 01-marine-buoy / 04-marine-obs-spatial-dist

- [해양 파고 공간분포(경량화) 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/01-marine-buoy/04-marine-obs-spatial-dist/01-marine-wave-spatial-dist-light.yml) - `GET https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-sea_obs_imgp1` - 배경지도 없이 해양 파고의 공간분포 이미지를 생성하고, 투영법·이미지 파일 위치 등의 정보를 JSON으로 반환하는 서비스

## 02-lighthouse-obs / 01-lighthouse-data

- [기상청 등표 자료 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/02-lighthouse-obs/01-lighthouse-data/01-lighthouse-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/kma_lhaws.php` - 등표 기상관측장비가 관측한 바람·기온·기압·수온·파고·파주기·조위를 지점별로 조회하는 서비스
- [등표 기상관측 기간 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/02-lighthouse-obs/01-lighthouse-data/02-lighthouse-obs-period.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/kma_lhaws2.php` - 등표 기상관측장비가 관측한 바람·기온·기압·수온·파고·파주기·조위를 시작시각부터 종료시각까지 기간 단위로 조회하는 서비스

## 03-gisang1 / 01-gisang1-gisang2000-data

- [기상청 기상 1호/기상 2000호 자료 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/03-gisang1/01-gisang1-gisang2000-data/01-gisang1-gisang2000-data.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/kma_kship.php` - 기상관측선(기상 1호·기상 2000호)이 항해 중 관측한 위경도·바람·기온·기압·습도·강수·수온·파고·파주기·파향·일사·일조를 조회하는 서비스

## 04-marine-station-info / 01-marine-station-info

- [해양관측 지점정보 조회 서비스](https://apihub.kma.go.kr/specs/02-marine-obs/04-marine-station-info/01-marine-station-info/01-marine-station-info.yml) - `GET https://apihub.kma.go.kr/api/typ01/url/stn_inf.php` - 해양기상부이(BUOY) 관측지점의 지점번호·경위도·해발고도·지점명·예보구역 코드 등, 지점 메타정보를 조회하는 서비스
