- How can I query the current and forecasted temperatures at 3 locations?
- How can I display a simple weather symbol for tomorrow's general weather state?
- How can I query the wave heights for a whole region?
- How can I query observational data of a WMO weather station?
- How can I find a weather station for a certain location?
- How can I query MOS data for a certain location?
- I received strange values, e.g. -888. What does that mean?
- What is the convention for wind, wave and ocean directions?
- Where is the data coming from?
- What is the reference coordinate system used?
- Is it possible to check how many queries have been sent from my account?
How can I query the current and forecasted temperatures at 3 locations?
- The most commonly used temperature parameter is
t_2m:C, which describes the temperature 2 meters above ground. For other available parameters, check Available Parameters.
- Define a list of (latitude, longitude) pairs describing your locations by concatenating them with a '+' symbol, e.g.
47.42,9.38+47.37,8.46+52.50,13.35. For a detailed description of the accepted coordinates, check Coordinates Description.
- The time must be encoded according to the ISO standard, e.g., from last midnight to 2 days into the future in 6 hour steps would be
__replace__0T00:00:00ZP2D:PT6H. For a detailed description, check Time Description.
- Choose a format, such as
csv. For a description of all available formats, check Available Formats.
- Type the results from the previous steps in the following format to make your request:
lat;lon;validdate;t_2m:C 47.42;9.38;2017-08-16T00:00:00Z;15.8 47.42;9.38;2017-08-16T06:00:00Z;17.4 47.42;9.38;2017-08-16T12:00:00Z;22.4 47.42;9.38;2017-08-16T18:00:00Z;20.5 47.42;9.38;2017-08-17T00:00:00Z;16.1 47.42;9.38;2017-08-17T06:00:00Z;18.6 47.42;9.38;2017-08-17T12:00:00Z;22.9 47.42;9.38;2017-08-17T18:00:00Z;21.4 47.42;9.38;2017-08-18T00:00:00Z;16.5 47.37;8.46;2017-08-16T00:00:00Z;16 47.37;8.46;2017-08-16T06:00:00Z;16.3 47.37;8.46;2017-08-16T12:00:00Z;23.3 47.37;8.46;2017-08-16T18:00:00Z;22.5 47.37;8.46;2017-08-17T00:00:00Z;18.1 47.37;8.46;2017-08-17T06:00:00Z;19.1 47.37;8.46;2017-08-17T12:00:00Z;24.6 47.37;8.46;2017-08-17T18:00:00Z;22.8 47.37;8.46;2017-08-18T00:00:00Z;18.5 52.5;13.35;2017-08-16T00:00:00Z;22.6 52.5;13.35;2017-08-16T06:00:00Z;18.6 52.5;13.35;2017-08-16T12:00:00Z;19.1 52.5;13.35;2017-08-16T18:00:00Z;22.1 52.5;13.35;2017-08-17T00:00:00Z;20.3 52.5;13.35;2017-08-17T06:00:00Z;17.7 52.5;13.35;2017-08-17T12:00:00Z;24.3 52.5;13.35;2017-08-17T18:00:00Z;23 52.5;13.35;2017-08-18T00:00:00Z;20.3
How can I display a simple weather symbol for tomorrow's general weather state?
- There is a parameter for that:
weather_symbol_12h:idx. It delivers an index that you can map to images you find here. The index describes the general weather state over the last 12h before the queried date.
- Usually, to describe the daily weather state, the time between 6 and 18 o'clock is considered, so you should query the weather_symbol_12h:idx at 18 o'clock. For a detailed description of the required parameters, check Required Parameters
- Example query: https://api.meteomatics.com/tomorrowT18Z/weather_symbol_12h:idx/47.42,9.38/csv
How can I query the wave heights for a whole region?
- Check which parameter is of interest for you in the list of available marine parameters, e.g.
- Define the area you are interested in. You can use shortcuts such as
north-atlantic:0.1,0.1or specify a rectangular grid, as described in Coordinate Description. Note that when using shortcuts, you still need to define a resolution. This can be done with the area requests option.
- Define a date you are interested in. Please note that for grids you can only choose one date and not a time series (with the exception of the format netcdf, which allows for gridded time series). Again, you can use shortcuts such as
nowor the ISO format, as described in Time Description.
- Combine everything into a query: https://api.meteomatics.com/now/significant_wave_height:m/north-atlantic:0.1,0.1/png
How can I query observational data of a WMO weather station?
- Use the WMO number as an identifer: e.g.
wmo_066810for St. Gallen.
- Choose source
- Choose the time period you are interested in: e.g.
- Combine the items to a query: https://api.meteomatics.com/2017-11-15T00Z--2017-11-22T00Z:PT1H/t_2m:C/wmo_066810/csv?model=mix-obs
- In case you want measured data only, and no temporal interpolation, choose
Missing data will then be filled by -999 instead of temporally interpolated.
How can I find a weather station for a certain location?
- Use the find_station query to find a suiting station. Build a list of conditions:
- Elevation: If you want to prefer stations at a certain elevation:
- What time range are you interested in? Let's say you wan't data from October 2017, then define
- What parameters are you interested in? Let's say temperature and wind speed, so choose
- Combine the query:
- Once you found a matching station, query data directly from that station, e.g. with it's WMO identifier:
How can I query MOS data for a certain location?
- Use the find_station query to find available stations:
- Query Data:
I received strange values, e.g. -888. What does that mean?
There are some reserved parameters we use to tell you that the data is not valid. These are listed here: Reserved Values
What is the convention for wind, wave and ocean directions?
We are using the meteorological convention for all direction parameters.
The meteorological convention is that U component is positive for a west to east flow (e.g. eastward wind) and the V component is positive for south to north flow (e.g. northward wind). The wind_dir:d parameters are from 0° to 360°, where 0° means northerly wind (blowing from north to south) and 90° means easterly wind (blowing from east to west).
We are also using the meteorological convention for wave directions and ocean current directions. Meaning if e.g. mean_direction_wind_waves:d shows 180°, the waves travel from south to north.
Where is the data coming from?
In case you don't specify a certain model, we combine several models and techniques. You will receive the best available forecast for the queried date and location. That can be model output, satellite based, measured, radar based, etc.
Let's look at precipitation as an example:
- For historic dates, such as those in 1980, precipitation data originates from a reanalysis model.
- More recent data (from about 2015 to the present) originates from high resolution precipitation radars, if they are available for the particular location. If not, data is obtained from high resolution models, such as the ukmo-euro4.
- Near future data, up to about two hours from the time of the request, is still derived from radar measurements; however, it is forecasted using a nowcast technique.
- Medium range forecasts are also derived from high resolution models.
What is the reference coordinate system used?
All coordinates are in latitude/longitude pairs according to WGS84. The vertical datum is the EGM96 Geoid.
Is it possible to check how many queries have been sent from my account?
You can check how many queries you have already sent and how the limits in your contract are defined by calling:
The same information in a machine readable format: