latest
Retrieve current weather observations for any Australian location. Supports curated IDs, place names, state aliases, or coordinates for instant results.
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 |
|---|---|---|---|
| daily | No | ||
| query | No | ||
| stale | No | ||
| state | Yes | ||
| hourly | No | ||
| period | No | ||
| source | No | Open-Meteo (aggregates Bureau of Meteorology data under licence) | |
| current | No | ||
| latitude | Yes | ||
| timezone | Yes | ||
| longitude | Yes | ||
| source_url | Yes | ||
| 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. | |
| location_id | Yes | ||
| retrieved_at | Yes | ||
| stale_reason | No | ||
| location_name | Yes | ||
| location_input | Yes | ||
| server_version | Yes | ||
| location_resolution | Yes |