Weather radar database is a dynamic JSON file that describes three main entities and their relations:
Whenever any of this data is changed in Rain Viewer, it will change in this database as well. To get access to the database, you need to be a Gold, Gold+, or Platinum patron on our Patreon page. We will send you a link to the database, and this link will work until you remain an active patron.
If you enjoy our API and want to keep it free for as long as possible, please support us at Patreon. You will also get access to the weather radar database API, 60 minutes of weather radar nowcast map, and a possibility to get tiles in your own custom color scheme.
Become a patronA database file consists of three root objects:
radars - an array of all known radars that is available under “Single Radar Mode” in Rain Viewer now.images - an array of all images that are now 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/"
}
]
}
| key | Description | Values | Example |
|---|---|---|---|
| id | Inner radar identifier. Sometimes equal to the ICAO airport code, sometimes we choose it at our own discretion. | String(8) | SATAI |
| country | ISO 3166-1 alpha-2 country code. https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 | String(2) | US |
| state | State of the country if applicable | String(255) | Hawaii |
| location | Name of the radar or its location | String(255) | KLIA Airport |
| status | Not used | Tinyint(1) | 1 |
| latitude | Latitude of the weather radar station, WSG84 | Float | 35.7012894 |
| longitude | Longitude of the weather radar station, WSG84 | Float | -114.8918277 |
| image_id | ID 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 image | String(8) | UKCOMP2 |
| key | Description | Values | Example |
|---|---|---|---|
| id | Image identifier. Most of the time it is equal to the Radar ID object. | String(8) | USCOMP |
| provider_id | ID of provider object from this database. | String(64) | Idgobmkg |
| status | Status of this image. 0 - not used in composite maps, 1 - used in composite maps. | Tinyint(1) | 1 |
| projection | Source image projection. | String(64) | AEQD |
| products | Link to the products.json file when you can get all images of this radar. | String(255) | https://data.rainviewer.com/images/KESX/0_products.json |
| frequency | Typical update frequency in seconds. Zero if not updated for a long time. | Int | 600 |
| key | Description | Values | Example |
|---|---|---|---|
| id | Provider identifier. Reversed domain name with a few exceptions. | String(255) | Mxgobcnasmn |
| name | Official name of the provider in native language. | String(255) | 中央氣象局全球資訊網 |
| description | Description of the radar source, typically in English. | String(255) | Taiwan Central Weather Bureau |
| url | Link to the page with the radar data on this source. | String(255) | https://meteo.gov.ua/en/33345/radar |
