Create free API test account

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 2024-12-19T00: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/2024-12-19T00: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 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 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:

Wave heights

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 query observational data of a METAR weather station?

  1. Use the METAR ID as an identifer: e.g. metar_LSZH for Zurich Airport.
  2. Choose source model=mix-obs.
  3. Choose the time period you are interested in: e.g. 2020-11-01T00Z--2020-11-08T00Z:PT1H.
  4. Combine the items to a query:
    http://api.meteomatics.com/2020-11-01T00Z--2020-11-08T00Z:PT1H/t_2m:C,wind_speed_10m:ms/metar_LSZH/html?model=mix-obs&on_invalid=fill_with_invalid
  5. In case you want measured data only, and no temporal interpolation, choose temporal_interpolation=none:
    http://api.meteomatics.com/2020-11-01T00Z--2020-11-08T00Z:PT1H/t_2m:C,wind_speed_10m:ms/metar_LSZH/html?model=mix-obs&on_invalid=fill_with_invalid&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&on_invalid=fill_with_invalid

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/2024-12-19T00ZP5D: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:

  • 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: https://api.meteomatics.com/user_stats

The same information in a machine readable format:
https://api.meteomatics.com/user_stats_json

I get the response: "No username or password provided." but there is no message box to enter my credentials.

There are several possible reasons for this behavior. Please try the following:

  1. Maybe you have a wrong password caches in your browser: Delete the cached password in your browser cache.
  2. Using basic authentication over http:// is not safe, why some browsers don't allow it: Ensure that you use https:// and not http://
  3. On Windows some browsers (e.g. Edge, Chrome) can be configured to not allow basic authentication even over https:// : Check and change the according policies.
    1. Open your windows registry and navigate to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ Policies\ your_browser_provider\your_browser e.g.

      Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge
      Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome

    2. Check if there is an entry AuthSchemes and if this entry doesn't contain "basic". If that's the case we found the reason. If not, check also under Computer\HKEY_LOCAL_USER\SOFTWARE\Policies\ your_browser_provider\your_browser.
    At the moment api.meteomatics.com supports only basic authentication. To fix the issue do one of the following:
    1. allow basic authentication for all https connections by removing the entry AuthSchemes or by adding "basic" to it (comma separated list)
    2. allow basic authentication only for meteomatics.
      1. Add the key [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\your_browser_provider\your_browser\AllHttpAuthSchemesAllowedForOrigins]
      2. add a REG_SZ value. As name pick the next free number or "1" if there aren't any entries yet.
      3. Set the value to "https://api.meteomatics.com"