---
title: "place density · RUAL Documentation"
description: "Measures how built-up the area around a point is: how many places sit within the radius, the rate per km², a breakdown per category, and a classificatio…"
canonical: https://docs.rual.nl/block-types/places/places_density
language: en
---

# place density

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

Measures how built-up the area around a point is: how many places sit within the radius, the rate per km², a breakdown per category, and a classification (`dense_urban`, `urban`, `suburban`, `rural`). The classification is driven by the per-km² rate rather than the raw count, so it does not change when you change the radius. Data is Overture Maps Places.

- geo point required `v15.0.0` `geo_point` Centre of the measurement.

- radius (m) `v15.0.0` `number` Measurement radius in metres. Empty uses 500.

- categories `v15.0.0` `array` Array or comma-separated list of category groups. Accepts group ids (`primary_education`) or Dutch synonyms (`basisschool`, `kroegen`). Empty searches every category. Use `places_categories` to list them.

- total `v15.0.0` `number` Places within the radius, after deduplication.

- raw total `v15.0.0` `number` Underlying records before deduplication.

- per km² `v15.0.0` `number` Places per square kilometre : the figure the classification is based on.

- by group `v15.0.0` `object` Count per category group.

- top groups `v15.0.0` `array` Category groups ordered by count, most common first.

- classification `v15.0.0` `value` `dense_urban`, `urban`, `suburban` or `rural`.

- success `v15.0.0` `condition` True when the query ran. An empty result is still a success.

- error `v15.0.0` `value` Error code when the query could not run: `PLACES_NOT_AVAILABLE`, `GEO_POINT_MISSING_LAT_OR_LON`.

### Core Releases