world tile

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

world tile object v15.0.0 Updated v15.0.1

Fetch OSM world geometry for a slippy-map tile (z/x/y) as GeoJSON (roads, buildings, water, greenery). Recommended zoom: 15. Geometry is simplified per zoom (buildings stay crisp at z≥15).

In pins 6 + flow

flow
flow
z (zoom) required v15.0.0
number
Slippy-map zoom level (1–22). Recommended: 15.
x required v15.0.0
number
Slippy-map tile column.
y required v15.0.0
number
Slippy-map tile row.
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.
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. Tiles are cached per z/x/y under the configured osmworld cache path.

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

osm

openstreetmap

geojson

world

tile

overpass

map

A typical wiring for world tile: a function trigger starts the flow; number feeds the z pin; number feeds the x pin; number feeds the y pin; the flow out pin feeds debug.

Used in these guides

These documentation pages use or explain this block:

Location Blocks

Version history

Introduced in v15.0.0.

Last modified in v15.0.1.

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