1. Waypoint Season Average Data (Specific Year)
이 API는 WP의 계절별 해상 기상 데이터를 특정 연도의 평균값으로 제공합니다.
This API provides seasonal ocean weather data for a waypoint (WP) as averaged values for a specific year.
TRY OUT THIS ENDPOINT →
1.1 Request Parameter
{
"year": 2022,
"season" : "spring",
"pageNo" : 1,
"pageSize" : 10,
"coordinates": [
[150.5, 36],
[160, 36.5],
[160.5, 37],
[170, 37.5],
[170.5, 38],
[171, 38.5],
[171.5, 39],
[172, 39.5],
[172.5, 40],
[173, 40.5],
[173.5, 41],
[174, 41.5],
[174.5, 42]
]
}| Parameter | Description | Type |
|---|---|---|
year | Specific year to calculate seasonal average (e.g., 2022) | integer |
season | Season in English (Winter, Spring, Summer, Autumn) | string |
pageNo | Page number for paginated results | integer |
pageSize | Number of records per page | integer |
coordinates(2DArray) | Array of latitude/longitude pairs representing waypoints along a path | array |
1.2 API Response
{
"meta": {
"code": 200,
"message": "Ok",
"year": 2022,
"season": "spring",
"pageNo": 1,
"pageSize": 10,
"coordinates": [
[
150.5,
36.0
],
[
160.0,
36.5
],
[
160.5,
37.0
],
[
170.0,
37.5
],
[
170.5,
38.0
],
[
171.0,
38.5
],
[
171.5,
39.0
],
[
172.0,
39.5
],
[
172.5,
40.0
],
[
173.0,
40.5
],
[
173.5,
41.0
],
[
174.0,
41.5
],
[
174.5,
42.0
]
]
},
"data": [
{
"lat": 36.0,
"long": 150.5,
"totalWaveHeight": 2.59,
"totalWaveDirection": 188.46,
"totalWavePeriod": 6.67,
"windSpeed": 8.48,
"windDirection": 182.48,
"windWaveHeight": 1.91,
"windWaveDirection": 192.53,
"windWavePeriod": 7.14,
"swellWaveHeight": 1.34,
"swellWaveDirection": 143.85,
"swellWavePeriod": 9.46,
"pressureMsl": 1016.77,
"atmosphericTemperature": 14.69,
"seaSurfaceTemp": 17.03,
"visibility": 21556.2,
"currentSpeed": 0.46,
"currentDirection": 196.8
},
{
"lat": 36.5,
"long": 160.0,
"totalWaveHeight": 2.68,
"totalWaveDirection": 221.03,
"totalWavePeriod": 6.85,
"windSpeed": 8.72,
"windDirection": 196.32,
"windWaveHeight": 1.82,
"windWaveDirection": 215.1,
"windWavePeriod": 7.44,
"swellWaveHeight": 1.59,
"swellWaveDirection": 187.76,
"swellWavePeriod": 9.71,
"pressureMsl": 1018.59,
"atmosphericTemperature": 13.47,
"seaSurfaceTemp": 14.63,
"visibility": 22224.21,
"currentSpeed": 0.44,
"currentDirection": 117.27
},
{
"lat": 37.0,
"long": 160.5,
"totalWaveHeight": 2.73,
"totalWaveDirection": 220.1,
"totalWavePeriod": 6.88,
"windSpeed": 8.92,
"windDirection": 204.48,
"windWaveHeight": 1.87,
"windWaveDirection": 214.88,
"windWavePeriod": 7.41,
"swellWaveHeight": 1.56,
"swellWaveDirection": 192.84,
"swellWavePeriod": 9.86,
"pressureMsl": 1018.44,
"atmosphericTemperature": 12.96,
"seaSurfaceTemp": 14.46,
"visibility": 22389.2,
"currentSpeed": 0.33,
"currentDirection": 175.13
},
{
"lat": 37.5,
"long": 170.0,
"totalWaveHeight": 2.96,
"totalWaveDirection": 232.77,
"totalWavePeriod": 7.29,
"windSpeed": 9.11,
"windDirection": 205.04,
"windWaveHeight": 2.05,
"windWaveDirection": 236.82,
"windWavePeriod": 7.94,
"swellWaveHeight": 1.63,
"swellWaveDirection": 209.34,
"swellWavePeriod": 10.13,
"pressureMsl": 1019.0,
"atmosphericTemperature": 12.41,
"seaSurfaceTemp": 13.62,
"visibility": 22845.91,
"currentSpeed": 0.3,
"currentDirection": 136.35
},
{
"lat": 38.0,
"long": 170.5,
"totalWaveHeight": 3.03,
"totalWaveDirection": 234.76,
"totalWavePeriod": 7.3,
"windSpeed": 9.12,
"windDirection": 218.34,
"windWaveHeight": 2.07,
"windWaveDirection": 237.19,
"windWavePeriod": 7.99,
"swellWaveHeight": 1.66,
"swellWaveDirection": 207.35,
"swellWavePeriod": 10.23,
"pressureMsl": 1018.72,
"atmosphericTemperature": 11.95,
"seaSurfaceTemp": 13.55,
"visibility": 22785.38,
"currentSpeed": 0.29,
"currentDirection": 140.43
},
{
"lat": 38.5,
"long": 171.0,
"totalWaveHeight": 3.1,
"totalWaveDirection": 237.14,
"totalWavePeriod": 7.31,
"windSpeed": 9.43,
"windDirection": 221.04,
"windWaveHeight": 2.22,
"windWaveDirection": 242.06,
"windWavePeriod": 8.1,
"swellWaveHeight": 1.62,
"swellWaveDirection": 198.89,
"swellWavePeriod": 10.26,
"pressureMsl": 1018.29,
"atmosphericTemperature": 11.62,
"seaSurfaceTemp": 13.21,
"visibility": 22859.02,
"currentSpeed": 0.29,
"currentDirection": 172.37
},
{
"lat": 39.0,
"long": 171.5,
"totalWaveHeight": 3.17,
"totalWaveDirection": 239.35,
"totalWavePeriod": 7.32,
"windSpeed": 9.54,
"windDirection": 228.08,
"windWaveHeight": 2.19,
"windWaveDirection": 236.08,
"windWavePeriod": 8.18,
"swellWaveHeight": 1.67,
"swellWaveDirection": 192.93,
"swellWavePeriod": 10.25,
"pressureMsl": 1017.94,
"atmosphericTemperature": 11.2,
"seaSurfaceTemp": 12.6,
"visibility": 22939.41,
"currentSpeed": 0.28,
"currentDirection": 191.97
},
{
"lat": 39.5,
"long": 172.0,
"totalWaveHeight": 3.24,
"totalWaveDirection": 230.35,
"totalWavePeriod": 7.33,
"windSpeed": 9.75,
"windDirection": 220.11,
"windWaveHeight": 2.32,
"windWaveDirection": 231.31,
"windWavePeriod": 8.36,
"swellWaveHeight": 1.65,
"swellWaveDirection": 189.01,
"swellWavePeriod": 10.33,
"pressureMsl": 1017.54,
"atmosphericTemperature": 10.73,
"seaSurfaceTemp": 11.76,
"visibility": 23224.76,
"currentSpeed": 0.35,
"currentDirection": 166.52
},
{
"lat": 40.0,
"long": 172.5,
"totalWaveHeight": 3.29,
"totalWaveDirection": 231.97,
"totalWavePeriod": 7.34,
"windSpeed": 9.91,
"windDirection": 227.33,
"windWaveHeight": 2.38,
"windWaveDirection": 236.5,
"windWavePeriod": 8.38,
"swellWaveHeight": 1.67,
"swellWaveDirection": 185.39,
"swellWavePeriod": 10.35,
"pressureMsl": 1017.1,
"atmosphericTemperature": 10.18,
"seaSurfaceTemp": 11.39,
"visibility": 22726.07,
"currentSpeed": 0.29,
"currentDirection": 150.75
},
{
"lat": 40.5,
"long": 173.0,
"totalWaveHeight": 3.33,
"totalWaveDirection": 223.5,
"totalWavePeriod": 7.35,
"windSpeed": 10.04,
"windDirection": 229.56,
"windWaveHeight": 2.29,
"windWaveDirection": 224.78,
"windWavePeriod": 8.23,
"swellWaveHeight": 1.76,
"swellWaveDirection": 188.71,
"swellWavePeriod": 10.3,
"pressureMsl": 1016.65,
"atmosphericTemperature": 9.53,
"seaSurfaceTemp": 10.8,
"visibility": 22920.51,
"currentSpeed": 0.27,
"currentDirection": 138.6
}
]
}| Field | Description | Type |
|---|---|---|
meta > code | Response status code | integer |
meta > message | Response message | string |
meta > year | Requested year | integer |
meta > season | Requested season (Winter, Spring, Summer, Autumn) | string |
meta > pageNo | Current page number in paginated results | integer |
meta > pageSize | Number of records per page | integer |
meta > coordinates | Array of latitude/longitude waypoints used in the request | array |
data > lat | Latitude of the waypoint (ISO 6709 decimal degrees) | float |
data > long | Longitude of the waypoint (ISO 6709 decimal degrees) | float |
data > totalWaveHeight | Seasonal average total wave height | float (m) |
data > totalWaveDirection | Seasonal average total wave direction | float (degrees) |
data > windSpeed | Seasonal average wind speed | float (m/s) |
data > windDirection | Seasonal average wind direction | float (degrees) |
data > windWaveHeight | Seasonal average wind-generated wave height | float (m) |
data > windWavePeriod | Seasonal average wind-generated wave period | float (seconds) |
data > swellWaveHeight | Seasonal average swell wave height | float (m) |
data > swellWaveDirection | Seasonal average swell wave direction | float (degrees) |
data > swellWavePeriod | Seasonal average swell wave period | float (seconds) |
data > pressureMsl | Seasonal average mean sea level pressure | float (hPa) |
data > atmosphericTemperature | Seasonal average atmospheric temperature near sea level | float (°C) |
data > seaSurfaceTemp | Seasonal average sea surface temperature | float (°C) |
data > visibility | Seasonal average horizontal visibility | float (km) |
data > currentSpeed | Seasonal average ocean current speed | float (m/s) |
data > currentDirection | Seasonal average ocean current direction | float (degrees) |
2. Waypoint Season Average Data (Average Year)
이 API는 WP의 계절별 해상 기상 데이터를 입력한 연도만큼의 평균값으로 제공합니다.
This API provides seasonal ocean weather data for a waypoint (WP) as averaged values over the number of years specified.
TRY OUT THIS ENDPOINT →
1.1 Request Parameter
{
"averageYear": 1,
"season" : "spring",
"pageNo" : 1,
"pageSize" : 10,
"coordinates": [
[150.5, 36],
[160, 36.5],
[160.5, 37],
[170, 37.5],
[170.5, 38],
[171, 38.5],
[171.5, 39],
[172, 39.5],
[172.5, 40],
[173, 40.5],
[173.5, 41],
[174, 41.5],
[174.5, 42]
]
}| Parameter | Description | Type |
|---|---|---|
averageYear | Number of years to calculate average seasonal data (e.g., 1, 2, 3…) | integer |
season | Season in English (Winter, Spring, Summer, Autumn) | string |
pageNo | Page number for paginated results | integer |
pageSize | Number of records per page | integer |
coordinates(2DArray) | Array of latitude/longitude pairs representing waypoints along a path | array |
1.2 API Response
{
"meta": {
"code": 200,
"message": "Ok",
"averageYear": 1,
"season": "spring",
"pageNo": 1,
"pageSize": 10,
"coordinates": [
[
150.5,
36.0
],
[
160.0,
36.5
],
[
160.5,
37.0
],
[
170.0,
37.5
],
[
170.5,
38.0
],
[
171.0,
38.5
],
[
171.5,
39.0
],
[
172.0,
39.5
],
[
172.5,
40.0
],
[
173.0,
40.5
],
[
173.5,
41.0
],
[
174.0,
41.5
],
[
174.5,
42.0
]
]
},
"data": [
{
"lat": 36.0,
"long": 150.5,
"totalWaveHeight": 2.76,
"totalWaveDirection": 197.04,
"totalWavePeriod": 6.49,
"windSpeed": 8.81,
"windDirection": 212.2,
"windWaveHeight": 1.77,
"windWaveDirection": 199.42,
"windWavePeriod": 4.71,
"swellWaveHeight": 1.75,
"swellWaveDirection": 166.31,
"swellWavePeriod": 7.94,
"pressureMsl": 1016.04,
"atmosphericTemperature": 15.45,
"seaSurfaceTemp": 17.93,
"visibility": 17.95,
"currentSpeed": 0.26,
"currentDirection": 133.95
},
{
"lat": 36.5,
"long": 160.0,
"totalWaveHeight": 2.92,
"totalWaveDirection": 211.56,
"totalWavePeriod": 6.87,
"windSpeed": 8.57,
"windDirection": 207.21,
"windWaveHeight": 1.58,
"windWaveDirection": 215.39,
"windWavePeriod": 4.54,
"swellWaveHeight": 2.15,
"swellWaveDirection": 186.71,
"swellWavePeriod": 8.42,
"pressureMsl": 1018.53,
"atmosphericTemperature": 14.49,
"seaSurfaceTemp": 15.72,
"visibility": 19.01,
"currentSpeed": 0.42,
"currentDirection": 90.74
},
{
"lat": 37.0,
"long": 160.5,
"totalWaveHeight": 3.03,
"totalWaveDirection": 214.48,
"totalWavePeriod": 6.99,
"windSpeed": 8.95,
"windDirection": 209.92,
"windWaveHeight": 1.75,
"windWaveDirection": 215.8,
"windWavePeriod": 4.78,
"swellWaveHeight": 2.17,
"swellWaveDirection": 189.38,
"swellWavePeriod": 8.57,
"pressureMsl": 1018.35,
"atmosphericTemperature": 14.29,
"seaSurfaceTemp": 15.85,
"visibility": 18.56,
"currentSpeed": 0.47,
"currentDirection": 84.34
},
{
"lat": 37.5,
"long": 170.0,
"totalWaveHeight": 3.08,
"totalWaveDirection": 221.5,
"totalWavePeriod": 7.33,
"windSpeed": 8.64,
"windDirection": 203.26,
"windWaveHeight": 1.73,
"windWaveDirection": 213.18,
"windWavePeriod": 4.78,
"swellWaveHeight": 2.14,
"swellWaveDirection": 200.91,
"swellWavePeriod": 8.85,
"pressureMsl": 1020.53,
"atmosphericTemperature": 14.1,
"seaSurfaceTemp": 16.14,
"visibility": 20.54,
"currentSpeed": 0.33,
"currentDirection": 134.99
},
{
"lat": 38.0,
"long": 170.5,
"totalWaveHeight": 3.1,
"totalWaveDirection": 225.47,
"totalWavePeriod": 7.27,
"windSpeed": 8.78,
"windDirection": 208.98,
"windWaveHeight": 1.81,
"windWaveDirection": 215.57,
"windWavePeriod": 4.83,
"swellWaveHeight": 2.1,
"swellWaveDirection": 196.47,
"swellWavePeriod": 8.85,
"pressureMsl": 1020.31,
"atmosphericTemperature": 13.68,
"seaSurfaceTemp": 15.65,
"visibility": 19.84,
"currentSpeed": 0.52,
"currentDirection": 112.4
},
{
"lat": 38.5,
"long": 171.0,
"totalWaveHeight": 3.14,
"totalWaveDirection": 224.8,
"totalWavePeriod": 7.3,
"windSpeed": 8.87,
"windDirection": 208.19,
"windWaveHeight": 1.85,
"windWaveDirection": 216.01,
"windWavePeriod": 4.91,
"swellWaveHeight": 2.12,
"swellWaveDirection": 209.56,
"swellWavePeriod": 8.9,
"pressureMsl": 1020.09,
"atmosphericTemperature": 13.14,
"seaSurfaceTemp": 14.88,
"visibility": 19.35,
"currentSpeed": 0.28,
"currentDirection": 99.31
},
{
"lat": 39.0,
"long": 171.5,
"totalWaveHeight": 3.18,
"totalWaveDirection": 225.71,
"totalWavePeriod": 7.35,
"windSpeed": 8.96,
"windDirection": 208.4,
"windWaveHeight": 1.88,
"windWaveDirection": 214.91,
"windWavePeriod": 4.98,
"swellWaveHeight": 2.16,
"swellWaveDirection": 209.82,
"swellWavePeriod": 8.91,
"pressureMsl": 1019.87,
"atmosphericTemperature": 12.63,
"seaSurfaceTemp": 14.38,
"visibility": 18.73,
"currentSpeed": 0.26,
"currentDirection": 172.24
},
{
"lat": 39.5,
"long": 172.0,
"totalWaveHeight": 3.23,
"totalWaveDirection": 227.13,
"totalWavePeriod": 7.3,
"windSpeed": 8.96,
"windDirection": 206.94,
"windWaveHeight": 1.92,
"windWaveDirection": 214.59,
"windWavePeriod": 5.04,
"swellWaveHeight": 2.19,
"swellWaveDirection": 209.14,
"swellWavePeriod": 8.93,
"pressureMsl": 1019.7,
"atmosphericTemperature": 12.03,
"seaSurfaceTemp": 13.63,
"visibility": 18.43,
"currentSpeed": 0.21,
"currentDirection": 111.42
},
{
"lat": 40.0,
"long": 172.5,
"totalWaveHeight": 3.27,
"totalWaveDirection": 227.38,
"totalWavePeriod": 7.36,
"windSpeed": 9.09,
"windDirection": 205.38,
"windWaveHeight": 1.96,
"windWaveDirection": 213.28,
"windWavePeriod": 5.12,
"swellWaveHeight": 2.22,
"swellWaveDirection": 217.67,
"swellWavePeriod": 9.06,
"pressureMsl": 1019.49,
"atmosphericTemperature": 11.44,
"seaSurfaceTemp": 12.93,
"visibility": 18.52,
"currentSpeed": 0.2,
"currentDirection": 113.8
},
{
"lat": 40.5,
"long": 173.0,
"totalWaveHeight": 3.31,
"totalWaveDirection": 232.51,
"totalWavePeriod": 7.36,
"windSpeed": 9.37,
"windDirection": 209.79,
"windWaveHeight": 2.06,
"windWaveDirection": 213.71,
"windWavePeriod": 5.26,
"swellWaveHeight": 2.18,
"swellWaveDirection": 228.39,
"swellWavePeriod": 9.07,
"pressureMsl": 1019.21,
"atmosphericTemperature": 11.07,
"seaSurfaceTemp": 12.63,
"visibility": 18.41,
"currentSpeed": 0.21,
"currentDirection": 130.34
}
]
}| Field | Description | Type |
|---|---|---|
meta > code | Response status code | integer |
meta > message | Response message | string |
meta > averageYear | Requested year | integer |
meta > season | Requested season (Winter, Spring, Summer, Autumn) | string |
meta > pageNo | Current page number in paginated results | integer |
meta > pageSize | Number of records per page | integer |
meta > coordinates | Array of latitude/longitude waypoints used in the request | array |
data > lat | Latitude of the waypoint (ISO 6709 decimal degrees) | float |
data > long | Longitude of the waypoint (ISO 6709 decimal degrees) | float |
data > totalWaveHeight | Seasonal average total wave height | float (m) |
data > totalWaveDirection | Seasonal average total wave direction | float (degrees) |
data > windSpeed | Seasonal average wind speed | float (m/s) |
data > windDirection | Seasonal average wind direction | float (degrees) |
data > windWaveHeight | Seasonal average wind-generated wave height | float (m) |
data > windWavePeriod | Seasonal average wind-generated wave period | float (seconds) |
data > swellWaveHeight | Seasonal average swell wave height | float (m) |
data > swellWaveDirection | Seasonal average swell wave direction | float (degrees) |
data > swellWavePeriod | Seasonal average swell wave period | float (seconds) |
data > pressureMsl | Seasonal average mean sea level pressure | float (hPa) |
data > atmosphericTemperature | Seasonal average atmospheric temperature near sea level | float (°C) |
data > seaSurfaceTemp | Seasonal average sea surface temperature | float (°C) |
data > visibility | Seasonal average horizontal visibility | float (km) |
data > currentSpeed | Seasonal average ocean current speed | float (m/s) |
data > currentDirection | Seasonal average ocean current direction | float (degrees) |
3. Waypoint Average Data
이 API는 WP의 해상 기상 데이터를 입력한 연도만큼의 평균값으로 제공합니다.
This API provides ocean weather data for each waypoint (WP) as averaged values over the number of years specified.
TRY OUT THIS ENDPOINT →
1.1 Request Parameter
{
"averageYear": 2,
"pageNo" : 1,
"pageSize" : 5,
"coordinates": [
[150, 35.5]
]
}| Parameter | Description | Type |
|---|---|---|
averageYear | Number of years to calculate average data (e.g., 1, 2, 3…) | integer |
pageNo | Page number for paginated results | integer |
pageSize | Number of records per page | integer |
coordinates(2DArray) | Array of latitude/longitude pairs representing waypoints along a path | array |
1.2 API Response
{
"meta": {
"code": 200,
"message": "Ok",
"averageYear": 2,
"pageNo": 1,
"pageSize": 5,
"coordinates": [
[
150.0,
35.5
]
]
},
"data": [
{
"lat": 35.5,
"long": 150.0,
"totalWaveHeight": 2.79,
"totalWaveDirection": 196.06,
"totalWavePeriod": 6.72,
"windSpeed": 8.56,
"windDirection": 200.44,
"windWaveHeight": 1.75,
"windWaveDirection": 203.21,
"windWavePeriod": 4.72,
"swellWaveHeight": 1.82,
"swellWaveDirection": 184.28,
"swellWavePeriod": 7.83,
"pressureMsl": 1014.97,
"atmosphericTemperature": 18.97,
"seaSurfaceSalinity": 0.0,
"seaSurfaceTemp": 21.83,
"visibility": 241.67,
"currentSpeed": 0.38,
"currentDirection": 135.02
}
]
}| Field | Description | Type |
|---|---|---|
meta > code | Response status code | integer |
meta > message | Response message | string |
meta > averageYear | Requested year | integer |
meta > pageNo | Current page number in paginated results | integer |
meta > pageSize | Number of records per page | integer |
meta > coordinates | Array of latitude/longitude waypoints used in the request | array |
data > lat | Latitude of the waypoint (ISO 6709 decimal degrees) | float |
data > long | Longitude of the waypoint (ISO 6709 decimal degrees) | float |
data > totalWaveHeight | Seasonal average total wave height | float (m) |
data > totalWaveDirection | Seasonal average total wave direction | float (degrees) |
data > windSpeed | Seasonal average wind speed | float (m/s) |
data > windDirection | Seasonal average wind direction | float (degrees) |
data > windWaveHeight | Seasonal average wind-generated wave height | float (m) |
data > windWavePeriod | Seasonal average wind-generated wave period | float (seconds) |
data > swellWaveHeight | Seasonal average swell wave height | float (m) |
data > swellWaveDirection | Seasonal average swell wave direction | float (degrees) |
data > swellWavePeriod | Seasonal average swell wave period | float (seconds) |
data > pressureMsl | Seasonal average mean sea level pressure | float (hPa) |
data > atmosphericTemperature | Seasonal average atmospheric temperature near sea level | float (°C) |
data > seaSurfaceTemp | Seasonal average sea surface temperature | float (°C) |
data > visibility | Seasonal average horizontal visibility | float (km) |
data > currentSpeed | Seasonal average ocean current speed | float (m/s) |
data > currentDirection | Seasonal average ocean current direction | float (degrees) |