API: Weather Radar Database

Weather radar database is a dynamic JSON file which describes three main entities and its relations:

Database File Example

Database file consists of three root objects:

Here is an example of the database file with one radar, one image, and one source description:

{
  "radars": [
    {
      "id": "KESX",
      "country": "US",
      "state": "NV",
      "location": "Las Vegas",
      "status": 1,
      "latitude": 35.7012894,
      "longitude": -114.8918277,
      "image_id": "KESX"
    }
  ],
  "images": [
    {
      "id": "KESX",
      "provier_id": "Iastateedu",
      "status": 0,
      "projection": "EPSG:4326",
      "products": "https://data.rainviewer.com/images/KESX/0_products.json",
      "frequency": 240
    }
  ],
  "providers": [
    {
      "id": "Iastateedu",
      "name": "Iowa Environmental Mesonet",
      "description": "Iowa State University, Iowa Environmental Mesonet.",
      "url": "https://mesonet.agron.iastate.edu/docs/nexrad_composites/"
    }
  ]
}

Radar Object

keyDescriptionValuesExample
idInner radar identifier. Sometimes equal to the ICAO airport code, sometimes we choose it by our own opinion.String(8)SATAI
countryISO 3166-1 alpha-2 country code. Here is an description: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2String(2)US
stateState of the country if applicableString(255)Hawaii
locationName of the radar or its locationString(255)KLIA Airport
statusNot usedTinyint(1)1
latitudeLatitude of the weather radar station, WSG84Float35.7012894
longitudeLongitude of the weather radar station, WSG84Float-114.8918277
image_idID of image file, which contains the data of this radar. Sometimes we download composite images which show the data from several radar stations at once. Example: UK radar imageString(8)UKCOMP2

Image Object

keyDescriptionValuesExample
idImage identifier. Most of the time is equal to the Radar ID object, but sometimes not.String(8)USCOMP
provider_idID of provider object from this databaseString(64)Idgobmkg
statusStatus of this image. 0 - not used in composite maps, 1 - used in composite mapsTinyint(1)1
projectionSource image projectionString(64)AEQD
productslink to the products.json file when you can get all the images of this radarString(255)https://data.rainviewer.com/images/KESX/0_products.json
frequencyTypical update frequency in seconds. Zero if not updated for a long timeInt600

Provider Object

keyDescriptionValuesExample
idProvider identifier. Reversed domain name with a few exceptionsString(255)Mxgobcnasmn
nameOfficial name of the provider in native languageString(255)中央氣象局全球資訊網
descriptionDescription of the radar source. Typically in EnglishString(255)Taiwan Central Weather Bureau
urlLink to the page with the radar data on this sourceString(255)https://meteo.gov.ua/en/33345/radar

Become our patron!

Remember, weather radar database available only for Gold and Platinum Patrons. Please become our patron, support our free API and get your personal link to the weather radar database now!

Become a patron of RainViewer API