---
title: "world tile · RUAL Documentation"
description: "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…"
canonical: https://docs.rual.nl/block-types/openstreetmap/osmworld_tile
language: en
---

# world tile

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

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

- 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 tile was fetched successfully.

- error `v15.0.0` `value` Error message when success is `false`.

| `osm` |
| --- |
| `openstreetmap` |
| `geojson` |
| `world` |
| `tile` |
| `overpass` |
| `map` |

A typical wiring for [world tile](https://docs.rual.nl/block-types/openstreetmap/osmworld_tile): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `z` pin; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `x` pin; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `y` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the world tile block: typical wiring for world tile.](https://docs.rual.nl/canvas-examples/osmworld_tile.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).