- 00 - The Beginning
- 01 - Finding nodes with a bounding box
- 02 - Outputting data about nodes
- 03 - Filtering nodes that have a tag
- 04 - Find nodes by matching tags and their values
- 05 - Find nodes by applying multiple filters
- 06 - Extracting multiple sets of nodes
- 07 - Calculating differences between results
- 08 - Generating JSON output
- 09 - Generating CSV output
- 10 - The default set
- 11 - Querying a set
- 12 - Searching within a radius using around
- 13 - Using around to filter against a set of results
- 14 - Searching by polygon
- 15 - Finding ways
- 16 - Ways and their nodes
- 17 - Ways and their tags
- 18 - Combining node and way queries
- 19 - Finding ways from their nodes
- 20 - Finding relations
- 21 - Type agnostic queries (nwr)
- 22 - Areas
- 23 - Finding the areas enclosing a feature
- 24 - Find the area derived from a feature
- 25 - Areas via Nominatim search
- 26 - Timeouts and endpoints
12 - Searching within a radius using around
OverpassQL allows us to perform some basic spatial queries.
We've already explored various ways to query for nodes within a bounding box.
We can also search for nodes or other features that can be found within a circular
area using the
This filter uses curved brackets (
()). Only tag filters use square brackets (
The simplest form of this filter accepts a distance (in meters) and a latitude and longitude. This point and distance describe the centre of a circle and its radius.
The results are then filtered to features that are within that search area.
This example query finds nodes tagged as caves that are within 800m of the peak of Uluṟu. There is a single result, which is a cave called Tjilpi Pampa Kulpi.
Notice that we don't define a bounding box for this particular query. Our area
of interest is specified by the
There are more complex ways that we can use the
Instead of searching within a circle, we can instead query for nodes that can be found near to a line. To use this variant, we would need to specify multiple latitude/longitude pairs that define the line we are interested in. An example is shown in the query for you to try.
An even more useful version of
around is shown in the next example.