Nowcast API 0.21.2
The Nowcast API provides access to minute-by-minute precipitation forecast for the next 4 hours.
Servers
Description | URL |
---|---|
Production API server | https://api.rainbow.ai |
Endpoints
GET /v1/precip/{longitude}/{latitude}
Minute-by-minute precipitation forecast
Description
" This endpoint provides a minute-by-minute precipitation forecast for the next 4 hours.
The forecast includes: - Minute-by-minute precipitation for the next 4 hours.
Use Cases
- Weather apps providing detailed short-term forecasts
- Logistics & transportation companies planning routes
- Outdoor activity planning, such as hiking, sports, and events
Data Coverage
- The API supports global locations but may return
404
if weather data is unavailable in a specific area.
Input parameters
Parameter | In | Type | Default | Nullable | Description |
---|---|---|---|---|---|
latitude |
path | number | No | Latitude coordinate of the location for which the forecast is requested | |
longitude |
path | number | No | Longitude coordinate of the location for which the forecast is requested |
Response 200 OK
{
"forecast": [
{
"precipRate": 1.42,
"precipType": "snow",
"timestampBegin": 1737570600,
"timestampEnd": 1737570660
}
],
"latitude": 52.23289409654632,
"longitude": 21.0065536398819,
"summary": {
"intensity": "moderate"
}
}
Schema of the response body
{
"properties": {
"longitude": {
"type": "number",
"title": "longitude",
"description": "Longitude coordinate of the location for which the forecast is prepared",
"example": 21.0065536398819
},
"latitude": {
"type": "number",
"title": "latitude",
"description": "Latitude coordinate of the location for which the forecast is prepared",
"example": 52.23289409654632
},
"summary": {
"$ref": "#/components/schemas/PrecipForecastSummary",
"title": "summary",
"description": "Classification of the maximum precipitation intensity during the period"
},
"forecast": {
"items": {
"$ref": "#/components/schemas/PrecipForecastItem"
},
"type": "array",
"title": "forecast",
"description": "Precipitation forecast for the next 4 hours"
}
},
"type": "object",
"required": [
"longitude",
"latitude",
"summary",
"forecast"
],
"title": "PrecipForecastResponse",
"example": {
"forecast": [
{
"precipRate": 1.42,
"precipType": "snow",
"timestampBegin": 1737570600,
"timestampEnd": 1737570660
}
],
"latitude": 52.23289409654632,
"longitude": 21.0065536398819,
"summary": {
"intensity": "moderate"
}
}
}
Response 400 Bad Request
{
"message": "string"
}
Schema of the response body
{
"properties": {
"message": {
"title": "Message",
"type": "string"
}
},
"required": [
"message"
],
"title": "ResponseError",
"type": "object"
}
Response 404 Not Found
Response 422 Unprocessable Entity
{
"detail": [
{
"loc": [
null
],
"msg": "string",
"type": "string"
}
]
}
Schema of the response body
{
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}
Schemas
HTTPValidationError
Name | Type |
---|---|
detail |
Array<ValidationError> |
PrecipForecastItem
Name | Type |
---|---|
precipRate |
number |
precipType |
ResponsePrecipType |
timestampBegin |
integer |
timestampEnd |
integer |
PrecipForecastResponse
Name | Type |
---|---|
forecast |
Array<PrecipForecastItem> |
latitude |
number |
longitude |
number |
summary |
PrecipForecastSummary |
PrecipForecastSummary
Name | Type |
---|---|
intensity |
ResponsePrecipIntensity |
ResponsePrecipIntensity
Type: string
ResponsePrecipType
Type: string
ValidationError
Name | Type |
---|---|
loc |
Array<> |
msg |
string |
type |
string |