One Point

1. One Point Data

이 API는 단일 좌표에 대해 특정 시간의 해상 기상 데이터를 제공합니다.

해당 좌표의 풍향, 풍속, 파고, 파향 등의 정보를 확인할 수 있습니다.

This API provides marine weather data for a specific point at a specific time.

User can check information such as wind direction, wind speed, wave height, and wave direction for the given coordinates.

TRY OUT THIS ENDPOINT →

1.1 Request Parameter

GET v1/oceanweather?dateTime=2023-07-01T00:00:00Z&lat=35.5&long=124

Parameter	Description	Type
`dateTime`	Datetime (UTC) of the requested weather data	string (ISO 8601 format)
`lat`	Latitude of the requested location	(float) ISO 6709 (decimal point)
`lon`	Longitude of the requested location	(float) ISO 6709 (decimal point)

1.2 API Response

{
    "meta": {
        "code": 200,
        "time": "2023-07-01T00:00:00Z",
        "lat": 35.5,
        "long": 124.0
    },
    "oceanWeather": {
        "utc": "2023-07-01T00:00:00Z",
        "lat": 35.5,
        "long": 124.0,
        "windSpeed": 3.85,
        "windDirection": 27.9,
        "atmosphericTemperature": 22.8,
        "pressureSeaLevel": 1006,
        "visibility": 16.2,
        "totalWaveHeight": 1.2,
        "totalWaveDirection": 170.2,
        "totalWavePeriod": 5.8,
        "windWaveHeight": 0.2,
        "windWaveDirection": 359.9,
        "windWavePeriod": 2.4,
        "swellWaveHeight": 1.1,
        "swellWaveDirection": 166.2,
        "swellWavePeriod": 5.9,
        "seaSurfaceTemp": 22.8,
        "currentSpeed": 0.28,
        "currentDirection": 135.0,
        "beaufortScale": 3
    }
}

Field	Description	Unit
`meta` > `code`	Response Code	integer
`meta` > `time`	Requested Time of weather Data	datetime
`meta` > `lat`	Requetsed Latitude	(float) ISO 6709 (decimal point)
`meta` > `long`	Requetsed Longitude	(float) ISO 6709 (decimal point)
`ocean weather` > `utc`	Response time	datetime
`ocean weather` > `lat`	Response Latitude	(float) ISO 6709 (decimal point)
`ocean weather` > `long`	Response Longitude	(float) ISO 6709 (decimal point)
`ocean weather` > `windSpeed`	Wind Speed at the specified location	(float) ISO 6709 (decimal point), m/s
`ocean weather` > `windDirection`	Wind direction at the specified location	(float) ISO 6709 (decimal point), degrees
`ocean weather` > `atmosphericTemperature`	Atomospheric temperature near sea level	(float) ISO 6709 (decimal point), °C
`ocean weather` > `pressureSeaLevel`	Sea level atmospheric pressure	(float) ISO 6709 (decimal point)
`ocean weather` > `visibility`	visibility at the specified location	(float) ISO 6709 (decimal point), km
`ocean weather` > `totalWaveHeight`	Height of the combined wind and swell waves	(float) ISO 6709 (decimal point), m
`ocean weather` > `totalWaveDirection`	Direction of the combined wave system	(float) ISO 6709 (decimal point), degrees
`ocean weather` > `totalWavePeriod`	Period of the combined wave system	(float) ISO 6709 (decimal point)
`ocean weather` > `windWaveHeight`	Height of wind-generated waves only	(float) ISO 6709 (decimal point)
`ocean weather` > `windWaveDirection`	Direction of wind-generated waves	(float) ISO 6709 (decimal point)
`ocean weather` > `windWavePeriod`	Period of wind-generated waves	(float) ISO 6709 (decimal point)
`ocean weather` > `swellWaveHeight`	Height of swell waves	(float) ISO 6709 (decimal point)
`ocean weather` > `swellWaveDirection`	Direction of swell waves	(float) ISO 6709 (decimal point)
`ocean weather` > `swellWavePeriod`	Period of swell waves	(float) ISO 6709 (decimal point)
`ocean weather` > `seaSurfaceTemp`	Sea surface temparature	(float) ISO 6709 (decimal point), °C
`ocean weather` > `currentSpeed`	Ocean current speed	(float) ISO 6709 (decimal point), m/s
`ocean weather` > `currentDirection`	Ocean current direction	(float) ISO 6709 (decimal point), degrees
`ocean weather` > `beaufortScale`	Wind force scale based on Beaufort system (0-12)	integer

