> 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 Surrounding POIs Based on the User's Location and Orientation

```js
// Sample Usage
const service = new MapxusMap.PoisService();
const angle = 10;
const buildingId = 'vivocity_foshan_d3fmv9';
const center = [113.1820529763915, 23.035507036556652];
const distance = 50;
const distanceSearchType = 'Point';
const floorId = '9b7e40e7862d4b1cb174ad4661b175e1';
const ordinal = "0";

service.searchByOrientation(
    {
        center,
        angle,
        distance,
	    distanceSearchType,
        floorId, // or buildingId/ordinal
    }
);
```

**Parameters**

| Parameter | Type                        | Description                                                                                                                                                                                                                         |
| --------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| options   | TSearchByOrientationOptions | \{buildingId, center, angle, distance, distanceSearchType?, offset?, page?} or \{floorId, center, angle, distance, distanceSearchType?, offset?, page?} or \{ordinal, center, angle, distance, distanceSearchType?, offset?, page?} |

- **buildingId / floorId / ordinal**(type string, required): One of buildingId, floorId and ordinal.
- **center**(type \[number, number], required): User's position, \[lng, lat].
- **angle**(type number, required): The angle between the user's orientation and true north.
- **distance**(type number, required): The radius with 'center' as the center of the circle.
- **distanceSearchType**(type DistanceSearchType, optional): The type of POI, default is 'Point'.
- **offset**(type number, optional): quantity per request, default is 10.
- **page**(type number, optional): page number, default is 1.

> **Special Note:** (1) Parameter 'distance' cannot exceed **10,000**.
> (2) This API returns a maximum of **100** records.
> (3) Search priority: ordinal > floorId > buildingId.

**Returns** `TPromiseOrientationPois`
IOrientationNormalPoi:

- floor
- floorId
- angle
- category
- descriptions
- distance
- distanceSource
- id
- location
- name
- osmRefId
- poiId
- buildingId

IOrientationSharedPoi:

- sharedFloorId
- sharedFloorNames
- angle
- category
- descriptions
- distance
- distanceSource
- id
- location
- name
- osmRefId
- poiId

Sample web page:

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