База данных метеорадаров API

Weather radar database is a dynamic JSON file that describes three main entities and their relations:

  • Weather radars
  • Weather radar images
  • Weather radar data sources Whenever this change in the RainViewer, the database will change as well. To get access to this database, you will need to be a Gold, Gold+, or Platinum patron on our Patreon page. We will send your link to that database, which will work until you are an active patron on the Patreon website.

Database File Example

Database file consists of three root objects:

  • radars - an array of all known radars which is available under “Single Radar Mode” in the RainViewer now.
  • images - an array of all images which now are trying to download (sometimes, it will not happen).
  • providers - weather radar database sources.

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 that 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, the weather radar database available only for Gold and Platinum Patrons. Please become our patron, support our API, and get your link to the weather radar database now!

Become a patron of RainViewer API

Get RainViewer for Free
RainViewer RainViewer