POI Category tree

The Point of Interest (POI) Categories service endpoint provides the full list of POI categories and subcategories together with their translations and synonyms available in Search API, see POI Categories (https://developer.tomtom.com/search-api/documentation/poi-categories-service/poi-categories) for more information. Thanks to that list, you do not have to hardcode categories in your app as they change dynamically. Once you have the POI Category ID, you can use it as a filter (categorySet) in search quires.

Sample use case: You want to display a dynamic list of all available categories and subcategories that can be used for a search combined with the appropriate filters.

Use the following code snippet to try this in your app:

PoiCategoriesSpecification poiCategoriesSpecification = new PoiCategoriesSpecification("en-GB")
searchAPI.poiCategoriesSearch(poiCategoriesSpecification, poiCategoriesCallback);

    val poiCategoriesSpecification = PoiCategoriesSpecification("en-GB")
searchApi.poiCategoriesSearch(poiCategoriesSpecification, callback)

The following is an example application view utilizing POI Category Search.