Legacy API

https://api.rainviewer.com/public/maps.json

Purpose and Description

The past weather radar map frames (2 hours), updates every 10 minutes.

Please do not guess timestamps. Use them from this API. One frame is generated for approximately 40 seconds. If you automatically generate the timestamp rounded to 10 minutes, your application will get 404 responses every 10 minutes for ~ 40 seconds. The reason is that the new map is still generated during that time.

Using Timestamps

Timestamps from the API above are used as a part of the URL - the {ts} part. All available URLs and their parameters are described below. To request the map data, use the https://tilecache.rainviewer.com/v2/ base URL.

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 the link above, but with the center at specified coordinates (EPSG:4326) with the desired zoom size. Great for widgets.
composite/{ts}/{big_size}/{color}/{options}.pngComposite image with radar reflectivity for the entire world. Generates slowly, 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 coordinates (latitude, longitude).
coverage/0/{big_size}.pngComposite coverage tile for the entired world at once. Generates slowly.
  • {ts} – one of the available Unix timestamps from the API.
  • {x}, {y}, {z} – x, y, and zoom level of the tile that you want to download. Read more about tiles
  • {latitude}, {longitude} - latitude and longitude of specific coordinates accordingly. Decimal format. Must contain a dot in the number. Example: -32.7892, 108.67821.
  • {size} – image size, can be 256 or 512.
  • {big_size} – can be 2000, 4000, 8000, 16000, or 24000 (24000x12000 px or ~2km per pixel). For square images use 4096, 8196, and 16384 accordingly.
  • {color} - the number of the color scheme from the provided list.
  • {options} – list of options separated by the _ symbol. For example: ‘1_0’ means smoothed (1) image without snow color scheme (0). Now two options are available: {smooth}_{snow}
    • {smooth} - blur (1) or not (0) radar data. Large composite images are always not smoothed due to performance issues.
    • {snow} - display (1) or not (0) snow in separate colors on the tiles.

Examples

Please refer to the separate examples page.

Get RainViewer for Free
RainViewer RainViewer