/wthr/mvar/PointForcast

POST

weather.openportguide.orghttps://weather.openportguide.org/api/wthr/mvar/PointForcast

Last modified:2025-06-22 15:38:51

Maintainer:tkws

OperationId:wth_mvar_PointForcast

Description

The API endpoint "/wthr/mvar/PointForcast" returns the set of different variables from different forecast models and different times for a specified position. This is a very powerful query, but it allows you, for example, to retrieve all the values you need to display a meteogram with just one query. The returned values will be bilinear interpolated from the grid points of the forecast models around the values for the returned position. At Wikipedia you find a good expanation of the bilinear interpolation: Wikipedia - Bilinear interpolation

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://weather.openportguide.org/api/wthr/mvar/PointForcast?apiKey={{api-key}}' \
--header 'Host: {{BASE_URL}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "models": [
        {
            "model": "gfs",
            "variables": [
                {
                    "variable": "TMP",
                    "level": "surface"
                },
                {
                    "variable": "TMP",
                    "level": "2 m above ground"
                },
                {
                    "variable": "UGRD",
                    "level": "10 m above ground"
                },
                {
                    "variable": "VGRD",
                    "level": "10 m above ground"
                },
                {
                    "variable": "VIS",
                    "level": "surface"
                }
            ]
        },
        {
            "model": "rtofs_prog",
            "variables": [
                {
                    "variable": "WTMP",
                    "level": "surface"
                }
            ]
        }
    ],
    "latitude": 54.04,
    "units": "metric",
    "longitude": 8.45,
    "timesteps": [
        "0",
        1,
        "2",
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30,
        31,
        32,
        33,
        34,
        35,
        36,
        37,
        38,
        39,
        40,
        41,
        42,
        43,
        44,
        45,
        46,
        47,
        48,
        49,
        50,
        51,
        52,
        53,
        54,
        55,
        56,
        57,
        58,
        59,
        60,
        61,
        62,
        63,
        64,
        65,
        66,
        67,
        68,
        69,
        70,
        71,
        72,
        75,
        78,
        81,
        84,
        87,
        90,
        93,
        96,
        99,
        102,
        105,
        108,
        111,
        114,
        117,
        120,
        123,
        126,
        129,
        132,
        135,
        138,
        141,
        144,
        147,
        150,
        153,
        156,
        159,
        162,
        165,
        168,
        171,
        174,
        177,
        180,
        183,
        186,
        189,
        192
    ]
}'

Response Example

200 - Success

