Resolve place
resolve_placeTurn a place name into the normalized entity Invokely uses, with its official codes (INE, Idescat, NUTS, ISO, US FIPS) and parent. Use it when a name is ambiguous or you want to confirm which entity a number refers to. The other tools accept names directly, so this call is optional. Ambiguous names prefer the municipality ("Barcelona" is the city); the province and region come back in alternatives. Ask for "provincia de Barcelona" to get the province. US states are regions and US counties are provinces. Names shared by several places of the same level, such as "Washington County", return an AMBIGUOUS_PLACE error with suggestions; add the state ("Washington County, Oregon") or pass a suggested id. Example: {"name": "Mataró"}. Returns {match: {id, name, level, country, population, parent, codes}, alternatives: [{id, name, level}]}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Place name or id. Examples: "Mataró", "Barcelona", "provincia de Barcelona", "Cataluña", "España", "Germany", "EU", "es-mun-08121", "08121" (INE code), "ES51" (NUTS), "Texas", "Travis County, Texas", "us-county-48453", "fips:48453" (US county FIPS). | |
| level | No | Optional preferred level. | |
| country | No | Optional ISO 3166-1 alpha-2 code to disambiguate the place, for example "ES" or "US". |