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
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:
|
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
Components¶
HTTPValidationError¶
Field | Type | Description |
---|---|---|
detail | array |
MapSnapshot¶
Field | Type | Description |
---|---|---|
snapshot | integer |
ValidationError¶
Field | Type | Description |
---|---|---|
loc | array | |
msg | string | |
type | string |