2. One Point Average Data

이 API는 단일 좌표의 해상 기상 정보에 대해 설정한 연도만큼의 평균값을 제공합니다.

averageYear는 최소 1년부터 입력하여 조회 가능합니다.

This API provides the annual average of ocean weather data for a specific point.

The averageYear parameter must be set to at least 1 year or more.

TRY OUT THIS ENDPOINT →

1.1 Request Parameter

GET v1/oceanweather/avg?lat=35.5&long=124&averageYear=2

Parameter	Description	Type
`lat`	Latitude requested for weather data	float
`long`	Longitude requested for weather data	float
`averageYear`	Number of years to calculate the average (e.g., 1 = one year, 2 = two years)	integer

1.2 API Response

{
    "meta": {
        "code": 200,
        "message": "Ok",
        "lat": 35.5,
        "long": 124.0,
        "averageYear": 2
    },
    "data": {
        "startDateTimeUTC": "2023-08-20T00:00:00Z",
        "endDateTimeUTC": "2025-08-20T00:00:00Z",
        "totalWaveHeight": 1.2,
        "totalWaveDirection": 206.75,
        "totalWavePeriod": 4.32,
        "windSpeed": 6.5,
        "windDirection": 191.68,
        "windWaveHeight": 0.94,
        "windWaveDirection": 209.46,
        "windWavePeriod": 3.41,
        "swellWaveHeight": 0.53,
        "swellWaveDirection": 191.4,
        "swellWavePeriod": 5.39,
        "pressureMsl": 1016.89,
        "atmosphericTemperature": 15.39,
        "seaSurfaceTemp": 18.0,
        "visibility": 347.44,
        "currentSpeed": 0.25,
        "currentDirection": 151.68
    }
}

Field	Description	Unit
`meta` > `code`	Response status code	integer
`meta` > `message`	Response message	string
`meta` > `lat`	Requested latitude	float (ISO 6709 decimal degrees)
`meta` > `long`	Requested longitude	float (ISO 6709 decimal degrees)
`meta` > `averageYear`	Number of years to calculate the average (e.g., 1 = one year, 2 = two years)	integer (years)
`data` > `startDateTimeUTC`	Start datetime (UTC) of the averaged data	datetime
`data` > `endDateTimeUTC`	End datetime (UTC) of the averaged data	datetime
`data` > `totalWaveHeight`	Average total wave height	float (m)
`data` > `totalWaveDirection`	Average total wave direction	float (degrees)
`data` > `totalWavePeriod`	Average total wave period	float (seconds)
`data` > `windSpeed`	Average wind speed	float (m/s)
`data` > `windDirection`	Average wind direction	float (degrees)
`data` > `windWaveHeight`	Average wind wave height	float (m)
`data` > `windWaveDirection`	Average wind wave direction	float (degrees)
`data` > `windWavePeriod`	Average wind wave period	float (seconds)
`data` > `swellWaveHeight`	Average swell wave height	float (m)
`data` > `swellWaveDirection`	Average swell wave direction	float (degrees)
`data` > `swellWavePeriod`	Average swell wave period	float (seconds)
`data` > `pressureMsl`	Average mean sea level pressure	float (hPa)
`data` > `atmosphericTemperature`	Average atmospheric temperature near sea level	float (°C)
`data` > `seaSurfaceTemp`	Average sea surface temperature	float (°C)
`data` > `visibility`	Average visibility	float (km)
`data` > `currentSpeed`	Average ocean current speed	float (m/s)
`data` > `currentDirection`	Average ocean current direction	float (degrees)

