API

Terms of Use

Tile Server

Example how to use on the GitHub: https://github.com/rainviewer/rainviewer-api-example.

Projection is Web Mercator (EPSG:3857), Google Maps, Apple Maps, Bing Maps ready. Bounds: -180.0 -85.06 ... 180.0 85.06. Host: https://tilecache.rainviewer.com/.

URLDescription
/v2/radar/{ts}/{size}/{z}/{x}/{y}/{color}/{smooth}_{snow}.pngRadar Data: displays one tile with the composite radar reflectivity data, with specified size, color scheme, and additional options.
/v2/radar/{ts}/{big_size}/{color}/0_{snow}.pngComposite image with radar reflectivity for a whole world. Slow generation, up to 10 seconds per image loads. Cannot be smoothed because it took too many time and resources now.
/v2/coverage/0/{size}/{z}/{x}/{y}.pngCoverage tile: where radar data is available (transparent areas) and where is not (black areas)
/v2/coverage/0/{big_size}.pngComposite coverage tile for a whole world at once. Slow generation.

WLD files for for different sizes: will add geofence data to single composite PNG images for your favorite map application like QGIS, ArcGIS etc.: 2000 x 2000, 4000 x 4000, 4096 x 4096, 8000 x 4000, 8192 x 8192, 16000 x 16000, 16384 x 16384

Color Schemes

ColorName
0Black and White dBZ values
1Original
2Universal Blue
3TITAN
4The Weather Channel
6NEXRAD Level III
7Rainbow @ SELEX-IS

Black and White dBZ values

Shows raw dBZ values starting from the -31 dBZ (pixel’s red component color “1” value) and ending at 95 dBZ (“127” value) with 1 dBZ step (see table below). If snow options are selected, the first bit in sub-color byte provides the snow mask. For example, if red component is 175 that means the snow with reflectivity 15 dBZ. 175 & 128 = 128 - snow mark. 175 & 127 = 47 red pixel value. 47 - 32 = 15 dBZ. If a pixel is transparent, there is no data for it or -32 dBZ.

Pixel valuedBZPrecipitation Type
0No DataRain
1-31 dBZRain
2-30 dBZRain
Rain
12694 dBZRain
12795 dBZRain
128No DataSnow
129-31 dBZSnow
Snow
25595 dBZSnow

Examples

Single Radar Images

https://data.rainviewer.com/images/

Contains the data archive of sources and processed radar files (past 24 hours). The directory name is a radar identifier in RainViewer. Each directory of particular radar contains radar source and processed images sorted by time.

File EndingDescription
0_source.(png|gif|jpeg|jpgRadar source image (image format may vary)
0_source.urlLink to the original image location
1_bw_raw.pngClean radar image without watermarks, ground maps, and legends. Source image colors are converted to black and white gamma.
1_bw.pngBlack and white reflectivity map with applied noise reduction algorithms in the original image projection (do not try to use for Google Maps).
2_map.pngBlack and white reflectivity in the Web Mercator projection (EPSG:3857). Can be placed directly as an overlay in Google Maps, Open Street Maps or any other web map.
2_map.wldWorld file which describe *2_map.png image placement on the map. Uses Web Mercator (EPSG:3857) projection.