place density

This block is part of the places group and was last modified in core v15.0.0.

place density number v15.0.0

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.

In pins 3

geo point geo_point required v15.0.0
Centre of the measurement.
radius (m) number v15.0.0
Measurement radius in metres. Empty uses 500.
categories array v15.0.0
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.

Out pins 8

total number v15.0.0
Places within the radius, after deduplication.
raw total number v15.0.0
Underlying records before deduplication.
per km² number v15.0.0
Places per square kilometre : the figure the classification is based on.
by group object v15.0.0
Count per category group.
top groups array v15.0.0
Category groups ordered by count, most common first.
classification value v15.0.0
dense_urban, urban, suburban or rural.
success condition v15.0.0
True when the query ran. An empty result is still a success.
error value v15.0.0
Error code when the query could not run: PLACES_NOT_AVAILABLE, GEO_POINT_MISSING_LAT_OR_LON.

A typical wiring for place density: from city feeds the geo_point pin; the total out pin feeds cast to value.

Used in these guides

These documentation pages use or explain this block:

Version history

Introduced in v15.0.0.

Back to places Return to the main group to view all sub-groups Back to Places Return to the group to view all blocks within this group