Hourly forecast
get_hourly_forecastAnswers: what will the wind, gusts, temperature, rain, cloud and other conditions be at a place and time, including wind and gusts at chosen heights above ground, and what were they in past hours the plan includes. Returns hourly values in the user's units, each with its status against the user's thresholds. "Good" means within the user's own UAV Forecast limits, not safe; airspace, permissions, aircraft limits and battery are not included. Current factor keys: wind_at_altitude, max_altitude, temp_or_wind_chill, humidity, delta_t, precip_prob, precip_intensity, thunder_prob, cloud_cover, cloud_base, icing, visibility, sun_elevation, gps, kp, gps_kp, gust_at_altitude; unknown keys may appear. Anything the plan, region or data sources don't include is listed under "unavailable" with a reason (plan, region, source, setting).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"place": "<place>"
},
"name": "get_hourly_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | No | How many hours from start. | |
| place | Yes | A favorite location's name, a place name, "lat, lon" coordinates, or "here". | |
| start | No | Local date or date-time; may be in the past within your plan's historical window. | |
| locale | No | BCP 47 language tag for labels. | |
| factors | No | The factors to read; without it, those with an enabled threshold plus wind and gust. | |
| profile | No | A saved settings profile's name, to answer with that profile's settings instead of the current ones. | |
| altitudes | No | Heights above ground (AGL) in altitude_units; without altitude_units, the user's altitude units (see get_my_settings). Each must be above 0: the lowest forecast wind is the surface wind at 10 m (33 ft), so ask for that for wind at ground level. | |
| altitude_units | No | m or ft; set it whenever the user names a unit. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| link | No | ||
| note | No | ||
| hours | No | ||
| place | No | ||
| range | No | ||
| units | No | ||
| source | No | Source: UAV Forecast | |
| status | Yes | ok or subscription_required; others may appear. | |
| message | No | ||
| timezone | No | ||
| now_local | No | ||
| historical | No | ||
| unavailable | No |