geo_resolve
Resolve a place or code to stable canonical geography IDs.
Description
Resolve a place or code to stable canonical geography IDs.
The shared envelope echoes the query and optional filters in data.
Each bounded relevance match carries geography_id, level, official
code/name, country/state, match score/reason, bottom-up containment
parents, official outgoing crosswalks, row as_of, source, and any
required attribution. AU entities carry ABS ASGS CC BY 4.0 attribution;
US entities identify Census/OMB provenance. pagination is null because
this is a nearest-N relevance result; the limit is 1–50.
Use this first when you have a place rather than an ID, then call
geo_get, geo_contains, or geo_crosswalk. A conflicting level and
country returns bad_parameter. Example: geo_resolve(query="Sydney", country="AU", limit=10).
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | — | Free-text place, alias, postal abbreviation, or official code, such as 'Sydney', 'NSW', 'Harris County, TX', '48201', or '12420'. |
| level | "nation" | "state" | "county" | "cbsa" | "zip3" | "zcta" | "au_state" | "au_gccsa" | "au_sa4" | "au_sa3" | "au_lga" | null | No | null | — | Optional canonical geography level filter. |
| country | "US" | "AU" | null | No | null | — | Optional country filter: US or AU. |
| limit | integer | No | 10 | min 1, max 50 | Ranked matches to return (1–50). |
Provenance
Sources behind every value this tool returns.
- abs_asgsAustralian Bureau of Statistics
- census_geoU.S. Census Bureau
- census_rel2020U.S. Census Bureau
- omb_delineation_2023Office of Management and Budget (delineation lists distributed via the U.S. Census Bureau)
Dataset registry: geo_au_asgs, geo_us_reference