Dark Mode
/v1/port-forecast-gpf.json
GET
/v1/port-forecast-gpf.json
Data Specification
| No | Item | Value |
|---|---|---|
| 1 | Data Name | Global Port Forecast |
| 2 | Data Area | Global |
| 3 | Data Output Format | JSON |
| 4 | Data Update | 01:00, 07:00, 13:00, 19:00 UTC (Approximate) |
Item List
| No | Item Name | Full Name | Unit/Format | Values Type |
|---|---|---|---|---|
| 1 | valid_date | Forecast valid date | UTC hash | string |
| 2 | (valid_date) year | Forecast valid year | yyyy | int |
| 3 | (valid_date) mon | Forecast valid month | mm | int |
| 4 | (valid_date) day | Forecast valid day | dd | int |
| 5 | (valid_date) hour | Forecast valid hour | hh | int |
| 6 | (valid_date) min | Forecast valid minute | mm | int |
| 7 | (valid_date) sec | Forecast valid second | ss | int |
| 8 | fc_date | Forecast base time date | UTC hash | string |
| 9 | (fc_date) year | Forecast base time year | yyyy | int |
| 10 | (fc_date) mon | Forecast base time month | mm | int |
| 11 | (fc_date) day | Forecast base time day | dd | int |
| 12 | (fc_date) hour | Forecast base time hour | hh | int |
| 13 | (fc_date) min | Forecast base time minute | mm | int |
| 14 | (fc_date) sec | Forecast base time second | ss | int |
| 15 | WNDSPD | Wind velocity | kts | int |
| 16 | GUSTS | Gust wind velocity | kts | int |
| 17 | WNDDIR | Wind Direction | Table Cardinal Directions | int |
| 18 | WX | Weather condition | Table Telop Chart | string |
| 19 | PRCRIN_TOTAL | Precipitation | mm/3h | int |
| 20 | HVIS | Visibility | meter | int |
| 21 | AIRTMP | Air temperature | Celsius | int |
| 22 | ARPRSS | Air pressure | hPa | int |
| 23 | SGFDIR | Significant wave direction | Table Cardinal Directions | int |
| 24 | SGFHGT | Significant wave height | meter | int |
| 25 | SGFHGT_Max | Significant wave height max | meter | int |
| 26 | SGFPER | Wave period | sec | int |
| 27 | SWLHGT | Swell height | meter | int |
| 28 | SWLDIR | Swell direction | Table Cardinal Directions | int |
| 29 | SEWHGT | Sea wind height | meter | int |
| 30 | SEWDIR | Sea wind direction | Table Cardinal Directions | int |
| 31 | PWVDIR | Primary wave direction | Table Cardinal Directions | int |
| 32 | PWVHGT | Primary wave height | meter | int |
| 33 | WNDSPD_50M | Wind velocity at 50m | kts | int |
| 34 | GUSTS_50M | Gust Wind velocity at 50m | kts | int |
| 35 | WIND_CNFDNC | Wind confidence | 1: High, 2: Middle, 3: Low | int |
| 36 | ICE_risk_level | Ice risk level | 0: None 1: Warning 2: Alert -99999999: N/A |
int |
| 37 | TYPHN_effect_level | Typhoon effect level | 0: None 1: Warning 2: Alert -99999999: N/A |
int |
Telop Chart
| Code | Telop Chart |
|---|---|
| 100 | Sunny |
| 200 | Cloudy |
| 300 | Rain |
| 430 | Sleet |
| 400 | Snow |
| 700 | Mist |
| 2001 | Light Sand/Dust Storm |
| 2002 | Moderate Sand/Dust Storm |
| 2003 | Severe Sand/Dust Storm |
Parameters
Query Parameters
portcode*
Port Code (Based on PortCode Provided in point list API)
Typestring
RequiredResponses
200 response
application/json
JSON
{
"7FCST": [
{
"WNDSPD_50M": 11,
"ARPRSS": 1010,
"WNDSPD": 9,
"WNDDIR": 1,
"SGFHGT_Max": 0.2,
"GUSTS_50M": 16,
"PRCRIN_TOTAL": 0,
"GUSTS": 13,
"SGFDIR": 1,
"WX": 100,
"SGFPER": 2,
"SWLDIR": 8,
"WIND_CNFDNC": 1,
"PWVDIR": 1,
"AIRTMP": 19,
"SEWDIR": 1,
"HVIS": 30000,
"SWLHGT": 0,
"fc_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"valid_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"TYPHN_effect_level": -99999999,
"SEWHGT": 0.1,
"SGFHGT": 0.1,
"PWVHGT": 0.1,
"ICE_risk_level": -99999999
}
],
"5FCST": [
{
"WNDSPD_50M": 11,
"ARPRSS": 1010,
"WNDSPD": 9,
"WNDDIR": 1,
"SGFHGT_Max": 0.2,
"GUSTS_50M": 16,
"PRCRIN_TOTAL": 0,
"GUSTS": 13,
"SGFDIR": 1,
"WX": 100,
"SGFPER": 2,
"SWLDIR": 8,
"WIND_CNFDNC": 1,
"PWVDIR": 1,
"AIRTMP": 19,
"SEWDIR": 1,
"HVIS": 30000,
"SWLHGT": 0,
"fc_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"valid_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"TYPHN_effect_level": -99999999,
"SEWHGT": 0.1,
"SGFHGT": 0.1,
"PWVHGT": 0.1,
"ICE_risk_level": -99999999
}
],
"2FCST": [
{
"WNDSPD_50M": 11,
"ARPRSS": 1010,
"WNDSPD": 9,
"WNDDIR": 1,
"SGFHGT_Max": 0.2,
"GUSTS_50M": 16,
"PRCRIN_TOTAL": 0,
"GUSTS": 13,
"SGFDIR": 1,
"WX": 100,
"SGFPER": 2,
"SWLDIR": 8,
"WIND_CNFDNC": 1,
"PWVDIR": 1,
"AIRTMP": 19,
"SEWDIR": 1,
"HVIS": 30000,
"SWLHGT": 0,
"fc_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"valid_date": {
"year": 2019,
"mon": 5,
"day": 23,
"hour": 0,
"min": 0,
"sec": 0
},
"TYPHN_effect_level": -99999999,
"SEWHGT": 0.1,
"SGFHGT": 0.1,
"PWVHGT": 0.1,
"ICE_risk_level": -99999999
}
]
}