{"metadata":{"serviceProvider":"navapi.com","originatingCenter":"US National Weather Service - NCEP (WMC)","forecastPosition":[{"latitude":54.04},{"longitude":8.45}],"UsedTokens":1,"forecastTime":[[0,"2025-06-25T12:00:00Z"],[1,"2025-06-25T13:00:00Z"],[2,"2025-06-25T14:00:00Z"],[3,"2025-06-25T15:00:00Z"],[4,"2025-06-25T16:00:00Z"],[5,"2025-06-25T17:00:00Z"],[6,"2025-06-25T18:00:00Z"],[7,"2025-06-25T19:00:00Z"],[8,"2025-06-25T20:00:00Z"],[9,"2025-06-25T21:00:00Z"],[10,"2025-06-25T22:00:00Z"],[11,"2025-06-25T23:00:00Z"],[12,"2025-06-26T00:00:00Z"],[13,"2025-06-26T01:00:00Z"],[14,"2025-06-26T02:00:00Z"],[15,"2025-06-26T03:00:00Z"],[16,"2025-06-26T04:00:00Z"],[17,"2025-06-26T05:00:00Z"],[18,"2025-06-26T06:00:00Z"],[19,"2025-06-26T07:00:00Z"],[20,"2025-06-26T08:00:00Z"],[21,"2025-06-26T09:00:00Z"],[22,"2025-06-26T10:00:00Z"],[23,"2025-06-26T11:00:00Z"],[24,"2025-06-26T12:00:00Z"],[25,"2025-06-26T13:00:00Z"],[26,"2025-06-26T14:00:00Z"],[27,"2025-06-26T15:00:00Z"],[28,"2025-06-26T16:00:00Z"],[29,"2025-06-26T17:00:00Z"],[30,"2025-06-26T18:00:00Z"],[31,"2025-06-26T19:00:00Z"],[32,"2025-06-26T20:00:00Z"],[33,"2025-06-26T21:00:00Z"],[34,"2025-06-26T22:00:00Z"],[35,"2025-06-26T23:00:00Z"],[36,"2025-06-27T00:00:00Z"],[37,"2025-06-27T01:00:00Z"],[38,"2025-06-27T02:00:00Z"],[39,"2025-06-27T03:00:00Z"],[40,"2025-06-27T04:00:00Z"],[41,"2025-06-27T05:00:00Z"],[42,"2025-06-27T06:00:00Z"],[43,"2025-06-27T07:00:00Z"],[44,"2025-06-27T08:00:00Z"],[45,"2025-06-27T09:00:00Z"],[46,"2025-06-27T10:00:00Z"],[47,"2025-06-27T11:00:00Z"],[48,"2025-06-27T12:00:00Z"],[49,"2025-06-27T13:00:00Z"],[50,"2025-06-27T14:00:00Z"],[51,"2025-06-27T15:00:00Z"],[52,"2025-06-27T16:00:00Z"],[53,"2025-06-27T17:00:00Z"],[54,"2025-06-27T18:00:00Z"],[55,"2025-06-27T19:00:00Z"],[56,"2025-06-27T20:00:00Z"],[57,"2025-06-27T21:00:00Z"],[58,"2025-06-27T22:00:00Z"],[59,"2025-06-27T23:00:00Z"],[60,"2025-06-28T00:00:00Z"],[61,"2025-06-28T01:00:00Z"],[62,"2025-06-28T02:00:00Z"],[63,"2025-06-28T03:00:00Z"],[64,"2025-06-28T04:00:00Z"],[65,"2025-06-28T05:00:00Z"],[66,"2025-06-28T06:00:00Z"],[67,"2025-06-28T07:00:00Z"],[68,"2025-06-28T08:00:00Z"],[69,"2025-06-28T09:00:00Z"],[70,"2025-06-28T10:00:00Z"],[71,"2025-06-28T11:00:00Z"],[72,"2025-06-28T12:00:00Z"],[75,"2025-06-28T15:00:00Z"],[78,"2025-06-28T18:00:00Z"],[81,"2025-06-28T21:00:00Z"],[84,"2025-06-29T00:00:00Z"],[87,"2025-06-29T03:00:00Z"],[90,"2025-06-29T06:00:00Z"],[93,"2025-06-29T09:00:00Z"],[96,"2025-06-29T12:00:00Z"],[99,"2025-06-29T15:00:00Z"],[102,"2025-06-29T18:00:00Z"],[105,"2025-06-29T21:00:00Z"],[108,"2025-06-30T00:00:00Z"],[111,"2025-06-30T03:00:00Z"],[114,"2025-06-30T06:00:00Z"],[117,"2025-06-30T09:00:00Z"],[120,"2025-06-30T12:00:00Z"],[123,"2025-06-30T15:00:00Z"],[126,"2025-06-30T18:00:00Z"],[129,"2025-06-30T21:00:00Z"],[132,"2025-07-01T00:00:00Z"],[135,"2025-07-01T03:00:00Z"],[138,"2025-07-01T06:00:00Z"],[141,"2025-07-01T09:00:00Z"],[144,"2025-07-01T12:00:00Z"],[147,"2025-07-01T15:00:00Z"],[150,"2025-07-01T18:00:00Z"],[153,"2025-07-01T21:00:00Z"],[156,"2025-07-02T00:00:00Z"],[159,"2025-07-02T03:00:00Z"],[162,"2025-07-02T06:00:00Z"],[165,"2025-07-02T09:00:00Z"],[168,"2025-07-02T12:00:00Z"],[171,"2025-07-02T15:00:00Z"],[174,"2025-07-02T18:00:00Z"],[177,"2025-07-02T21:00:00Z"],[180,"2025-07-03T00:00:00Z"],[183,"2025-07-03T03:00:00Z"],[186,"2025-07-03T06:00:00Z"],[189,"2025-07-03T09:00:00Z"],[192,"2025-07-03T12:00:00Z"]],"refDate":"2025-06-25T12:00:00Z"},"data":[{"generatingProcess":"Global Forecast System Model","model":"gfs","ny":721,"nx":1440,"latitudeFirstGridpoint":90.0,"latitudeLastGridpoint":-90.0,"longitudeFirstGridpoint":0.0,"longitudeLastGridpoint":359.75,"gridlengthXDirection":0.25,"gridlengthYDirection":-0.25,"variables":[{"shortName":"TMP","fullName":"Temperature","unit":"°C","level":"surface","values":[17.7,17.6,17.7,17.7,17.7,17.5,17.5,17.4,17.4,17.4,17.4,17.4,17.4,17.4,17.4,17.5,17.5,17.5,17.5,17.6,17.7,17.7,17.7,17.8,17.8,17.8,17.8,17.8,17.8,17.8,17.8,17.7,17.8,17.7,17.8,17.8,17.8,17.8,17.8,17.7,17.7,17.7,17.7,17.7,17.7,17.6,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.6,17.6,17.6,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.7,17.8,17.9,17.9,17.9,17.9,18.0,18.0,17.9,17.8,17.8,17.8,17.9,18.1,18.6,18.9,18.9,18.3,17.9,17.9,17.9,18.3,18.8,19.2,19.1,18.4,18.0,17.9,17.9,17.8,17.9,17.9,17.8,17.7,17.7,17.6,17.8,18.4,19.3,19.4,18.0,17.8,17.8,17.8,17.8,18.4,19.4]},{"shortName":"TMP","fullName":"Temperature","unit":"°C","level":"2 m above ground","values":[16.6,16.6,16.6,16.5,16.4,16.3,16.2,16.1,16.0,16.0,16.0,16.1,16.2,16.3,16.2,16.0,15.8,15.7,15.9,16.3,16.9,17.6,17.6,17.5,17.6,17.8,18.0,18.0,17.4,17.2,17.1,17.1,17.6,17.7,17.8,17.3,17.6,17.4,17.1,16.8,16.6,16.5,16.5,16.5,16.5,16.6,16.5,16.5,16.6,16.5,16.4,16.5,16.4,16.4,16.4,16.5,16.6,16.8,17.1,17.2,17.2,17.1,17.4,17.5,17.6,17.6,17.5,17.8,18.2,18.3,18.2,18.2,18.3,17.8,17.6,17.6,17.6,18.0,18.4,18.8,19.0,18.8,19.2,19.3,19.4,19.0,19.4,20.7,21.3,20.5,19.2,19.0,17.8,15.9,15.4,15.4,15.5,15.8,15.9,15.8,15.6,15.6,15.6,15.6,16.5,17.4,17.3,17.2,16.9,16.7,16.6,16.6,16.9]},{"shortName":"UGRD","fullName":"U-Component of Wind","unit":"m/s","level":"10 m above ground","values":[8.17,7.62,7.08,5.74,4.98,4.34,3.6,2.6,1.69,0.765,0.483,0.177,-0.644,-1.82,-2.08,-2.48,-4.02,-2.8,-2.93,-4.16,-4.23,-3.76,-2.58,-2.21,-1.93,-1.59,0.517,7.29,10.9,10.6,9.95,9.27,8.17,7.24,8.05,7.77,8.33,9.75,9.41,8.28,8.22,8.96,9.42,8.81,9.08,9.12,9.84,10.4,10.8,9.81,9.26,9.02,8.47,7.62,7.7,7.54,6.9,6.43,6.42,5.51,5.04,4.71,4.28,4.58,5.78,7.26,7.74,7.86,8.36,8.79,8.88,8.37,8.41,7.62,6.34,5.58,4.58,3.58,2.79,3.41,3.52,1.9,-0.409,-2.1,-2.96,-3.04,-1.35,0.56,3.53,2.48,3.48,6.72,5.14,2.33,2.12,2.49,2.03,2.63,2.23,1.14,0.425,0.575,-0.775,-0.46,0.124,1.42,-0.272,0.785,0.778,0.791,1.45,1.07,0.658]},{"shortName":"VGRD","fullName":"V-Component of Wind","unit":"m/s","level":"10 m above ground","values":[-1.96,-2.45,-2.84,-3.6,-3.14,-2.61,-1.96,-1.9,-1.78,-1.52,-0.448,0.276,0.998,1.55,3.0,3.39,3.35,5.29,4.34,2.19,2.03,2.81,4.53,5.28,4.61,4.53,5.0,2.81,2.99,1.58,1.34,1.64,1.78,2.3,2.55,2.8,3.23,2.24,-0.16,-3.61,-5.29,-5.34,-5.29,-4.47,-3.31,-1.44,-1.19,-0.623,-1.23,-0.874,-1.03,-0.777,-0.335,0.426,0.815,0.658,1.25,1.68,2.07,2.96,4.46,5.37,5.93,6.53,6.5,5.78,5.43,4.46,3.5,2.38,1.95,2.37,1.92,-0.0845,-0.701,-0.371,0.161,2.06,4.81,3.02,-0.954,-2.68,-2.01,-0.0659,3.07,3.93,5.1,5.07,0.511,-1.42,0.867,-2.41,-5.61,-9.03,-8.18,-6.96,-6.72,-6.21,-5.79,-3.64,-1.98,-1.34,0.503,0.274,-0.296,-3.95,-2.97,-2.96,-1.92,-0.495,-1.06,-0.437,-0.683]},{"shortName":"VIS","fullName":"Visibility","unit":"m","level":"surface","values":[24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,14500.0,7030.0,10000.0,22100.0,18700.0,19000.0,20100.0,12300.0,24100.0,24100.0,24100.0,24100.0,22700.0,24100.0,24100.0,23900.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,22700.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,19600.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0,24100.0]}]},{"generatingProcess":"Global Real-Time Ocean Forecast System Model","model":"rtofs_prog","ny":721,"nx":1440,"latitudeFirstGridpoint":-90.0,"latitudeLastGridpoint":90.0,"longitudeFirstGridpoint":0.0,"longitudeLastGridpoint":359.75,"gridlengthXDirection":0.25,"gridlengthYDirection":0.25,"variables":[{"shortName":"WTMP","fullName":"Water Temperature","unit":"°C","level":"surface","values":[17.6,17.6,17.7,17.8,17.8,17.9,18.0,18.1,18.1,18.1,18.1,18.0,18.0,18.0,18.0,17.9,17.9,17.9,17.9,17.9,17.8,17.8,17.8,17.8,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.9,17.8,17.8,17.8,17.8,17.8,17.8,17.8,17.8,17.9,17.9,18.0,18.0,18.1,18.1,18.1,18.2,18.2,18.2,18.2,18.2,18.2,18.2,18.2,18.2,18.1,18.1,18.1,18.1,18.1,18.1,18.2,18.2,18.3,18.3,18.5,18.6,18.6,18.7,18.6,18.6,18.7,19.0,19.4,19.6,19.5,19.4,19.3,19.2,19.3,19.9,20.0,20.3,20.2,20.0,19.8,19.7,19.7,19.8,19.9,20.0,20.0,20.0,19.8,19.7,19.8,20.0,20.1,20.1,20.1,19.9,null,null,null,null]}]}]}

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

Modified at 2025-06-22 15:38:51

/wthr/svar/AreaForcast

/wthr/calc/AstroData