Storms

Get NEXRAD Level III algorithm-detection overlays as GeoJSON.

Returns a GeoJSON FeatureCollection of NEXRAD Level III algorithm-detection overlays — Hail Index, Mesocyclone, and Tornado Vortex Signature (TVS) — for a single radar site. Each feature carries site_id plus the product-specific detection payload (e.g. probability-of-hail / max hail size, mesocyclone or TVS strength) in a forward-compat properties bag. Treat unknown keys as opaque additive data.

Product selector

product is required and selects which detection layer to return: hail_index, mesocyclone, or tvs.

Site selector

site is the 3-letter Level III radar site code (e.g. TLX); a 4-letter ICAO (e.g. KTLX) is also accepted and uppercased server-side. As an alternative to site, pass lat + lon together to resolve the nearest radar server-side.

Caching

Successful responses carry Cache-Control: public, max-age=30, stale-while-revalidate=30.

Coverage

With lat/lon, a point outside the 50 US states and DC returns 404 outside-coverage with next_steps; site is not checked.

Auth

Standard sw-api Bearer auth applies.

get/v1/nexrad/features

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/nexrad/features
  • Auth: HTTP bearer

Query parameters

product'hail_index' | 'mesocyclone' | 'tvs' required

Detection product to return. One of hail_index, mesocyclone, tvs.

sitestring

NEXRAD Level III radar site code. 3-letter (e.g. TLX) or 4-letter ICAO (e.g. KTLX); uppercased server-side. Omit to use the lat/lon nearest-radar fallback.

latnumber double

Latitude for nearest-radar resolution. Must be provided together with lon; ignored when site is set.

lonnumber double

Longitude for nearest-radar resolution. Must be provided together with lat; ignored when site is set.

Response

GeoJSON FeatureCollection. Empty features array when no detections exist for the product/site (200, not 404).

Changes

No recorded changes to this operation across all 1 revision of this API.