Retrieve the list of POI category types supported by the TomTom Search API.
The returned code values (POICategory) serve two purposes:
Pass to discoverPlaces({ filters: { poiCategories } }) to filter search results by category.
Pass as POIsModulefilters.categories to filter the map's built-in POI icons.
Generic parent codes (e.g. 'RESTAURANT') are supported there; overly specific child
codes (e.g. 'ITALIAN_RESTAURANT') are not — use a parent or a POICategoryGroup instead.
Results are cached in memory per language. The first call fetches from the API;
all subsequent calls — including filtered ones — are served from the cache.
// All categories const { poiCategories: all } = awaitgetPOICategories();
// Filtered by keyword, best match first const { poiCategories: gyms } = awaitgetPOICategories({ filters: ['gym'] }); gyms.forEach(c=>console.log(c.code, c.name, c.childCategoryCodes));
Retrieve the list of POI category types supported by the TomTom Search API.
The returned
codevalues (POICategory) serve two purposes:discoverPlaces({ filters: { poiCategories } })to filter search results by category.POIsModulefilters.categoriesto filter the map's built-in POI icons. Generic parent codes (e.g.'RESTAURANT') are supported there; overly specific child codes (e.g.'ITALIAN_RESTAURANT') are not — use a parent or aPOICategoryGroupinstead.Results are cached in memory per language. The first call fetches from the API; all subsequent calls — including filtered ones — are served from the cache.