This API allows users to retrieve weather forecast information for a specific location using latitude and longitude coordinates. It enables real-time monitoring of weather conditions and access to forecast data.
Authentication
The Weather API uses Basic Authorization on Swagger UI.
Authentication Steps
1.
Click the [Authorize] button in the top right corner.
2.
Enter the provided username and password in the pop-up window.
3.
Click [Authorize] again to proceed with authentication.
4.
After successful login, click [Close] to close the window.
All API requests from Swagger UI will automatically include the authorization token.
Weather Forecast Request
Request URL
[GET] https://insight.seavantage.com/api/weather/forecast
Execution Steps
1.
2.
Navigate to the /weather/forecast endpoint.
3.
Click [Try it out] to activate input fields.
4.
Enter the required request parameter:
•
longitude
ex) 65.593025
•
latitude
ex) 23.55944333
5.
Click [Execute].
6.
View results in the response section.
Response Information
Sample Response Format
{
"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,
"swellHeight": 1.5,
"swellDirection": 270,
"swellPeriod": 80
}
]
}
JavaScript
복사
Response Field Descriptions
Top-Level Response Fields
Field | Example Value | Description |
code | 200 | Response status code (used in the same way as standard HTTP status codes).
See the list of codes below for reference. |
message | success | Response message (description based on status) |
error | false | Error flag
true: error occurred
false: successful processing |
timestamp | 2025-05-15T10:56:59.034880881 | Time of response creation (UTC) |
response | null or Object | Returns cargo data if found
Returns null if not found |
Response Codes
Code | Description |
201 | Success |
400 | Bad request |
401 | Unauthorized |
403 | Forbidden |
422 | Unprocessable entity |
429 | Too many requests |
Detailed Response Description
Depth 1 Field Description (response object)
Field | Example | Description | Data Type |
current_u | 10 | Horizontal ocean current (east to west) | double precision |
current_v | 12 | Vertical ocean current (north to south) | double precision |
dateTime | 2025-05-15T10:05:27.750Z | Timestamp | timestamp |
longitude | 123.456 | Longitude | double precision |
latitude | 12.345 | Latitude | double precision |
pressure | 1013.25 | Atmospheric pressure at sea level | double precision |
windSpeed | 10.5 | Wind speed at sea level | double precision |
windDirection | 180 | Wind direction at sea level (degrees) | double precision |
waterTemperature | 25 | Water temperature | double precision |
waveHeight | 2.5 | Wave height | double precision |
waveDirection | 90 | Wave direction (degrees) | double precision |
wavePeriod | 5 | Wave period | double precision |
currentSpeed | 1 | Current speed | double precision |
currentDirection | 180 | Current direction (degrees) | double precision |
swellHeight | 1.5 | Swell significant wave height | double precision |
swellDirection | 270 | Swell direction | double precision |
swellPeriod | 8 | Swell period | double precision |