Find a place
find_placeCandidate coordinates for a place name or address, best match first, each with its full name and kind (city, state, road and so on).
Call it when a name is ambiguous (several Springfields) and the right candidate must be chosen, or when one place is the subject of several calls and its coordinates should be looked up once. The other place tools take a name themselves and use its best match, so a single question about an unambiguous place needs no find_place first.
It queries OpenStreetMap Nominatim (ODbL) through Criora's geocoder, which every user shares and which sends one request a second: a burst of calls waits its turn, and a name looked up in the last week is answered from a cache. A name that matches nothing returns an empty list. A city resolves to its centre as OpenStreetMap maps it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many candidates to return | |
| query | Yes | A place name or address, in any language |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |