world bbox

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

world bbox v15.0.0

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

    GeoJSON FeatureCollection (WGS84, lon/lat). Feed into httpconnection_set_json.

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

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.


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