Skip to content

Tiles API

Tiles API provides access to weather map tiles for visualizing precipitation data. It supports standard XYZ tile formats compatible with popular mapping services like Mapbox and Google Maps. The API enables real-time and forecast precipitation visualization through both individual map tiles and complete map snapshots.

Servers:

  • https://api.rainbow.ai

APIs

GET /tiles/v1/snapshot

Map snapshot

Returns the most recent weather map snapshot

Responses

200

Latest available map snapshot

MapSnapshot

Field Type Description
snapshot integer

GET /tiles/v1/precip/{snapshot}/{forecast_time}/{zoom}/{tile_x}/{tile_y}

Precipitation map tile

This endpoint provides precipitation map tiles in PNG format, designed for use with common mapping services.

Tiles are PNG image files optimized for web mapping applications. They are generated using the Web Mercator projection (EPSG:3857), ensuring compatibility with popular mapping SDKs, including:

  • Mapbox

  • Google Maps

  • Leaflet

  • OpenLayers

  • Cesium

  • and others

Tiles are requested based on the standard XYZ tile system, allowing seamless integration into existing mapping applications.

Parameters

Name Type Required Description
snapshot integer True Snapshot of the weather map. Limitations:
  • Tiles are accessible up to 2 hours before the latest snapshot.
  • Snapshot timestamps are aligned to 10-minute intervals (epoch UTC seconds).
forecast_time integer True Forecast offset in seconds. Must be >= 0 and in range [0, 14400], step 600
zoom integer True Zoom level [0 - 7]
tile_x integer True X coordinate of a tile. In range [0; 2^zoom]
tile_y integer True Y coordinate of a tile. In range [0; 2^zoom]
color False Color palette code. Default value is 0. More information about available color palettes
coverage boolean False Flag to enable coverage mask: 0 - disable, 1 - enable

Responses

200

Colored tile

string

400

Invalid request. This may occur due to missing or incorrect coordinates

object

Field Type Description
message string
404

Tile doesn't exist

422

Validation Error

HTTPValidationError

Components

HTTPValidationError
Field Type Description
detail array
MapSnapshot
Field Type Description
snapshot integer
ValidationError
Field Type Description
loc array
msg string
type string