places_near_location
Find cities, islands, or administrative areas near a specified location by filtering with criteria like population, country, distance, and name prefixes.
Instructions
Get places near the given location, filtering by optional criteria.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Only places for these types (comma-delimited): ADM2 | CITY | ISLAND | |
| radius | Yes | The location radius within which to find places | |
| 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: | |
| languageCode | No | Display results in this language | |
| asciiMode | No | Example value: | |
| hateoasMode | No | Example value: | |
| includeDeleted | No | Whether to include any places marked deleted: ALL | SINCE_YESTERDAY | SINCE_LAST_WEEK | NONE | |
| 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 | |
| locationid | Yes | Only cities near this location. Latitude/longitude in ISO-6709 format: ±DD.DDDD±DDD.DDDD |