ensureResultsPerCategory

When set to true and multiple categories are requested, e.g. SearchEngine.search(listOf("coffee_shop", "hotel"), ...), results will include at least one POI for each category, provided a POI is available in a nearby location.

A comma-separated list of multiple category values in the request determines the sort order of the POI result. For example, for request SearchEngine.search(listOf("coffee_shop", "hotel"), ...), coffee_shop POI will be listed first in the results.

If there is more than one POI for categories, the number of search results will include multiple features for each category. For example, assuming that restaurant, coffee, parking_lot categories are requested and limit parameter is 10, the result will be ranked as follows:

  • 1st to 4th: restaurant POIs

  • 5th to 7th: coffee POIs

  • 8th to 10th: parking_lot POI