Tiles API 0.35.2¶

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¶

Description	URL
Production API server	https://api.rainbow.ai

Endpoints¶

GET /tiles/v1/snapshot¶

Map snapshot

Description

Returns the most recent weather map snapshot

Input parameters

Parameter	In	Type	Default	Nullable	Description
`layer`	query		precip	No	Layer to get a snapshot for. Currently available layers: precip, precip-global, clouds, radars. Default value is precip.

Responses

200 OK422 Unprocessable Entity

application/json

JSON

{
    "snapshot": 0
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "snapshot": {
            "type": "integer",
            "title": "Snapshot"
        }
    },
    "type": "object",
    "required": [
        "snapshot"
    ],
    "title": "MapSnapshot"
}

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

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

Precipitation map tile

Description

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.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`color`	query		0	No	Color palette code. Default value is `0`. More information about available color palettes
`coverage`	query	boolean	0	No	Flag to enable coverage mask: 0 - disable, 1 - enable
`forecast_time`	path	integer		No	Forecast offset in seconds. Must be >= 0 and in range [0, 14400], step 600
`snapshot`	path	integer		No	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).
`tile_x`	path	integer		No	X coordinate of a tile. In range [0; 2^zoom]
`tile_y`	path	integer		No	Y coordinate of a tile. In range [0; 2^zoom]
`zoom`	path	integer		No	Zoom level [0 - 12]

Responses

200 OK400 Bad Request404 Not Found422 Unprocessable Entity

image/png

JSON

"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ="

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "type": "string",
    "format": "binary"
}

application/json

JSON

{
    "message": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

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

Global precipitation map tile

Description

This endpoint provides global 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.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`color`	query		0	No	Color palette code. Default value is `0`. More information about available color palettes
`coverage`	query	boolean	0	No	Flag to enable coverage mask: 0 - disable, 1 - enable
`forecast_time`	path	integer		No	Forecast offset in seconds. Must be >= 0 and in range [0, 14400], step 600
`snapshot`	path	integer		No	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).
`tile_x`	path	integer		No	X coordinate of a tile. In range [0; 2^zoom]
`tile_y`	path	integer		No	Y coordinate of a tile. In range [0; 2^zoom]
`zoom`	path	integer		No	Zoom level [0 - 12]

Responses

200 OK400 Bad Request404 Not Found422 Unprocessable Entity

image/png

JSON

"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ="

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "type": "string",
    "format": "binary"
}

application/json

JSON

{
    "message": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /tiles/v1/clouds/{snapshot}/{zoom}/{tile_x}/{tile_y}¶

Clouds map tile

Description

This endpoint provides clouds 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.

Input parameters

Parameter	In	Type	Nullable	Description
`snapshot`	path	integer	No	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).
`tile_x`	path	integer	No	X coordinate of a tile. In range [0; 2^zoom]
`tile_y`	path	integer	No	Y coordinate of a tile. In range [0; 2^zoom]
`zoom`	path	integer	No	Zoom level [0 - 7]

Responses

200 OK400 Bad Request404 Not Found422 Unprocessable Entity

image/png

JSON

"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ="

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "type": "string",
    "format": "binary"
}

application/json

JSON

{
    "message": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /tiles/v1/radars/{snapshot}/{zoom}/{tile_x}/{tile_y}¶

Radars map tile

Description

This endpoint provides radars 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.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`color`	query		0	No	Color palette code. Default value is `0`. More information about available color palettes
`coverage`	query	boolean	0	No	Flag to enable coverage mask: 0 - disable, 1 - enable
`snapshot`	path	integer		No	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).
`tile_x`	path	integer		No	X coordinate of a tile. In range [0; 2^zoom]
`tile_y`	path	integer		No	Y coordinate of a tile. In range [0; 2^zoom]
`use_precip_type`	query	boolean	0	No	Flag to switch between radar reflectivity and precipitation type visualization: 0 - disable (everything considered as rain), 1 - enable
`zoom`	path	integer		No	Zoom level [0 - 7]

Responses

200 OK400 Bad Request404 Not Found422 Unprocessable Entity

image/png

JSON

"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ="

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "type": "string",
    "format": "binary"
}

application/json

JSON

{
    "message": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

Schemas¶

HTTPValidationError¶

Name	Type	Description
`detail`	Array<ValidationError>

MapSnapshot¶

Name	Type	Description
`snapshot`	integer

TilesLayer¶

Type: string

ValidationError¶

Name	Type	Description
`loc`	Array<>
`msg`	string
`type`	string