3. One Point Season Average Data (Average Year)

이 API는 단일 좌표의 계절별 해상 기상 정보에 대해 설정한 연도만큼의 평균값을 제공합니다.

averageYear는 최소 1년부터 입력하여 조회 가능합니다.

This API provides seasonal average ocean weather data for a specific point voer a user-defined number of years.

This averageYear parameter must be set to least 1 year.

TRY OUT THIS ENDPOINT →

1.1 Request Parameter

GET v1/oceanweather/avg/season?lat=35.5&long=124&averageYear=4&season=summer

Parameter	Description	Type
`lat`	Latitude of the requested location (ISO 6709 decimal degrees)	float
`long`	Longitude of the requested location (ISO 6709 decimal degrees)	float
`averageYear`	Number of years used to calculate the seasonal average (e.g., 1 = one year)	int
`season`	Season in English (Winter, Spring, Summer, Autumn)	string

1.2 API Response

{
    "meta": {
        "code": 200,
        "message": "Ok",
        "lat": 35.5,
        "long": 124.0,
        "averageYear": 4,
        "season": "summer"
    },
    "data": {
        "totalWaveHeight": 1.05,
        "totalWaveDirection": 176.22,
        "totalWavePeriod": 4.71,
        "windSpeed": 5.45,
        "windDirection": 176.26,
        "windWaveHeight": 0.66,
        "windWaveDirection": 187.58,
        "windWavePeriod": 3.52,
        "swellWaveHeight": 0.62,
        "swellWaveDirection": 174.46,
        "swellWavePeriod": 5.79,
        "pressureMsl": 1006.9,
        "atmosphericTemperature": 24.46,
        "seaSurfaceTemp": 23.53,
        "visibility": 5857.61,
        "currentSpeed": 0.27,
        "currentDirection": 174.5
    }
}

Field	Description	Unit
`meta` > `code`	Response status code	integer
`meta` > `message`	Response message	string
`meta` > `lat`	Requested latitude	float (ISO 6709 decimal degrees)
`meta` > `long`	Requested longitude	float (ISO 6709 decimal degrees)
`meta` > `averageYear`	Number of years used to calculate the average	integer (years)
`meta` > `season`	Season for which the average data is calculated (e.g., Winter, Summer)	string
`data` > `startDateTimeUTC`	Start datetime (UTC) of the averaged data	datetime (UTC)
`data` > `endDateTimeUTC`	End datetime (UTC) of the averaged data	datetime (UTC)
`data` > `totalWaveHeight`	Average total wave height	float (m)
`data` > `totalWaveDirection`	Average total wave direction	float (degrees)
`data` > `totalWavePeriod`	Average total wave period	float (seconds)
`data` > `windSpeed`	Average wind speed	float (m/s)
`data` > `windDirection`	Average wind direction	float (degrees)
`data` > `windWaveHeight`	Average wind-generated wave height	float (m)
`data` > `windWaveDirection`	Average wind-generated wave direction	float (degrees)
`data` > `windWavePeriod`	Average wind-generated wave period	float (seconds)
`data` > `swellWaveHeight`	Average swell wave height	float (m)
`data` > `swellWaveDirection`	Average swell wave direction	float (degrees)
`data` > `swellWavePeriod`	Average swell wave period	float (seconds)
`data` > `pressureMsl`	Average mean sea level pressure	float (hPa)
`data` > `atmosphericTemperature`	Average atmospheric temperature near sea level	float (°C)
`data` > `seaSurfaceTemp`	Average sea surface temperature	float (°C)
`data` > `visibility`	Average horizontal visibility	float (km)
`data` > `currentSpeed`	Average ocean current speed	float (m/s)
`data` > `currentDirection`	Average ocean current direction	float (degrees)

4. One Point Season Average Data (Specific Year)

이 API는 단일 좌표의 계절별 해상 기상 정보에 대해 특정 연도의 평균값을 제공합니다.

