이 API는 위도(latitude)와 경도(longitude)를 통해 해당 위치에 대한 기상 예보 정보를 조회할 수 있는 기능을 제공합니다. 이를 통해 기상 상태를 실시간으로 확인하고 예보 데이터를 수신할 수 있습니다.
인증 방법
Weather API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.
인증 절차는 다음과 같습니다:
1.
우측 상단의 [Authorize] 버튼을 클릭합니다.
2.
팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.
3.
입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.
4.
인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.
Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.
요청 정보
요청 정보
Request URL : [GET] https://insight.seavantage.com/api/weather/forecast
실행 순서
1.
Swagger 문서에서 우측 상단의 Select a definition 메뉴에서 Fleet을 선택합니다.
2.
/weather/forecast 경로로 이동합니다.
3.
[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.
4.
아래 요청 Parameters 조건에 따라 값을 입력합니다.
•
longitude: 위도
예시) 65.593025
•
latitude: 경도
예시) 23.55944333
5.
[Execute] 버튼을 클릭합니다.
6.
하단 응답 영역에서 등록 결과를 확인합니다.
응답 정보
응답 예시
{
"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
복사
응답 필드 상세 설명
응답 필드 정의
필드명 | 예시 값 | 설명 |
code | 200 | 응답 상태 코드 (HTTP status code와 동일하게 사용됨)
(아래 별도 응답 상태 코드표 참조) |
message | success | 응답 메시지 (상태에 따른 설명) |
error | false | 오류 여부
true: 오류 발생
false: 정상 처리 |
timestamp | 2025-05-15T10:56:59.034880881 | 응답 생성 시각 (UTC 기준) |
response | null 또는 Object | 화물 존재시 데이터 객체, 미존재시 null |
응답 코드 종류
코드 | 설명 |
201 | 정상 처리 (Created) |
400 | 잘못된 파라미터 (Bad request) |
401 | 인증 필요 (Unauthorized) |
403 | 권한 없음 (Forbidden) |
422 | 처리 불가 (Unprocessable entity) |
429 | 요청 과다 (Too many requests) |
응답 상세 설명
Depth 1 필드 설명 (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 | 해수면 풍향 (degrees) |
waterTemperature | 25 | 수온 |
waveHeight | 2.5 | 파도의 높이 |
waveDirection | 90 | 파도의 방향 (degrees) |
wavePeriod | 5 | 파도 주기 |
currentSpeed | 1 | 조류 속도 |
currentDirection | 180 | 조류 방향 (degrees) |