parse places query

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

parse places query value v15.0.0

Turns typed Dutch or English into a structured filter. binnen 300m van een basisschool becomes a proximity filter; niet bij scholen becomes a negated one; minimaal 3 kroegen binnen 500m carries a minimum count; wijk Jordaan and Station Breda resolve to a location. Feed filter into places_match, places_filter or places_facet. Parsing is rule-based and deterministic : no model call and no network. It never guesses silently: anything it could not read comes back in unparsed with a lower confidence, so you can fall back to plain search instead of acting on a half-understood filter.

In pins 4

query value required v15.0.0
What the user typed.
language value v15.0.0
auto (default), nl or en. Both languages are recognised either way.
default radius (m) number v15.0.0
Radius assumed when the query implies nearness without naming a distance, e.g. bij een school. Empty uses 500.
near geo_point v15.0.0
Bias place and area resolution towards this point.

Out pins 13

kind value v15.0.0
proximity (a filter), place or area (a location), or text (nothing recognised).
filter object v15.0.0
The whole structured filter. Wire this straight into places_match, places_filter or places_facet.
negated condition v15.0.0
True when the query excludes rather than requires, e.g. niet bij scholen.
category group value v15.0.0
The resolved category group id.
category label value v15.0.0
The Dutch label for that group, for showing back to the user.
radius (m) number v15.0.0
The distance the query asked for, or the default when it implied nearness without a number.
min count number v15.0.0
Minimum number required, from phrases like minimaal 3. Normally 1. Strict phrasings are read strictly: meer dan 3 asks for 4, while minstens 3 and 3+ ask for 3.
geo point geo_point v15.0.0
The resolved coordinate for a place or area query. Empty for a proximity filter.
place name value v15.0.0
The name of the resolved place or area.
confidence number v15.0.0
How much of the query was understood, 0–1. Below about 0.6 means text was left over : check unparsed.
unparsed value v15.0.0
Any part of the query that was not recognised. Never silently dropped, so you can decide whether to fall back to plain search.
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, QUERY_REQUIRED.

A typical wiring for parse places query: value feeds the query pin; the kind out pin feeds convert to uppercase.

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