This API provides seasonal average ocean weather data for a specific point in a given year.

TRY OUT THIS ENDPOINT →

1.1 Request Parameter

GET v1/oceanweather/avg/season/specific?lat=35.5&long=124&year=2022&season=summer

Parameter	Description	Type
`lat`	Latitude of the requested location (ISO 6709 decimal degrees)	float
`long`	Longitude of the requested location (ISO 6709 decimal degrees)	float
`year`	Specific year to retrieve seasonal average data for (e.g., 2022)	integer
`season`	Season in English (Winter, Spring, Summer, Autumn)	string

1.2 API Response

{
    "meta": {
        "code": 200,
        "message": "Ok",
        "lat": 35.5,
        "long": 124.0,
        "year": 2022,
        "season": "summer"
    },
    "data": {
        "totalWaveHeight": 1.15,
        "totalWaveDirection": 173.95,
        "totalWavePeriod": 4.69,
        "windSpeed": 5.97,
        "windDirection": 182.79,
        "windWaveHeight": 0.82,
        "windWaveDirection": 185.59,
        "windWavePeriod": 5.16,
        "swellWaveHeight": 0.49,
        "swellWaveDirection": 171.01,
        "swellWavePeriod": 6.14,
        "pressureMsl": 1006.45,
        "atmosphericTemperature": 24.3,
        "seaSurfaceTemp": 24.32,
        "visibility": 22681.77,
        "currentSpeed": 0.18,
        "currentDirection": 162.31
    }
}

