Skip to main content
POST
/
v1
/
thunderstorms
/
within
Thunderstorm List (Within Radius)
curl --request POST \
  --url https://api.iklim.co/v1/thunderstorms/within \
  --header 'Content-Type: application/json' \
  --data '
{
  "latitude": 39.869847,
  "longitude": 32.745468,
  "radius": 1000,
  "backwardInterval": 600,
  "endTimeEpoch": 1746454091000,
  "pageNumber": 0,
  "pageSize": 10,
  "intersectsWith": "AFFECTED_POLYGON"
}
'
{
  "thunderstorms": [
    {
      "eventId": "EVT20240413001",
      "insertedAtEpoch": 1746454091000,
      "eventStartUtcEpoch": 1746453091000,
      "eventEndUtcEpoch": 1746454091000,
      "severity": "Low/Normal/High",
      "threshold": 7,
      "meta": {
        "country": "Türkiye",
        "state": "Ankara",
        "city": "Çankaya",
        "speedUnit": "mph",
        "speed": 35.4
      },
      "cell": {
        "area": 23.5,
        "speed": 44.8,
        "direction": 270,
        "flashRates": {
          "inCloud": 1.3,
          "cloudToGround": 0.8,
          "total": 2.1
        },
        "centroid": {
          "lng": 32.857358,
          "lat": 39.93504
        },
        "polygon": {
          "exterior": [
            {
              "lng": 32.85,
              "lat": 39.93
            },
            {
              "lng": 32.86,
              "lat": 39.93
            },
            {
              "lng": 32.86,
              "lat": 39.94
            },
            {
              "lng": 32.85,
              "lat": 39.94
            },
            {
              "lng": 32.85,
              "lat": 39.93
            }
          ],
          "holes": [
            [
              {
                "lng": 32.852,
                "lat": 39.932
              },
              {
                "lng": 32.853,
                "lat": 39.932
              },
              {
                "lng": 32.853,
                "lat": 39.933
              },
              {
                "lng": 32.852,
                "lat": 39.933
              },
              {
                "lng": 32.852,
                "lat": 39.932
              }
            ]
          ]
        }
      },
      "affectedPolygon": {
        "exterior": [
          {
            "lng": 32.85,
            "lat": 39.93
          },
          {
            "lng": 32.86,
            "lat": 39.93
          },
          {
            "lng": 32.86,
            "lat": 39.94
          },
          {
            "lng": 32.85,
            "lat": 39.94
          },
          {
            "lng": 32.85,
            "lat": 39.93
          }
        ],
        "holes": [
          [
            {
              "lng": 32.852,
              "lat": 39.932
            },
            {
              "lng": 32.853,
              "lat": 39.932
            },
            {
              "lng": 32.853,
              "lat": 39.933
            },
            {
              "lng": 32.852,
              "lat": 39.933
            },
            {
              "lng": 32.852,
              "lat": 39.932
            }
          ]
        ]
      }
    }
  ],
  "totalRecords": 100,
  "pageNumber": 0,
  "pageSize": 10
}

Body

application/json
​
latitude
number<double>
required

Latitude of the center point.

Required range: -90 <= x <= 90
Example:

39.869847

​
longitude
number<double>
required

Longitude of the center point.

Required range: -180 <= x <= 180
Example:

32.745468

​
radius
number<double>
required

Search radius in meters.

Required range: 0 <= x <= 50000
Example:

1000

​
backwardInterval
integer<int64>
required

Query time range in seconds (backward from endTimeEpoch).

Required range: 60 <= x <= 2592000
Example:

600

​
endTimeEpoch
integer<int64>
required

End time for the query, in epoch milliseconds.

Required range: x >= 0
Example:

1746454091000

​
pageNumber
integer<int32>
required

Page number for pagination.

Required range: x >= 0
Example:

0

​
pageSize
integer<int32>
required

Page size for pagination.

Required range: x <= 100
Example:

10

​
intersectsWith
enum<string>

Which polygon to intersect with. Allowed values: AFFECTED_POLYGON, CELL_POLYGON.

Available options:
AFFECTED_POLYGON,
CELL_POLYGON
Example:

"AFFECTED_POLYGON"

Response

Thunderstorm list within radius successfully returned.

​
thunderstorms
object[]
required

Thunderstorm event list.

​
totalRecords
integer<int32>
required

Total number of records.

Example:

100

​
pageNumber
integer<int32>
required

Page number.

Example:

0

​
pageSize
integer<int32>
required

Page size.

Example:

10