world bbox

This block is part of the openstreetmap group and was last modified in core v15.0.1.

world bbox object v15.0.0 Updated v15.0.1

Fetch OSM world geometry for a bounding box (south,west,north,east) as GeoJSON (roads, buildings, water, greenery).

In pins 9 + flow

flow
flow
bbox v15.0.0
value
Bounding box as south,west,north,east (WGS84). Takes precedence over the separate coordinate pins.
south v15.0.0
number
South latitude (used when bbox is empty).
west v15.0.0
number
West longitude (used when bbox is empty).
north v15.0.0
number
North latitude (used when bbox is empty).
east v15.0.0
number
East longitude (used when bbox is empty).
kinds v15.0.0
object
Optional array (or comma-separated value) limiting which feature kinds are returned: road, building, water, green. Empty returns all four.
simplify v15.0.0
number
Optional Douglas–Peucker tolerance in degrees (0 = off). Simplifies roads/water/green lines and areas; buildings stay crisp.
overpass url v15.0.0
value
Optional Overpass interpreter URL. Empty uses the public instance : set a self-hosted instance in production.
cache ttl (s) v15.0.0
number
Disk-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.

Out pins 5 + flow

flow
flow
geojson v15.0.0
object
GeoJSON FeatureCollection (WGS84, lon/lat). Feed into httpconnection_set_json. Each feature carries kind, subtype, an optional name/height, and id (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 by id or it draws them twice.
count v15.0.0
number
Number of features returned.
success v15.0.0
condition
True when the box was fetched successfully.
error v15.0.0
value
Error message when success is false.
retryable v15.0.1
condition
True 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.