For AI agents: the complete documentation index is available at /core-sdk/map/web/llms.txt, the full documentation bundle is available at /core-sdk/map/web/llms-full.txt, and this page is available as Markdown at /core-sdk/map/web/v10/07-poi-search/09-search-by-category.md.
MapxusDeveloper Platform
Products
Positioning APIAccess real-time indoor coordinates and contextual signals.API
UI SDKProduction-ready indoor map interfaces and UI components.AndroidiOS

Search POIs by Category or Excluding Categories

// Sample Usage
const service = new MapxusMap.PoisService();

service.searchByCategory(
	{
		category: 'shopping.clothes',
		center: [114.1113792, 22.3707381],
		distance: 40
	}
);
// or
service.searchByCategory(
    {
	    excludedCategories: 'shopping.clothes', // ['shopping.clothes', 'restaurants.cafes']
	    center: [114.1113792, 22.3707381],
	    distance: 40
    }
);

Parameters

ParameterTypeDescription
optionsTSearchByCategoryOptions{category, center, distance, offset?, page?} or {excludedCategories, center, distance, offset?, page?}
  • category(type string, required): The POIs of category to search.
  • excludedCategories(type string | string[], required): Search POIs excluded the categories.

Returns TPromisePois<IPoi | ISharedPoi> IPoi:

  • floor
  • floorId
  • accessibilityDetail
  • category
  • descriptions
  • distance?
  • id
  • location
  • name
  • osmRefId
  • poiId
  • buildingId
  • venueId

ISharedPoi:

  • sharedFloorId
  • sharedFloorNames
  • accessibilityDetail
  • category
  • descriptions
  • distance?
  • id
  • location
  • name
  • osmRefId
  • poiId
  • buildingId
  • venueId

Sample web page: