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

# Search POIs by Category or Excluding Categories

```js
// 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**

| Parameter | Type                     | Description                                                                                              |
| --------- | ------------------------ | -------------------------------------------------------------------------------------------------------- |
| options   | TSearchByCategoryOptions | \{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:

<iframe src="https://map-service.mapxus.com/bssww/poiSearchByCategory" width="100%" height="550px"></iframe>