> 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 within a Floor

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

service.searchByFloors(
    {
        floorIds: ['2cdd6174730d4431b1aa730eda596ed4'],
        orderBy: MapxusMap.PoisOrderBy.DEFAULT_NAME,
        offset: 50,
    }
);
```

**Parameters**

| Parameter | Type                   | Description                                                                                                 |
| --------- | ---------------------- | ----------------------------------------------------------------------------------------------------------- |
| options   | TSearchByFloorsOptions | \{floorIds, keywords?, orderBy?, offset?, page?} or \{sharedFloorIds,  keywords?, orderBy?, offset?, page?} |

- **floorIds / sharedFloorIds**(type string, required): One of floorId and sharedFloorId.
- **keywords**(type string, optional): POI name keyword.
- **orderBy**(type MapxusMap.PoisOrderBy, optional): POIs' order, **cannot be used with 'keywords' at the same time**. Available values: MapxusMap.PoisOrderBy.DEFAULT\_NAME
- **offset**(type number, optional): Quantity per page, the maximum is 100, default is 10.
- **page**(type number, optional): Results for specified page number. Default is 1.

> **Special Note:** The parameter 'offset' has limitations, the maximum value for each request must not exceed **100**. If you need to request more than 100 records of data, please make paginated requests.

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