places
Find global cities and places by filtering criteria like location, population, country, or name prefix to retrieve geographic data for analysis or reference.
Instructions
Find places, filtering by optional criteria. If no criteria are set, you will get back all known places.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Only places for these types (comma-delimited): ADM2 | CITY | ISLAND | |
| location | No | Only places near this location. Latitude/longitude in ISO-6709 format: ±DD.DDDD±DDD.DDDD | |
| radius | No | The location radius within which to find places | 0 |
| distanceUnit | No | The unit of distance to use: MI | KM | |
| countryIds | No | Only places in these countries (comma-delimited country codes or WikiData ids) | |
| excludedCountryIds | No | Only places NOT in these countries (comma-delimited country codes or WikiData ids) | |
| timeZoneIds | No | Only places in these time-zones | |
| minPopulation | No | Only places having at least this population | 0 |
| maxPopulation | No | Only places having no more than this population | 0 |
| namePrefix | No | Only places whose names start with this prefix. If languageCode is set, the prefix will be matched on the name as it appears in that language. | |
| namePrefixDefaultLangResults | No | Example value: | |
| includeDeleted | No | Whether to include any places marked deleted: ALL | SINCE_YESTERDAY | SINCE_LAST_WEEK | NONE | |
| languageCode | No | Display results in this language | |
| asciiMode | No | Example value: | |
| hateoasMode | No | Example value: | |
| limit | No | The maximum number of results to retrieve | 0 |
| offset | No | The zero-ary offset into the results | 0 |
| sort | No | How to sort the results. Format: ±SORT_FIELD,±SORT_FIELD where SORT_FIELD = countryCode | elevation | name | population |