This endpoint downloads features from OpenStreetMap based on tags and optionally a bounding box, resulting in a GeoJSON.
key=value
or key=*
, and can chain tags if you need 2+ tags.
This endpoint is especially useful for extracting map data directly to user applications (like the browser)
or as a faster alternative to Overpass Turbo and the Overpass API.
key=value
to filter features for.
All features extracted will satisfy each of the passed tags given by this parameter.This tag list can be created by forming an array of key=value
items and joining
them into one string with the &
character.Because both =
and &
are reserved characters in URIs, this list must be URL encoded.An example list of tags could be leisure=park
and name=Westglen Park
. This matches parks
that have the name Westglen Park. To set this parameter,
we’ll URL encode leisure=park&name=Westglen Park
.Documentation on tags can be found on the TagInfo resource website.-108.984375,32.026706,-103.051758,37.195331
.You can create a bounding box on bboxfinder, or in shapely by
invoking the bounds
property on a geometry.Polygon
or MultiPolygon
instead, use our endpoint for downloading OSM features inside a polygon.simplify=point
, which turns
every output geometry into a single point (its centroid).This is convenient for approximating LineStrings and MultiPolygons as their
central point.Note the centroid may fall outside the original polygon, e.g. a donut’s
centroid is outside the ring.Content-Type: application/json
. The body will be a valid GeoJSON
FeatureCollection.
In the event of an error, an error response will be issued, usually with a 5xx error code.
The error will be JSON-formatted, with an error
field describing the cause.