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.1

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

In pins 9 + flow
  • flow
  • bbox value v15.0.0

    Bounding box as south,west,north,east (WGS84). Takes precedence over the separate coordinate pins.

  • south number v15.0.0

    South latitude (used when bbox is empty).

  • west number v15.0.0

    West longitude (used when bbox is empty).

  • north number v15.0.0

    North latitude (used when bbox is empty).

  • east number v15.0.0

    East longitude (used when bbox is empty).

  • kinds object v15.0.0

    Optional array (or comma-separated value) limiting which feature kinds are returned: road, building, water, green. Empty returns all four.

  • simplify number v15.0.0

    Optional Douglas–Peucker tolerance in degrees (0 = off). Simplifies roads/water/green lines and areas; buildings stay crisp.

  • overpass url value v15.0.0

    Optional Overpass interpreter URL. Empty uses the public instance : set a self-hosted instance in production.

  • cache ttl (s) number v15.0.0

    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
  • geojson object v15.0.0

    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 number v15.0.0

    Number of features returned.

  • success condition v15.0.0

    True when the box was fetched successfully.

  • error value v15.0.0

    Error message when success is false.

  • retryable condition v15.0.1

    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.

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.

Studio canvas example for the world bbox block: typical wiring for world bbox.

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-pin retryable (condition) • out-pin geojson: 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