---
title: "resolve place category · RUAL Documentation"
description: "Resolves free text such as kroeg, basisschool or supermarkt to a category group id. Regular plurals are handled, so kroegen and bars work without being…"
canonical: https://docs.rual.nl/block-types/places/places_resolve_category
language: en
---

# resolve place category

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

Resolves free text such as `kroeg`, `basisschool` or `supermarkt` to a category group id. Regular plurals are handled, so `kroegen` and `bars` work without being listed. When a word spans several groups : `school` is the obvious case : the alternatives are returned rather than one being picked silently, because only you know which was meant.

- text required `v15.0.0` `value` The category name to resolve.

- language `v15.0.0` `value` `nl` (default) or `en`. Both are recognised either way.

- group `v15.0.0` `value` The resolved group id. Empty when nothing matched.

- label `v15.0.0` `value` The Dutch label for that group.

- confidence `v15.0.0` `number` 1.0 for an exact synonym match, lower when only part of the text matched, 0 when nothing did.

- alternatives `v15.0.0` `array` Other groups the text could mean. Show these when the word is ambiguous instead of guessing.

- 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`, `TEXT_REQUIRED`.

### Core Releases