weather stations

Point-Forecast API
Powered by MeteoGroup

Overview

MeteoGroup’s innovative forecast system delivers high quality weather forecasts for more than 50,000 stations world-wide.

The forecast calculation is optimized with real-time observations to achieve even higher accuracy for up to 6 hours into the future, a feature known as "nowcasting".

MeteoGroup's forecasting of weather parameters is based on historical observations combined with multiple numeric weather prediction models. This is fancy-talk for "our servers crunch a lot of numbers and make very accurate predictions."

The available parameters are forecasted for a given point in time over a defined time span.

Due to the complexities of time zones, certain queries for 15-day forecasts may return anywhere between 14 and even more than 15 days of data. This depends on the location being provided.

For example, API provides forecasts for approximately 15 days and 9 hours for Tokyo (UTC+9). But for San Francisco (UTC-8) it will return forecasts only for 14 days and 16 hours.

Request URL Builder


How is the request processed?


When a properly formatted request is received, with valid authentication, the applications searches for the meteorological station nearest to the provided latitude & longitude.

The searching algorithm stops once a station is found, or at a maximum distance of 100km from the requested location, whichever is less.

By default, the latest known weather forecast data from the nearest station is processed and the correct model is selected.

If the request does not include a date & time range ("validFrom" & "validUntil"), the application uses the current date & time as a starting point, and will provide a forecast for 1 day.

If a start date is included, but an end date is not, the application will provide a forecast for 1 day.

The data is then processed and returned to you, formatted in the JSON format. This makes it easy to use in your business.

Formatting


A sample request using the point-forecast API looks like this:

https://point-forecast.weather.mg/search?locatedAt=13.2,52.4&validPeriod=PT0S&fields=airTemperatureInCelsius
    

The above request will return forecasted air termperature for the city of Berlin, Germany, over the next 3 hours three hours from the time the request was received.

The returned data will be formatted in JSON, and will look like this:

    {
      "forecasts": [
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "validUntil": "2017-03-22T15:00:00+01:00",
          "airTemperatureInCelsius": 11.1,
          "validFrom": "2017-03-22T15:00:00+01:00",
          "validPeriod": "PT0S"
        },
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "validUntil": "2017-03-22T16:00:00+01:00",
          "airTemperatureInCelsius": 10.8,
          "validFrom": "2017-03-22T16:00:00+01:00",
          "validPeriod": "PT0S"
        },
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "validUntil": "2017-03-22T17:00:00+01:00",
          "airTemperatureInCelsius": 10.3,
          "validFrom": "2017-03-22T17:00:00+01:00",
          "validPeriod": "PT0S"
        }
      ]
    }
    

Authentication


For detailed instructions on how to obtain the necessary authorization information, please refer to the technical documentation on GitHub.

Available Weather Parameters



The full list of available parameters is continuously updated, and can always be found here.

Some parameters, like air temperature or wind speed, are observed at a given point in time.

Others, like sunshine duration or wind gusts, always cover a time span of 1 hour. Details are provided in the paremeter list.

Examples of useful parameters for the Point-Forecast API are:


Nitty-Gritty

For more detailed information on this API, check us out on GitHub.