/v3/weather-on-track.json

POST

/v3/weather-on-track.json

Retrieve weather and ocean data for one or more geographic points along a ship route.

Overview

• Update schedule: 00:00, 06:00, 12:00, 18:00 UTC
• Data adoption: For the requested date/time, the nearest analysis run among 00, 06, 12, 18 UTC is adopted. Past data within ±3 hours of a run time uses that run's analysis value.
• Maximum points per request: 100

Request Format

Send a JSON object with a Point array. Each element requires:

Field	Type	Description
date	string	Request date in YYYYMMDDHH or ISO 8601 format
lat	number	Latitude in minutes (−5400 to 5400, i.e. −90° to +90°)
lon	number	Longitude in minutes (−10800 to 10800, i.e. −180° to +180°)

Note: Coordinates are in arc-minutes, not decimal degrees. Multiply decimal degrees by 60.
Example: 35.1°N → lat: 2106, 130.0°E → lon: 7800

Supported Content-Types

• application/json: Send JSON body directly
• application/x-www-form-urlencoded: Send JSON as point parameter value

Data Field Specifications

Wave Data

Source: COMPASS Wave Main Scenario (412010172), WNI_MRF_COMPAS_WAVE_SCNRO_0p125

Field	Description	Unit	Resolution	Forecast Range	Time Step
sigwh	Significant wave height	m	0.125° × 0.125°	0–384 h	3 h
wln	Wave length	m	0.125° × 0.125°	0–384 h	3 h
pwh	Primary wave height	m	0.125° × 0.125°	0–384 h	3 h
swh	Secondary wave height	m	0.125° × 0.125°	0–384 h	3 h
awp	Average wave period	s	0.125° × 0.125°	0–384 h	3 h
dws	Wind sea direction (16-point, going to)	—	0.125° × 0.125°	0–384 h	3 h
pswh	Primary swell wave height	m	0.125° × 0.125°	0–384 h	3 h
pswp	Primary swell wave period	s	0.125° × 0.125°	0–384 h	3 h
pswd	Primary swell wave direction (16-point, coming from)	—	0.125° × 0.125°	0–384 h	3 h
pwp	Primary wave period	s	0.125° × 0.125°	0–384 h	3 h
pwd	Primary wave direction (16-point, coming from)	—	0.125° × 0.125°	0–384 h	3 h

Wind Data

Derived from wave data (UV components), same source as wave (412010172).

Field	Description	Unit	Resolution	Forecast Range	Time Step
was	Wind speed	knots	0.125° × 0.125°	0–384 h	3 h
wad	Wind direction — going to (16-point)	—	0.125° × 0.125°	0–384 h	3 h
wad_come_from	Wind direction — coming from (16-point)	—	0.125° × 0.125°	0–384 h	3 h

Ocean / Sea Data

Field	Description	Unit	Resolution	Forecast Range	Time Step
ocs	Ocean current speed	knots	0.083° × 0.083° (1/12°)	0–720 h	1 h (0–143 h), 24 h (144+ h)
ocd	Ocean current direction (16-point, going to)	—	0.083° × 0.083° (1/12°)	0–720 h	1 h (0–143 h), 24 h (144+ h)
sst	Sea surface temperature	°C	1.0° × 1.0°	Daily	24 h
ssp	Sea surface pressure	Pa	1.0° × 1.0°	0–384 h	6 h
tmp1000hpa	Temperature at 1000 hPa	°C	1.0° × 1.0°	0–384 h	6 h

16-Point Compass Encoding

Direction values are encoded as integers 1–16 (N=1, NNE=2, NE=3, … clockwise). Value 0 indicates calm/no direction.

Past Data Handling

For requests with a date in the past, the nearest analysis run (00/06/12/18 UTC) is used:

• The run closest in time to the requested date is selected.
• Data older than approximately 10 days may not be available.

Missing Values

Missing or invalid data is represented as -9999999.
Land points return missing values for ocean/wave fields.

Parameters

Header Parameters

Authorization*

"WniWebApi " + Token ID

Typestring

Required

Request Body

{

"Point": [

{

"date": "2026012400",

"lat": 2106,

"lon": 7800

}

]

}

Responses

Successful response with weather data

Content-Type

application/json

{

"data": [

{

"date": "2026012400",

"lat": 2106,

"lon": 7800,

"sigwh": 0.704,

"wln": 105.78,

"pwh": 0.66,

"swh": 0.2467,

"awp": 2.469,

"dws": 4,

"wpp": 8.795,

"wdp": 4,

"pswh": 0.704,

"pswp": 8.830001,

"pswd": 7,

"wsh": 0.015,

"wsp": 2.465,

"wsd": 9,

"pwp": 8.830001,

"pwd": 7,

"swp": 4.75,

"swd": 9,

"was": 4.969996,

"wad": 2,

"wad_come_from": 10,

"ocs": 0.311621,

"ocd": 8,

"sst": 27.83996,

"ssp": 101139,

"tmp1000hpa": 26.529993

}

]

}

POST

/v3/weather-on-track.json

Playground

Headers

Authorization*

Body

Samples