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/02-search-by-orientation.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 Surrounding POIs Based on the User's Location and Orientation

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

ParameterTypeDescription
optionsTSearchByOrientationOptions{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: