FAQ

How can I query the current and forecasted temperatures at 3 locations?

  1. 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.
  2. 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.
  3. 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 insert_current_dateT00:00:00ZP2D:PT6H. For a detailed description, check Time Description.
  4. Choose a format, such as csv. For a description of all available formats, check Available Formats.
  5. Type the results from the previous steps in the following format to make your request: https://api.meteomatics.com/insert_current_dateT00:00:00ZP2D:PT6H/t_2m:C/47.42,9.38+47.37,8.46+52.50,13.35/csv

The result:

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?

  1. 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.
  2. 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
  3. Example query: https://api.meteomatics.com/tomorrowT18Z/weather_symbol_12h:idx/47.42,9.38/csv

The result:

validdate;weather_symbol_12h:idx
2017-08-17T18:00:00Z;1

How can I query the wave heights for a whole region?

  1. Check which parameter is of interest for you in the list of available marine parameters, e.g. significant_wave_height:m
  2. Define the area you are interested in. You can use shortcuts such as north-atlantic:0.1,0.1 or 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.
  3. Define a date you are interested in. Please not 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 now or the ISO format, as described in Time Description.
  4. Combine everything into a query: https://api.meteomatics.com/now/significant_wave_height:m/north-atlantic:0.1,0.1/png

The result:

How can I query observational data of a WMO weather station?

  1. Use the WMO number as an identifer: e.g. wmo_066810 for St. Gallen.
  2. Choose source model=mix-obs.
  3. Choose the time period you are interested in: e.g. 2017-11-15T00Z--2017-11-22T00Z:PT1H.
  4. 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
  5. In case you want measured data only, and no temporal interpolation, choose temporal_interpolation=none: https://api.meteomatics.com/2017-11-15T00Z--2017-11-22T00Z:PT1H/t_2m:C/wmo_066810/csv?model=mix-obs&temporal_interpolation=none Missing data will then be filled by -999 instead of temporally interpolated.

How can I find a weather station for a certain location?

  1. Use the find_station query to find a suiting station. Build a list of conditions:
  2. Location: location=47.3,9.3
  3. Elevation: If you want to prefer stations at a certain elevation: elevation=2500
  4. What time range are you interested in? Let's say you wan't data from October 2017, then define startdate=2017-10-01T00Z and enddate=2017-11-01T00Z
  5. What parameters are you interested in? Let's say temperature and wind speed, so choose parameters=t_2m:C,wind_speed_10m:ms
  6. Combine the query: https://api.meteomatics.com/find_station?location=47.3,9.3&elevation=2500&startdate=2017-10-01T00Z&enddate=2017-11-01T00Z&parameters=t_2m:C,wind_speed_10m:ms
  7. Once you found a matching station, query data directly from that station, e.g. with it's WMO identifier: https://api.meteomatics.com/2017-10-01T00Z--2017-11-01T00Z:PT1H/t_2m:C,wind_speed_10m:ms/wmo_066800/html?model=mix-obs

How can I query MOS data for a certain location?

  1. Use the find_station query to find available stations: https://api.meteomatics.com/find_station?location=47.3,9.3&parameters=t_2m:C,wind_speed_10m:ms&source=mm-mos
  2. Query Data: https://api.meteomatics.com/insert_current_dateT00ZP5D:PT1H/t_2m:C,wind_speed_10m:ms/wmo_066800/html?model=mm-mos

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:

News