compare_locations
Compare current weather across multiple Australian locations simultaneously. Each location is resolved independently; failures return errors without affecting other results.
Instructions
Compare current weather across multiple Australian locations in one call.
Fans out concurrently via asyncio.gather, so all locations come back in
roughly the time of a single call (after the cache is warm). Each location
is independently resolved (curated / state / postcode / geocode / etc.) and
independently fetched. If one location fails (e.g. geocoder can't find it),
that row gets an error field while the rest still return.
Examples: # Capital-city dashboard resp = await compare_locations(["sydney","melbourne","brisbane","perth"]) for row in resp.locations: print(row.location_name, row.current.temperature_c)
# Tropical north today
resp = await compare_locations(["Cairns","Darwin","Townsville","Broome"])
# Mixed input shapes work
resp = await compare_locations(["sydney","NSW","2026","-33.87,151.21"])When to use: - "Compare weather in " — the canonical use case - Build a multi-region dashboard in one tool call - Plan a holiday across regions
Returns:
ComparisonResponse with one ComparisonRow per input location.
Successful rows have current populated; failed rows have error.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locations | Yes | Two to ten Australian locations to compare side-by-side. Each entry accepts the same shapes as latest(): curated ID, place name, state, postcode, or 'lat,lng'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | Yes | ||
| source | No | Open-Meteo (aggregates Bureau of Meteorology data under licence) | |
| locations | 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. | |
| retrieved_at | Yes | ||
| server_version | Yes |