world tile

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

world tile 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
  • z (zoom) number required v15.0.0

    Slippy-map zoom level (1–22). Recommended: 15.

  • x number required v15.0.0

    Slippy-map tile column.

  • y number required v15.0.0

    Slippy-map tile row.

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

  • 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. Tiles are cached per z/x/y under the configured osmworld cache path.

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

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

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