latest
Retrieve current weather observations for any Australian location using curated names, states, or coordinates. Provides real-time weather context for any query.
Instructions
Return the current weather observation for any Australian location.
Wraps Open-Meteo's /forecast endpoint with current=... parameters
and a 15-minute cache TTL (matches Open-Meteo's own update cadence).
Use for "what's the weather right now?" — warm-cache latency < 100 ms.
Examples: resp = await latest("sydney") # curated, fast path resp = await latest("Sydney") # case-insensitive resp = await latest("Byron Bay") # geocoded resp = await latest("NSW") # state → Sydney resp = await latest("-33.87,151.21") # raw coordinates
The response's location_resolution field tells the agent how the
input was interpreted ('curated', 'state_alias', 'geocoded',
'raw_coordinates', or 'fuzzy_curated').
When to use: - "What's the weather right now in ?" — canonical use case - Multi-city current-conditions dashboards (call once per place) - Anchoring agent conversations to live weather context
Returns:
WeatherResponse with current populated, plus location metadata,
resolution source, source_url, CC-BY attribution, and server_version.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location | Yes | Any Australian location. Accepted shapes: curated ID ('sydney'), place name in any case ('Sydney', 'Byron Bay', 'Margaret River'), state code or name ('NSW', 'Queensland' → returns the capital), or raw coordinates ('-33.87,151.21'). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location_id | Yes | ||
| location_name | Yes | ||
| state | Yes | ||
| latitude | Yes | ||
| longitude | Yes | ||
| timezone | Yes | ||
| location_resolution | Yes | ||
| location_input | Yes | ||
| query | No | ||
| period | No | ||
| current | No | ||
| hourly | No | ||
| daily | No | ||
| source | No | Open-Meteo (aggregates Bureau of Meteorology data under licence) | |
| attribution | No | Weather data by Open-Meteo.com (https://open-meteo.com), licensed under CC BY 4.0. Underlying data includes the Australian Bureau of Meteorology (https://www.bom.gov.au) under Open-Meteo's licensing arrangement. | |
| source_url | Yes | ||
| retrieved_at | Yes | ||
| server_version | Yes | ||
| stale | No | ||
| stale_reason | No |