Point Observations

Point-Observation API
Powered by MeteoGroup

Overview

MeteoGroup’s observation system delivers high-quality weather observation data for more than 50,000 stations world-wide. The observation data is is quality-controlled and available in near-real-time.

The API queries the location in question for the current weather parameters.

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 observation data from the selected station is returned.

If the request does not include a date & time range ("observedFrom" & "observedUntil"), the application uses the current date & time -3 hours as a starting point, and will use the time the request was received as the end point.

If a starting date is included, but an end point is not, the application will provide observations for 3 days from the starting starting point, or until the date & time the request was received if it is less than 3 days from the starting point.

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-Observation API looks like this:

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

The above request will return current air temperature, in degrees Celsius, for the city of Berlin, Germany, starting 3 hours before the time the request was received. The returned data will be formatted in JSON, and will look like this:

    {
      "observations": [
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "observedFrom": "2017-03-22T12:00:00+01:00",
          "observedUntil": "2017-03-22T12:00:00+01:00",
          "observedPeriod": "PT0S",
          "airTemperatureInCelsius": 11
        },
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "observedFrom": "2017-03-22T13:00:00+01:00",
          "observedUntil": "2017-03-22T13:00:00+01:00",
          "observedPeriod": "PT0S",
          "airTemperatureInCelsius": 11.5
        },
        {
          "locatedAt": [
            13.2,
            52.4
          ],
          "observedFrom": "2017-03-22T14:00:00+01:00",
          "observedUntil": "2017-03-22T14:00:00+01:00",
          "observedPeriod": "PT0S",
          "airTemperatureInCelsius": 12.1
        }
      ]
    }
    

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-Observation API are:


Nitty-Gritty


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