# 기상청_전국 해수욕장 날씨 조회서비스

전국 해수욕장의 날씨 예보(초단기예보/1시간 간격, 단기예보/3시간 간격)와 조석 정보, 파고 정보(해수욕장과 가장 근접한 해양관측장비 지점자료), 일출일몰 정보(해수욕장이 위치한 지점기준, 한국천문연구원 자료 활용), 수온 정보, 밀물과 썰물(해수욕장과 가장 근접한 조위소 기준, 국립해양조사원 자료 활용)를 제공하는 서비스 여름철 안전한 국민 여가생활 지원을 위해 전국 주요 해수욕장에 대해 날씨 서비스를 시행하며, 대상지점은 을왕리, 왕산, 하나개 , 민머루, 장경리, 옹암, 수기, 동막, 서포리, 십리포, 굴업, 떼뿌루, 밧지름, 한들, 큰풀안, 장골, 벌안 등 330여 곳입니다.

## 기본 정보

- 데이터 유형: 오픈API
- 식별자: 15102239
- 제공기관: 기상청
- 담당부서: 국가기후데이터센터
- 연락처: +82-42-481-7480
- 키워드: 예보, 해수욕장, 날씨, 바다, 해양
- 이용허락범위: [이용허락범위 제한 없음](<https://www.data.go.kr/ugs/selectPortalPolicyView.do>)
- 비용: 무료
- 등록일: 2022-07-12
- 수정일: 2025-12-15
- 데이터 형식: JSON+XML
- 분류체계: 문화체육관광 - 관광
- 제공형태: REST
- 업데이트 주기: 실시간
- 상세 페이지: https://www.data.go.kr/data/15102239/openapi.do

## 내려받기·호출 주소

- [JSON+XML](<https://apis.data.go.kr/1360000/BeachInfoservice>)

## 상세기능

### 1. 해수욕장 초단기예보조회

해수욕장 초단기예보조회 정보를 조회하기 위해 발표일자, 발표시각, 예보지점 해변코드의 조건으로 발표일자, 자료구분 코드, 예보값, 예보지점 예보 정보를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | 인증키 (URL Encode) | 인증키 |
|  | numOfRows |  | 옵 | 10 | 한 페이지 결과 수 |
|  | pageNo |  | 옵 | 1 | 페이지 번호 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | base_date |  | 필 | 20220622 | 발표일자 |
|  | base_time |  | 필 | 1230 | 발표시각 |
|  | beach_num |  | 필 | 1 | 해변코드 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

### 2. 해수욕장 파고조회

해수욕장 파고 실황정보를 조회하기 위해 해변코드, 관측시간의 조건으로 파고를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | - | 공공데이터포털에서 받은 인증키 |
|  | numOfRows |  | 옵 | 1 | 한 페이지 결과 수 |
|  | pageNo |  | 옵 | 10 | 페이지번호 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | beach_num |  | 필 | 1 | 해변코드 |
|  | searchTime |  | 필 | 202205011600 | 관측시간(년월일시분) |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

### 3. 해수욕장 조석정보

해수욕장 조석 정보를 조회하기 위해 발표일자, 해변코드의 조건으로 간만조(밀물, 썰물) 정보를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | - | 공공데이터포털에서 받은 인증키 |
|  | numOfRows |  | 옵 | 1 | 한 페이지 결과 수 |
|  | pageNo |  | 옵 | 10 | 페이지번호 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | base_date |  | 필 | 20220620 | 발표일자 |
|  | beach_num |  | 필 | 1 | 해변코드 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

### 4. 해수욕장 일출일몰조회

해수욕장 일출 일몰 정보를 조회하기 위해 발표일자, 해변코드의 조건으로 일출일몰 정보를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | - | 공공데이터포털에서 받은 인증키 |
|  | numOfRows |  | 옵 | 1 | 페이지번호한 페이지 결과 수 |
|  | pageNo |  | 옵 | 10 | 한 페이지 결과 수 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | Base_date |  | 필 | 20220501 | 발표일자 |
|  | beach_num |  | 필 | 1 | 해변코드 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

### 5. 해수욕장 수온조회

해수욕장 수온예보 정보를 조회하기 위해 해변코드, 관측시간의 조건으로 수온 정보를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | - | 공공데이터포털에서 받은 인증키 |
|  | numOfRows |  | 옵 | 1 | 한 페이지 결과 수 |
|  | pageNo |  | 옵 | 10 | 페이지번호 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | beach_num |  | 필 | 1 | 해변코드 |
|  | searchTime |  | 필 | 202205011600 | 관측시간(년월일시분) |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

### 6. 해수욕장 단기예보조회

해수욕장 단기예보조회 정보를 조회하기 위해 발표일자, 발표시각, 예보지점 해변코드의 조건으로 발표일자, 자료구분 코드, 예보값, 예보지점 예보 정보를 조회하는 기능

#### 요청변수

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | serviceKey |  | 필 | - | 공공데이터포털에서 받은 인증키 |
|  | numOfRows |  | 옵 | 1 | 한 페이지 결과 수 |
|  | pageNo |  | 옵 | 10 | 페이지번호 |
|  | dataType |  | 옵 | JSON | 응답자료형식 |
|  | base_date |  | 필 | 20220622 | 발표일자 |
|  | base_time |  | 필 | 1100 | 발표시각 |
|  | beach_num |  | 필 | 1 | 해변코드 |

#### 출력결과

| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
|  | header |  | 필 |  | header |
|  | body |  | 필 |  | body |

---

출처: 공공데이터포털 (https://www.data.go.kr) · 원문: https://www.data.go.kr/data/15102239/openapi.do
