API

Terms of Use

If you enjoy our API and want to support RainViewer API and keep it free as long as possible, please, support us at Patreon. This also gives you more features, like access to the radar database and your custom color scheme.

Become a patron of RainViewer API

Tile Server

https://tilecache.rainviewer.com/v2/

URLDescription
/radar/{ts}/{size}/{z}/{x}/{y}/{color}/{options}.pngRadar data: displays one tile with the composite radar reflectivity data, with specified size, color scheme, and additional options.
/radar/{ts}/{size}/{z}/{latitude}/{longitude}/{color}/{options}.pngRadar data: the same as link above, but with center at specified coordinate (EPSG:4326) with desired zoom size. Great for widgets
/composite/{ts}/{big_size}/{color}/{options}.pngComposite image with radar reflectivity for a whole world. Slow generation, up to 10 seconds per image loads. Cannot be smoothed.
/coverage/0/{size}/{z}/{x}/{y}.pngCoverage tile: where radar data is available (transparent areas) and where is not (black areas)
/coverage/0/{size}/{z}/{latitude}/{longitude}.pngCoverage data as above but for specified center coordinate (latitude, longitude)
/coverage/0/{big_size}.pngComposite coverage tile for a whole world at once. Slow generation.

Geofence composite files

Projection is Web Mercator (EPSG:3857), Google Maps, Apple Maps, Bing Maps ready. Bounds: -180.0 -85.06 ... 180.0 85.06. 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 1000, 4000 x 2000, 4096 x 4096, 8000 x 4000, 8192 x 8192, 16000 x 8000, 16384 x 16384, 24000 x 12000

You can also geofence any of full composite png files with gdal_translate command:

gdal_translate -co compress=lzw -of Gtiff \
	-a_ullr -20037508.342789248 20048966.10401463 20037508.342789248 -20048966.10401463 \
	-a_srs EPSG:3857 image.png image.tif

Color Schemes

ColorName
0Black and White dBZ values
1Original
2Universal Blue
3TITAN
4The Weather Channel
5Meteored
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 for the last 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.

How to get GeoTIFF file from PNG + WLD

That’s pretty easy with gdal_translate command. Put *2_map.png and *2_map.wld files of any radar image into the same directory and use this command:

gdal_translate -co compress=lzw -of Gtiff -a_srs EPSG:3857 {source_image} {output_image}

Where:

Example

First, download example files archive. Then, run the commands we explained earlier. You sould get similar output from that two commands: gdal_translate, which is geofence the radar PNG image, and the gdainfo, which shows the information in a geofenced image. It is important to have both PNG and WLD files of an image in the same directory with the same name.