Drive-time departure forecast
rushhour_departure_forecastUse this when the user asks when to leave for a drive, the best departure time, drive time, commute traffic, or rush hour between two places. Returns hourly drive times for the next 24 hours from now, in local time at the starting point, and the shortest departure, in one call, for a road route in the United States, the United Kingdom, or Canada. Departures later today and tomorrow that fall inside those 24 hours are included and labelled Today or Tomorrow, or Now (this hour) when that hour is already underway (window_start, window_end, coverage). Times more than 24 hours ahead are not forecast yet: say so and suggest asking again closer to the trip. A fresh forecast was generated in the current hour and is at most 45 minutes old (generatedAt, ageMinutes, freshness, age_seconds). Quote freshness. When a live lookup is busy, rate-limited, or refused and a curve from the last 48 hours is stored, the result includes stale true, stale_message, and retry_after, with departures that have already passed removed. Do not use for turn-by-turn directions, transit, walking, live incident reports, places outside the United States, the United Kingdom, and Canada, or a past day.
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": {
"origin": "<origin>",
"destination": "<destination>"
},
"name": "rushhour_departure_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | City or address where the drive starts, in the United States, the United Kingdom, or Canada. Example: Manchester, or Toronto, ON. | |
| destination | Yes | City or address where the drive ends, in the United States, the United Kingdom, or Canada. Example: Heathrow Airport, or Ottawa, ON. | |
| response_format | No | concise returns the best departure, duration, and when the forecast was made. detailed also returns each hour's drive time. Omit for concise. |