world bbox
This block is part of the openstreetmap group and was last modified in core v15.0.1.
world bbox v15.0.0 Updated v15.0.1Fetch OSM world geometry for a bounding box (south,west,north,east) as GeoJSON (roads, buildings, water, greenery).
- flow
- bbox
valuev15.0.0Bounding box as
south,west,north,east(WGS84). Takes precedence over the separate coordinate pins. - south
numberv15.0.0South latitude (used when
bboxis empty). - west
numberv15.0.0West longitude (used when
bboxis empty). - north
numberv15.0.0North latitude (used when
bboxis empty). - east
numberv15.0.0East longitude (used when
bboxis empty). - kinds
objectv15.0.0Optional array (or comma-separated value) limiting which feature kinds are returned:
road,building,water,green. Empty returns all four. - simplify
numberv15.0.0Optional Douglas–Peucker tolerance in degrees (0 = off). Simplifies roads/water/green lines and areas; buildings stay crisp.
- overpass url
valuev15.0.0Optional Overpass interpreter URL. Empty uses the public instance : set a self-hosted instance in production.
- cache ttl (s)
numberv15.0.0Disk-cache freshness in seconds. Empty/0 uses the default (7 days); negative disables caching. bbox requests are cached by a hash of the box, kinds and simplify tolerance.
- flow
- geojson
objectv15.0.0GeoJSON FeatureCollection (WGS84, lon/lat). Feed into httpconnection_set_json. Each feature carries
kind,subtype, an optionalname/height, andid(way/123,relation/456). Features are NOT clipped to the box: anything crossing the edge is returned whole in every tile it touches, so a client stitching several tiles must drop repeats byidor it draws them twice. - count
numberv15.0.0Number of features returned.
- success
conditionv15.0.0True when the box was fetched successfully.
- error
valuev15.0.0Error message when success is
false. - retryable
conditionv15.0.1True when the failure was the upstream being busy or unreachable (429/502/503/504, a transport error) and the same request may succeed later : the block already waited it out up to three attempts. False for a failure that will not change on a retry (bad coordinates, an upstream rejection), so a caller can answer 503 with a Retry-After instead of looping on a permanent error.
osm |
openstreetmap |
geojson |
world |
bbox |
overpass |
map |
A typical wiring for world bbox: a function trigger starts the flow; the flow out pin feeds debug.
Used in these guides
These documentation pages use or explain this block:
Version history
Introduced in v15.0.0.
Last modified in v15.0.1.
v15.0.1: added out-pinretryable(condition) • out-pingeojson: documentation updated
Back to
openstreetmap Return to the main group to view all sub-groups Back to world Return to the group to view all blocks within this group 