해당 API는 위도(latitude)와 경도(longitude)를 기반으로 특정 위치의 기상 예보 정보를 제공합니다.
실시간 기상 상태, 해양 기후 지표, 풍속, 파고 등 다양한 데이터를 조회할 수 있으며,
항해 의사결정 및 해상 물류 계획 수립에 활용 가능합니다.
인증 방법
Swagger UI를 통해 Basic 인증 방식으로 인증을 진행합니다.
인증 절차
1.
Swagger 문서 접속
2.
우측 상단의 [Authorize] 클릭
3.
발급받은 아이디 / 비밀번호 입력
4.
[Authorize] 클릭 → 인증 완료
5.
[Close] 클릭하여 창 닫기
인증이 완료되면 Swagger UI에서 호출되는 모든 요청에 인증 토큰이 자동으로 포함됩니다.
기상 정보 조회 방법
1. 파라미터 입력
아래 항목을 입력합니다.
파라미터 | 설명 | 예시 값 |
longitude | 경도 | 65.593025 |
latitude | 위도 | 23.55944333 |
2. Swagger UI에서 실행
1.
상단 Select a definition 메뉴에서 Fleet 선택
2.
/weather/forecast 경로 클릭
3.
[Try it Out] 클릭 → 입력 필드 활성화
4.
파라미터 입력 후 [Execute] 클릭
5.
하단 응답 영역에서 결과 확인
응답 형식 예시
json
복사편집
{
"code": 200,
"message": "OK",
"error": false,
"timestamp": "2024-12-01T12:00:00",
"response": [
{
"current_u": 10,
"current_v": 12,
"dateTime": "2025-05-15T10:05:27.750Z",
"longitude": 123.456,
"latitude": 12.345,
"pressure": 1013.25,
"windSpeed": 10.5,
"windDirection": 180,
"waterTemperature": 25,
"waveHeight": 2.5,
"waveDirection": 90,
"wavePeriod": 5,
"currentSpeed": 1,
"currentDirection": 180
}
]
}
JSON
복사
주요 필드 설명
필드명 | 예시 값 | 설명 |
current_u | 10 | 동서 방향 해류 성분 |
current_v | 12 | 남북 방향 해류 성분 |
dateTime | 2025-05-15T10:05:27.750Z | 데이터 기준 시각 |
longitude | 123.456 | 위치의 경도 |
latitude | 12.345 | 위치의 위도 |
pressure | 1013.25 | 해수면 기압 (hPa) |
windSpeed | 10.5 | 풍속 (m/s 또는 kt) |
windDirection | 180 | 풍향 (도 단위) |
waterTemperature | 25 | 해수 온도 (°C) |
waveHeight | 2.5 | 파고 (m) |
waveDirection | 90 | 파향 (도 단위) |
wavePeriod | 5 | 파주기 (초) |
currentSpeed | 1 | 해류 속도 (m/s 또는 kt) |
currentDirection | 180 | 해류 방향 (도 단위) |
응답 코드 안내
코드 | 설명 |
200 | 요청이 정상적으로 처리되었습니다. |
201 | 리소스가 성공적으로 생성되었습니다. |
400 | 잘못된 요청입니다. |
401 | 인증이 필요합니다. |
403 | 접근 권한이 없습니다. |
422 | 요청은 이해되었으나 처리할 수 없습니다. |
429 | 요청 허용 횟수를 초과하였습니다. |