Field	Description	Unit
`meta` > `code`	Response status code	integer
`meta` > `message`	Response message	string
`meta` > `lat`	Requested latitude	float
`meta` > `long`	Requested longitude	float
`meta` > `year`	Requested year	integer
`meta` > `season`	Requested season	string
`data` > `totalWaveHeight`	Seasonal average total wave height	float (m)
`data` > `totalWaveDirection`	Seasonal average total wave direction	float (degrees)
`data` > `totalWavePeriod`	Seasonal average total wave period	float (seconds)
`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` > `windWaveDirection`	Seasonal average wind-generated wave direction	float (degrees)
`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)

5. Timeline Data

이 API는 단일 좌표에 대해 startTime으로부터 timesteps간격으로 연속되는 해상 기상 데이터를 제공합니다.

This API provides continuous marine weather data for a single coordinate at regular timesteps intervals starting from startTime.

TRY OUT THIS ENDPOINT →

1.1 Request Parameter

GET v1/oceanweather/timeline?startTime=2025-08-18T00:00:00Z&timesteps=12h&lat=40&long=-160

Parameter	Description	Type
`startTime`	Start datetime (UTC) for the timeline data	datetime
`timesteps`	Number of hours or intervals from the start time (defines time resolution)	integer
`lat`	Latitude of the requested location (ISO 6709 decimal degrees)	float
`long`	Longitude of the requested location (ISO 6709 decimal degrees)	float

1.2 API Response

{
  "meta": {
    "code": 200,
    "startTime": "2025-08-18T00:00:00Z",
    "endTime": "2025-08-30T03:00:00Z",
    "timesteps": "12h",
    "lat": 40,
    "lon": -160
  },
  "oceanWeather": [
    {
      "windSpeed": 4.55,
      "windDirection": 8.84,
      "windGust": 8.84,
      "atmosphericTemperature": 21.3,
      "pressureSeaLevel": 1026.5,
      "visibility": 4.55,
      "iceThickness": 4.55,
      "precipitation": 4.55,
      "dewPoint": 4.55,
      "humidity": 4.55,
      "totalWaveHeight": 1.2,
      "totalWaveDirection": 297.7,
      "totalWavePeriod": 6.6,
      "windWaveHeight": 0.3,
      "windWaveDirection": 24.2,
      "windWavePeriod": 3,
      "swellWaveHeight": 1.2,
      "swellWaveDirection": 283.4,
      "swellWavePeriod": 7.8,
      "seaSurfaceSalinity": -0.7,
      "seaSurfaceTemp": 23.4,
      "currentSpeed": 0.22,
      "currentDirection": 243.43,
      "beaufortScale": 3,
      "utc": "2025-08-18T00:00:00Z",
      "lat": 40,
      "lon": -160
    },
    {
      "windSpeed": 4.6,
      "windDirection": 11.92,
      "windGust": 11.92,
      "atmosphericTemperature": 21.35,
      "pressureSeaLevel": 1026.2,
      "visibility": 4.6,
      "iceThickness": 4.6,
      "precipitation": 4.6,
      "dewPoint": 4.6,
      "humidity": 4.6,
      "totalWaveHeight": 1.2,
      "totalWaveDirection": 315.95,
      "totalWavePeriod": 6.7,
      "windWaveHeight": 0.3,
      "windWaveDirection": 20.45,
      "windWavePeriod": 3.1,
      "swellWaveHeight": 1.2,
      "swellWaveDirection": 303.2,
      "swellWavePeriod": 7.7,
      "seaSurfaceSalinity": -0.95,
      "seaSurfaceTemp": 23.4,
      "currentSpeed": 0.16,
      "currentDirection": 288.43,
      "beaufortScale": 3,
      "utc": "2025-08-18T03:00:00Z",
      "lat": 40,
      "lon": -160
    }
    // ... more items
  ]
}

Field	Description	Unit
`meta` > `code`	Response status code	integer
`meta` > `startTime`	Start datetime (UTC) of the timeline	datetime
`meta` > `endTime`	End datetime (UTC) of the timeline	datetime
`meta` > `timesteps`	Number of timesteps between start and end time	integer
`meta` > `lat`	Requested latitude	float
`meta` > `long`	Requested longitude	float
`oceanWeather` > `windSpeed`	Wind speed at the specified time and location	float (m/s)
`oceanWeather` > `windDirection`	Wind direction	float (degrees)
`oceanWeather` > `windGust`	Maximum wind gust	float (m/s)
`oceanWeather` > `atmosphericTemperature`	Atmospheric temperature near sea level	float (°C)
`oceanWeather` > `pressureSeaLevel`	Atmospheric pressure at sea level	float (hPa)
`oceanWeather` > `visibility`	Horizontal visibility	float (km)
`oceanWeather` > `iceThickness`	Sea ice thickness	float (m)
`oceanWeather` > `precipitation`	Precipitation amount	float (mm)
`oceanWeather` > `dewPoint`	Dew point temperature	float (°C)
`oceanWeather` > `humidity`	Relative humidity	float (%)
`oceanWeather` > `totalWaveHeight`	Height of combined wind and swell waves	float (m)
`oceanWeather` > `totalWaveDirection`	Direction of combined wave system	float (degrees)
`oceanWeather` > `totalWavePeriod`	Period of combined wave system	float (seconds)
`oceanWeather` > `windWaveHeight`	Height of wind-generated waves	float (m)
`oceanWeather` > `windWaveDirection`	Direction of wind-generated waves	float (degrees)
`oceanWeather` > `windWavePeriod`	Period of wind-generated waves	float (seconds)
`oceanWeather` > `swellWaveHeight`	Height of swell waves	float (m)
`oceanWeather` > `swellWaveDirection`	Direction of swell waves	float (degrees)
`oceanWeather` > `swellWavePeriod`	Period of swell waves	float (seconds)
`oceanWeather` > `seaSurfaceSalinity`	Sea surface salinity	float (psu)
`oceanWeather` > `seaSurfaceTemp`	Sea surface temperature	float (°C)
`oceanWeather` > `currentSpeed`	Ocean current speed	float (m/s)
`oceanWeather` > `currentDirection`	Ocean current direction	float (degrees)
`oceanWeather` > `beaufortScale`	Wind force scale based on Beaufort system (0–12)	integer
`oceanWeather` > `utc`	Datetime (UTC) of the weather data point	datetime
`oceanWeather` > `lat`	Latitude of the data point	float
`oceanWeather` > `lon`	Longitude of the data point	float