Lightning

Lightning API
Powered by MeteoGroup

Overview


MeteoGroup’s Lightning API can provide either real-time or aggredated data regaring lightning strikes.

Real-time data results will show every lightning strike during a specified timeframe. The aggregated results will show groupings of strikes, colour-coded by severity. This is ideal for media presentation.

How is the request processed?


Formatting a request to the Lightning API is different than the Point-Forecast or Observation API.

Instead of specifying a single area, the request must cover a geographical grid, specified by the four corners: top left, bottom left, top right, bottom right.

A time framce can be specified, but is not required. If not specified, data will be returned covering the last 72 hours.

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 Lightning API looks like this:
https://lightning.weather.mg/search?provider=NOWCAST,ENGLN&locationWithin=[10,13],[52,5]

The above request will return real-time, raw data for lighting strikes for the specified location (Berlin, Germany) over the last 3 days.


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

        {
        "lightnings":[
                    {
                         "occurredAt":"2017-01-05T12:21:14.974Z",
                         "provider":"NOWCAST",
                         "lightningType":"CLOUD_TO_GROUND",
                         "elevationInKilometers":0,
                         "currentInAmpere":4500,
                         "location":[
                            9.6345,
                            19.3064
                         ]
                      },
                      {
                         "occurredAt":"2017-01-05T12:21:14.974Z",
                         "provider":"ENGLN",
                         "lightningType":"CLOUD_TO_GROUND",
                         "elevationInKilometers":0,
                         "currentInAmpere":4700,
                         "location":[
                            8.6345,
                            20.3064
                         ]
                      },
                       {
                          "provider": "NOWCAST",
                          "occurredAt": "2017-01-05T12:20:14.974Z",
                          "elevationInKilometers": 0,
                          "lightningType": "CLOUD_TO_GROUND",
                          "currentInAmpere": -3500,
                          "location": [
                            9.3345,
                            19.7064
                          ]
                        }
                   ]
                }
        

Authentication


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

Nitty-Gritty


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