places within radius

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

places within radius array v15.0.0

Returns every point of interest inside a radius, nearest first. Reports both count and raw_count: Overture is not conflated, so the gap between them is how much duplication the source data carries at this spot. Treat count as a deduplicated search result, not a census : train_station totals 1,432 nationally against roughly 400 real stations. Data is Overture Maps Places.

In pins 7

geo point geo_point required v15.0.0
Centre of the search.
radius (m) number required v15.0.0
Search radius in metres.
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.
limit number v15.0.0
Maximum number of results. Empty uses 100.
sort value v15.0.0
distance (default), confidence or name.
min confidence number v15.0.0
Drop results below this Overture confidence (0–1). The signal is uncalibrated : median 0.80 across the Dutch dataset : so filtering may hide coverage as easily as it removes noise. Empty applies no filter.
dedup condition v15.0.0
Collapse duplicate records for the same real place. On by default: Overture is not conflated, so one station can appear three times under name variants (Station Breda Centraal, Gare de Bréda, NS Station Breda). Merged results report merged_count and merged_names.

Out pins 6

results array v15.0.0
Matching places. Each carries id, name, category_group, geo_point, distance_m, confidence, address, website, phone and merged_count.
count number v15.0.0
Number of results returned, after deduplication.
raw count number v15.0.0
Number of underlying records before deduplication. A large gap against count means the source data holds several records for the same real place here.
truncated condition v15.0.0
True when limit cut the result short, so there are more matches than were returned.
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, RADIUS_REQUIRED.

A typical wiring for places within radius: from city feeds the geo_point pin; number feeds the radius_m pin; the results out pin feeds length.

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