---
title: "world bbox · RUAL Documentation"
description: "Fetch OSM world geometry for a bounding box (south,west,north,east) as GeoJSON (roads, buildings, water, greenery)."
canonical: https://docs.rual.nl/block-types/openstreetmap/osmworld_bbox
language: en
---

# world bbox

This block is part of the [`openstreetmap`](https://docs.rual.nl/block-types/openstreetmap) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

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

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

- 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](https://docs.rual.nl/block-types/openstreetmap/osmworld_bbox): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the world bbox block: typical wiring for world bbox.](https://docs.rual.nl/canvas-examples/osmworld_bbox.png)

### Used in these guides

These documentation pages use or explain this block:

- [Location Blocks](https://docs.rual.nl/reference/location-blocks)

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).