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