@mapxus/mapxus-map-jp 7.1.0 → 7.3.0

package/index.d.ts

@@ -1,7 +1,7 @@
 // Generated by dts-bundle-generator v6.13.0
 
 import { AxiosPromise } from 'axios';
-import { ControlPosition, FilterSpecification, GeoJSONFeature, IControl, LngLat, Map as MaplibreMap, Map as maplibreMap, MapGeoJSONFeature, MapLayerEventType, PointLike } from 'maplibre-gl';
+import { ControlPosition, FilterSpecification, IControl, LngLat, Map as MaplibreMap, Map as maplibreMap, MapGeoJSONFeature, MapLayerEventType, PaddingOptions, PointLike, RequireAtLeastOne } from 'maplibre-gl';
 
 export declare enum ThemeType {
 	CHRISTMAS = "christmas",
@@ -36,20 +36,52 @@ export interface IMapOption {
 	secret: string;
 	enableFloorControl?: boolean;
 	enableBuildingSelector?: boolean;
+	/**
+	 * @description 'venueId', 'buildingId', 'floorId', 'poiId' are mutually exclusive,
+	 * the priority is: poiId > floorId > buildingId > venueId.
+	 */
 	venueId?: string;
+	/**
+	 * @description 'venueId', 'buildingId', 'floorId', 'poiId' are mutually exclusive,
+	 * the priority is: poiId > floorId > buildingId > venueId.
+	 */
 	buildingId?: string;
+	/**
+	 * @description 'venueId', 'buildingId', 'floorId', 'poiId' are mutually exclusive,
+	 * the priority is: poiId > floorId > buildingId > venueId.
+	 */
 	floorId?: string;
 	/**
-	 * @deprecated "floor" is deprecated, please use "floorId" instead
+	 * @description Initialize the map with POI as the center point, use it with maplibregl.Map 'zoom' option.
+	 * 'venueId', 'buildingId', 'floorId', 'poiId' are mutually exclusive,
+	 * the priority is: poiId > floorId > buildingId > venueId.
 	 */
-	floor?: string;
 	poiId?: string;
 	hiddenOutdoor?: boolean;
 	theme?: ThemeType;
 	collapseCopyright?: boolean;
 	selectedBuildingBorderStyle?: ISelectedBuildingBorderStyle;
 	floorsControlStyle?: IFloorsControlStyle;
+	/**
+	 * @description Switch floors by venue/building, default by venue.
+	 */
 	floorSwitchMode?: FloorSwitchMode;
+	/**
+	 * @description Whether unselected buildings are masked, default is false.
+	 */
+	maskNonSelectedAreas?: boolean;
+	/**
+	 * @description Whether the boundary of the selected building fits the screen, default is false.
+	 * Can only be used for 'floorId', 'buildingId' and 'venueId' initialization, not for 'poiId'.
+	 * When it is true, the 'boundsPadding' option is valid, and the 'zoom' option of maplibregl.Map is invalid.
+	 */
+	fitBuildingBounds?: boolean;
+	/**
+	 * @description The amount of padding in pixels to add to the given bounds, default is 30.
+	 * Requires 'fitBuildingBounds' to be 'true'.
+	 * Parameter value ref to: https://maplibre.org/maplibre-gl-js/docs/API/types/maplibregl.PaddingOptions/
+	 */
+	boundsPadding?: number | RequireAtLeastOne<PaddingOptions>;
 }
 export type Listener = (param: Object) => any;
 declare class DefinedEvent {
@@ -123,8 +155,6 @@ export declare class Indoor extends Evented {
 	private _ordinal;
 	private _floorId;
 	private _floorName;
-	private _buildingFloors;
-	private _buildingOrdinals;
 	private _enableSwitch;
 	private _enableSwitchBuilding;
 	private _isHiddenOutdoor;
@@ -132,16 +162,23 @@ export declare class Indoor extends Evented {
 	private _hasCustomLevelFill;
 	private _curVenueId;
 	private _curVenueFeature;
-	private _footprints;
-	private readonly _displayLevelSet;
-	private _curVenueLevelMap;
-	private _curBuildingLevelMap;
-	private _isSelectBuildingByClickMap;
+	private _ordinalHistory;
 	private _buildingHighlightStyle;
 	private readonly _floorSwitchMode;
-	private readonly _initBuilding;
+	private _maskNonSelectedAreas;
+	private _isSelectBuildingByClickMap;
+	private readonly _hiddenBuildings;
+	private _lowerLayers;
+	private _upperLayers;
+	private _commonLayers;
+	private _upperBuildingIds;
+	private _lowerBuildingIds;
+	private _upperLevelIds;
+	private _lowerLevelIds;
 	private _dispatch;
-	constructor(map: maplibreMap, isHiddenOutdoor?: boolean, floorSwitchMode?: FloorSwitchMode, initBuilding?: string);
+	private readonly _fitBuildingBounds;
+	private readonly _boundsPadding;
+	constructor(map: maplibreMap, isHiddenOutdoor: boolean, floorSwitchMode: FloorSwitchMode, fitBuildingBounds: boolean, boundsPadding: number | RequireAtLeastOne<PaddingOptions>);
 	/**
 	 * @description Turn on indoor-outdoor switching.
 	 */
@@ -158,48 +195,6 @@ export declare class Indoor extends Evented {
 	 * @description Turn off building-building switching.
 	 */
 	disableSwitchBuilding(): this;
-	/**
-	 * @description Get a list of floors of the selected building
-	 * @deprecated You can use "indoor.building" instead
-	 * @returns {string[]}
-	 */
-	get floors(): string[];
-	/**
-	 * @description Get the selected building's ordinal list
-	 * @deprecated You can use "indoor.building" instead
-	 * @return {string[]}
-	 */
-	get ordinals(): string[];
-	/**
-	 * @description Get the selected building's id
-	 * @deprecated You can use "indoor.building" instead
-	 * @returns {string}
-	 */
-	get buildingId(): string;
-	/**
-	 * @description Get current floor of the selected building
-	 * @deprecated You should use "indoor.floor" instead
-	 * @returns {string | null}
-	 */
-	get currentFloor(): string | null;
-	/**
-	 * @description Get current ordinal of selecting building
-	 * @deprecated you should use "indoor.floor" instead
-	 * @returns {string | null}
-	 */
-	get ordinal(): string | null;
-	/**
-	 * @description Get current venueId
-	 * @deprecated You should use the new getter 'venue' instead
-	 * @returns {string | null}
-	 */
-	get venueId(): string | null;
-	/**
-	 * @description Get current floor id
-	 * @deprecated You can use "indoor.floor" instead
-	 * @returns {string | null}
-	 */
-	get floorId(): string | null;
 	/**
 	 * @description Get the current floor's information.
 	 */
@@ -220,44 +215,29 @@ export declare class Indoor extends Evented {
 	get features(): MapGeoJSONFeature[];
 	/**
 	 * @description Get specified feature of bbox by id.
+	 * @deprecated Use 'getFeaturesById' instead.
 	 * @param id
 	 * @return {MapGeoJSONFeature | undefined}
 	 */
 	getFeature(id: string): MapGeoJSONFeature | undefined;
 	/**
-	 * @description Get building feature at the point
-	 * @deprecated You can use "map.onMapClickListener" instead
-	 * @param point {PointLike}
-	 * @return {MapGeoJSONFeature | null}
+	 * @description Get features from bbox by id.
+	 * @param id
 	 */
-	getBuildingByPoint(point: PointLike): MapGeoJSONFeature | null;
+	getFeaturesById(id: string): MapGeoJSONFeature[];
 	/**
 	 * @description Get level feature at the point
 	 * @param point
 	 * @return {MapGeoJSONFeature | null}
 	 */
 	getLevelByPoint(point: PointLike): MapGeoJSONFeature | null;
-	/**
-	 * @description Pan to and select a building by buildingId and floorId
-	 * @deprecated You should use the "panToBuilding" instead
-	 * @param buildingId {string}
-	 * @param floorId {string}
-	 * @param callback
-	 */
-	goToBuilding(buildingId: string, floorId?: string, callback?: (feature: MapGeoJSONFeature) => void): void;
 	/**
 	 * @description Map pan to the building center and select the building.
 	 * @param buildingId
 	 * @param floorId
 	 * @param callback
 	 */
-	panToBuilding(buildingId: string, floorId?: string, callback?: (feature: MapGeoJSONFeature) => void): void;
-	/**
-	 * @description Switch floor by ordinal
-	 * @deprecated You should use the "switchFloorByOrdinal" instead
-	 * @param ordinal {string}
-	 */
-	switchFloor(ordinal: string): void;
+	panToBuilding(buildingId: string, floorId?: string, callback?: (feature: MapGeoJSONFeature) => void): Promise<void>;
 	/**
 	 * @description Switch floor by ordinal.
 	 * @param ordinal
@@ -272,6 +252,7 @@ export declare class Indoor extends Evented {
 	 * @description Update map layout.
 	 */
 	updateLayers(): void;
+	updateRendering(): void;
 	/**
 	 * @description Filter indoor layers.
 	 */
@@ -281,6 +262,11 @@ export declare class Indoor extends Evented {
 	 * @param style {ISelectedBuildingBorderStyle | null}
 	 */
 	setSelectedBuildingBorderStyle(style: ISelectedBuildingBorderStyle | null): void;
+	/**
+	 * @description Set whether to cover the unselected venues/buildings.
+	 * @param mask Default is false.
+	 */
+	setMaskNonSelectedAreas(mask: boolean): void;
 	/**
 	 * @description Listen for the indoor map state, including the changes of venue, building and floor.
 	 * @param listener
@@ -294,12 +280,10 @@ export declare class Indoor extends Evented {
 	};
 	/**
 	 * @description Select a building feature
-	 * @deprecated Use map.selectBuildingById instead
 	 * @param feature {MapGeoJSONFeature | null}
 	 * @param floorId {string}
 	 */
 	selectBuilding(feature?: MapGeoJSONFeature | null, floorId?: string): void;
-	private _selectBuilding;
 	private _getBuildingByPoint;
 	private _getConditionsExpression;
 	private _loadData;
@@ -312,37 +296,43 @@ export declare class Indoor extends Evented {
 	private _getFeatures;
 	private _getBuildingFloorByOrdinal;
 	private _getBuildingFloorByFloorId;
-	private _getBuildingFloorsAndOrdinals;
+	private _getBuildingInitFloor;
 	private _isNotCurrentFeature;
 	private _setOutdoorLayersHidden;
 	private _addCustomLevelFillLayer;
 	private _setIndoorState;
-	private _setBuildingHighlight;
+	private _setBuildingLineOpacity;
 	private _addBuildingHighlightLayer;
 	private _filterBuildingHighlight;
-	private _addDisplayLevels;
-	private _removeDisplayLevels;
+	private _addHiddenBuilding;
+	private _deleteHiddenBuilding;
 	private _setDisplayLevels;
-	private _cacheCurVenueLevels;
-	private _cacheCurBuildingLevels;
-	/**
-	 * @description priority: history > default_displayed_floor > ordinal equal to or closest to 0
-	 * @param building
-	 * @private
-	 */
-	private _getBuildingOrdinal;
-	private _getFloorIdByOrdinal;
-	/**
-	 * @description 判断当前 building 是否为隐藏式 building，即点击的 building 无显示元素
-	 * @param building
-	 * @private
-	 */
-	private _isHiddenBuilding;
+	private _configMaskVenueMode;
+	private _configMaskBuildingMode;
+	private _configVenueMode;
+	private _configBuildingMode;
+	private _getVenueOriginOrdinal;
+	private _getBuildingOriginOrdinal;
 	private _isVenueMode;
-	private _getDisplayLevelsByVenueMode;
-	private _getDisplayLevelsByBuildingMode;
-	private _getUnselectedVenueOrdinal;
-	private _getBuildingFloor;
+	private _setVenueOrdinalHistory;
+	private _getVenueOrdinalHistory;
+	private _setBuildingOrdinalHistory;
+	private _getBuildingOrdinalHistory;
+	private _getVenuesOfBbox;
+	private _getBuildingsOfBbox;
+	private _copyOverlapLayers;
+	private _layerBuildings;
+	private _addBuildingToUpper;
+	private _deleteBuildingFromUpper;
+	private _addBuildingToLower;
+	private _deleteBuildingFromLower;
+	private _addLevelToUpper;
+	private _deleteLevelFromUpper;
+	private _addLevelToLower;
+	private _deleteLevelFromLower;
+	private _filterGroupLayers;
+	private _filterRestOriginLayers;
+	private _getNewFilter;
 	private static isFilterHasBeenReset;
 }
 export interface IPoiEvent {
@@ -409,41 +399,11 @@ export declare class Map extends Evented {
 	 * @description Turn off building-building switching.
 	 */
 	disableSwitchBuilding(): this;
-	/**
-	 * @description Set outdoor layer to be shown or hidden.
-	 * @deprecated You can use "map.setOutdoorLayerHidden" instead.
-	 * @param isHiddenOutdoor True is hidden, false is shown.
-	 */
-	hiddenOutdoorLayer(isHiddenOutdoor: boolean): void;
 	/**
 	 * @description Set outdoor layer to be shown or hidden.
 	 * @param isHidden True is hidden, false is shown.
 	 */
 	setOutdoorLayerHidden(isHidden: boolean): void;
-	/**
-	 * @description Get a list of floors of the selected building
-	 * @deprecated You can use "map.building" instead
-	 * @returns {string[]}
-	 */
-	get floors(): string[];
-	/**
-	 * @description Get the current floor of the selected building
-	 * @deprecated You can get the current floor by "map.floor"
-	 * @returns {string | null}
-	 */
-	get currentFloor(): string | null;
-	/**
-	 * @description Get the current ordinal of the selected building
-	 * @deprecated You can use "map.floor" instead
-	 * @returns {string | null}
-	 */
-	get ordinal(): string | null;
-	/**
-	 * @description Get venueId which the selected building belongs
-	 * @deprecated You can use "map.venue" instead
-	 * @returns {string | null}
-	 */
-	get venueId(): string | null;
 	/**
 	 * @description Get current selected floor info.
 	 * @return {IFloor | null}
@@ -461,48 +421,34 @@ export declare class Map extends Evented {
 	get venue(): MapGeoJSONFeature | null;
 	/**
 	 * @description Get feature in bbox by id.
+	 * @deprecated Use 'getFeaturesById' instead.
 	 * @param id
 	 * @return {MapGeoJSONFeature | undefined}
 	 */
 	getFeature(id: string): MapGeoJSONFeature | undefined;
 	/**
-	 * @description Select the building feature to enter its indoor
-	 * @deprecated You can use "map.selectBuildingById" or "map.selectVenueById" instead
-	 * @param feature {MapGeoJSONFeature | null} If feature is null then exit indoor
-	 */
-	selectBuilding(feature: MapGeoJSONFeature | null): this;
-	/**
-	 * @description Switch the selected building to be the specified id
-	 * @deprecated You can use "map.selectBuildingById" instead
-	 * @param buildingId {string}
-	 * @param callback
-	 */
-	switchBuilding(buildingId: string, callback?: (feature: MapGeoJSONFeature) => void): this;
-	/**
-	 * @description Switch to the specified floor
-	 * @deprecated You can use "map.selectFloorById" instead
-	 * @param floor {string}
-	 * @param callback
+	 * @description Get features from bbox by id. One id may correspond to multiple features.
+	 * @param id
 	 */
-	switchFloor(floor: string, callback?: (feature: MapGeoJSONFeature) => void): this;
+	getFeaturesById(id: string): MapGeoJSONFeature[];
 	/**
 	 * @description Select floor by id.
 	 * @param floorId
 	 * @param callback Called after floor has been selected.
 	 */
-	selectFloorById(floorId: string, callback?: VoidFunction): Promise<this>;
+	selectFloorById(floorId: string, callback?: VoidFunction): Promise<void>;
 	/**
 	 * @description Select building by id.
 	 * @param buildingId
 	 * @param callback Called after building has been selected
 	 */
-	selectBuildingById(buildingId: string, callback?: VoidFunction): this;
+	selectBuildingById(buildingId: string, callback?: VoidFunction): Promise<void>;
 	/**
 	 * @description Select or exit venue by id.
 	 * @param venueId Exit venue if venueId is null.
 	 * @param callback Called after venue has been selected.
 	 */
-	selectVenueById(venueId: string | null, callback?: VoidFunction): Promise<this>;
+	selectVenueById(venueId: string | null, callback?: VoidFunction): Promise<void>;
 	/**
 	 * @description Listen for mouse click events on the map.
 	 * @param listener
@@ -524,33 +470,6 @@ export declare class Map extends Evented {
 	onPointClickListener(listener: (result: IPointEvent) => void): {
 		unsubscribe: VoidFunction;
 	};
-	/**
-	 * @description Listen for the selected floor changed event
-	 * @deprecated You can use the "map.onMapChangeListener" instead
-	 * @param listener {function} (feature: MapGeoJSONFeature | null) => void
-	 * @return {unsubscribe} To remove the event listener
-	 */
-	onFloorChangeListener(listener: (feature: MapGeoJSONFeature | null) => void): {
-		unsubscribe: VoidFunction;
-	};
-	/**
-	 * @description Listen for the selected building changed event
-	 * @deprecated You can use the "map.onMapChangeListener" instead
-	 * @param listener {function} (feature: MapGeoJSONFeature | null) => void
-	 * @return {unsubscribe} To remove the event listener
-	 */
-	onBuildingChangeListener(listener: (feature: MapGeoJSONFeature | null) => void): {
-		unsubscribe: VoidFunction;
-	};
-	/**
-	 * @description Listen for the selected venue changed event
-	 * @deprecated You can use the "map.onMapChangeListener" instead
-	 * @param listener {function} (feature: MapGeoJSONFeature | null) => void
-	 * @return {unsubscribe} To remove the event listener
-	 */
-	onVenueChangeListener(listener: (feature: MapGeoJSONFeature | null) => void): {
-		unsubscribe: VoidFunction;
-	};
 	/**
 	 * @description Listen for the indoor map status, including the changes of venue, building and floor.
 	 * @param listener
@@ -589,24 +508,29 @@ export declare class Map extends Evented {
 	 * @description Set the floorsControl's style.
 	 * @param style
 	 */
-	setFloorsControlStyle(style: IFloorsControlStyle): void;
+	setFloorsControlStyle(style: IFloorsControlStyle): this;
 	/**
 	 * @description Set the SelectedBuildingBorder's style
 	 * @param style {ISelectedBuildingBorderStyle | null}
 	 */
-	setSelectedBuildingBorderStyle(style: ISelectedBuildingBorderStyle | null): void;
+	setSelectedBuildingBorderStyle(style: ISelectedBuildingBorderStyle | null): this;
 	private static _getThemeStyleName;
 	private _setIndoorFilter;
 	private _setStyle;
 	private _addControl;
-	private _defaultSetMapZoom;
 	private _selectPoiById;
 	private _getBuildingIdByVenueId;
-	private _getBuildingOrdinalByFloor;
+	private _tilesRequestTransform;
+	private _getMapZoom;
+	private _setMapStyle;
+	private _clickEventsDispatcher;
+	private _hideIndoorLayers;
+	private _showIndoorLayers;
+	private _updatePermission;
 }
 export type TAnchorPosition = "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
 export declare class Marker {
-	private _maplibreMap;
+	private readonly _maplibreMap;
 	private readonly _layerId;
 	private readonly _sourceId;
 	private _imageName;
@@ -615,11 +539,15 @@ export declare class Marker {
 	constructor(maplibreMap: MaplibreMap);
 	/**
 	 * @description Set marker by sprite name.
-	 * @param imageName Icon sprite name in map style.
+	 * This method must be called after map style loaded if you set an external URL.
+	 * @param icon Sprite name in map style or the image url, png format.
+	 * @param callback Called when the image(from an external URL) has loaded
+	 * or with an error argument if there is an error.
 	 */
-	setIconImage(imageName: string): void;
+	setIconImage(icon: string, callback?: VoidFunction): void;
 	/**
 	 * @description Set marker by image url.
+	 * @deprecated Use 'setIconImage' instead.
 	 * @param imageUrl Network url, png format.
 	 */
 	setIconImageUrl(imageUrl: string): void;
@@ -663,7 +591,9 @@ export declare class Marker {
 	 * @param eventKey
 	 * @param callback
 	 */
-	onEventListener(eventKey: keyof MapLayerEventType, callback: (marker: GeoJSONFeature) => void): void;
+	onEventListener(eventKey: keyof MapLayerEventType, callback: (marker: MapGeoJSONFeature) => void): {
+		offEventListener: VoidFunction;
+	};
 	/**
 	 * @description Filter marker by custom properties.
 	 * @param filterExpression A expression specifying conditions on source features.
@@ -676,8 +606,8 @@ export declare class Marker {
 	 * Required 'venueId' and 'ordinal' in properties.
 	 * Markers not matched 'venueId' and 'ordinal' would be hidden;
 	 * Outdoor markers always are shown.
-	 * @param venueId {string | null | undefined}
-	 * @param ordinal {string | null | undefined}
+	 * @param venueId {string | null | undefined} null | undefined will be treated as ''.
+	 * @param ordinal {string | null | undefined} null | undefined will be treated as ''.
 	 */
 	setFilterByVenue(venueId: string | null | undefined, ordinal: string | null | undefined): void;
 	/**
@@ -685,8 +615,8 @@ export declare class Marker {
 	 * Required 'buildingId' and 'ordinal' in properties.
 	 * Markers not matched 'buildingId' and 'ordinal' would be hidden;
 	 * Outdoor markers always are shown.
-	 * @param buildingId {string | null | undefined}
-	 * @param ordinal {string | null | undefined}
+	 * @param buildingId {string | null | undefined} null | undefined will be treated as ''.
+	 * @param ordinal {string | null | undefined} null | undefined will be treated as ''.
 	 */
 	setFilterByBuilding(buildingId: string | null | undefined, ordinal: string | null | undefined): void;
 	/**
@@ -701,8 +631,8 @@ export declare class Marker {
 	 * Required 'venueId' and 'ordinal' in properties.
 	 * Opacities of markers matched 'venueId' and 'ordinal' are 1, others are 0.5.
 	 * Outdoor markers' opacity always are 1.
-	 * @param venueId {string | null | undefined}
-	 * @param ordinal {string | null | undefined}
+	 * @param venueId {string | null | undefined} null | undefined will be treated as ''.
+	 * @param ordinal {string | null | undefined} null | undefined will be treated as ''.
 	 */
 	setOpacityByVenue(venueId: string | null | undefined, ordinal: string | null | undefined): void;
 	/**
@@ -710,13 +640,14 @@ export declare class Marker {
 	 * Required 'buildingId' and 'ordinal' in properties.
 	 * Opacities of markers matched 'buildingId' and 'ordinal' are 1, others are 0.5.
 	 * Outdoor markers' opacity always are 1.
-	 * @param buildingId {string | null | undefined}
-	 * @param ordinal {string | null | undefined}
+	 * @param buildingId {string | null | undefined} null | undefined will be treated as ''.
+	 * @param ordinal {string | null | undefined} null | undefined will be treated as ''.
 	 */
 	setOpacityByBuilding(buildingId: string | null | undefined, ordinal: string | null | undefined): void;
 	private _createIconFeature;
 	private _addIconSource;
 	private _addIconLayer;
+	private _handleEventListener;
 }
 export declare class Poi {
 	private _map;
@@ -752,28 +683,16 @@ export declare class FloorsControl implements IControl {
 	private _maxScrollTop;
 	private _$selectorExpanded;
 	private _$selectorFolded;
-	private _dispatch;
 	private _componentDidMount;
 	private _isShown;
 	constructor(indoor: Indoor);
 	onAdd(): HTMLElement;
 	onRemove(): void;
 	getDefaultPosition(): ControlPosition;
-	/**
-	 * @deprecated Use 'switchByOrdinal' instead
-	 */
-	switchByFloorName(floorName: string, callback?: (feature: MapGeoJSONFeature) => void): void;
-	switchByOrdinal(ordinal: string, callback?: (feature: MapGeoJSONFeature) => void): void;
+	switchByOrdinal(ordinal: string, callback?: VoidFunction): void;
 	setVisibility(visible: boolean): void;
 	setPosition(position: ControlPosition): void;
 	setStyle(style: Partial<IFloorsControlStyle> | null): void;
-	/**
-	 * @deprecated
-	 * @param listener
-	 */
-	onFloorClick(listener: (feature: MapGeoJSONFeature) => void): {
-		unsubscribe: VoidFunction;
-	};
 	private _bindEvents;
 	private _clearData;
 	private _render;
@@ -792,9 +711,8 @@ export declare class FloorsControl implements IControl {
 	private _getScrollTop;
 	private _handleScroll;
 	private _expandSelector;
-	private _getCurrentLevelFeature;
 }
-export declare class BuildingFilterControl implements maplibregl.IControl {
+export declare class BuildingFilterControl implements IControl {
 	private _map;
 	private _indoor;
 	private _buildingId;
@@ -843,7 +761,7 @@ export type IMultiLangAddress = Record<keyof IMultiLangName, {
 }>;
 export interface IBbox {
 	maxLat: number;
-	maxLon: string;
+	maxLon: number;
 	minLat: number;
 	minLon: number;
 }
@@ -1029,6 +947,10 @@ export interface IResponsePois {
 	pois: IPoi[];
 	total: number;
 }
+export declare enum DistanceSearchType {
+	POINT = "Point",
+	POLYGON = "Polygon"
+}
 export interface IPoiCategory {
 	category: string;
 	description: string;
@@ -1051,7 +973,6 @@ export interface IOrientationPoi {
 }
 export declare class PoisService {
 	private _api;
-	private _categories;
 	private _categoriesV2;
 	private _request;
 	constructor();
@@ -1086,28 +1007,55 @@ export declare class PoisService {
 	 */
 	searchByBuildingId(keywords: string, buildingId: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
 	/**
-	 * @description Search POI categories by building id or floor name
-	 * @deprecated You can use 'searchCategories' instead
-	 * @param buildingId within the building
-	 * @param floor option param, within floor
-	 */
-	searchCategory(buildingId: string, floor?: string): AxiosPromise<IResponse<string[]>>;
-	/**
-	 * @description Search poi categories by building id and floor id.
-	 * @param buildingId
-	 * @param floorId
-	 */
-	searchCategories(buildingId: string, floorId?: string): AxiosPromise<IResponse<IPoiCategory[]>>;
-	/**
-	 * @description Search orientation and poi
-	 * @param angle The angle between cellphone's orientation and the north.
-	 * @param buildingId
-	 * @param center User's current position, [lon, lat].
-	 * @param distance Radius from center, unit is meter.
-	 * @param distanceSearchType Search type, default is DistanceSearchType.POINT.
-	 * @param floorId
-	 */
-	searchOrientation(angle: number, buildingId: string, center: number[], distance: number, distanceSearchType?: string, floorId?: string): AxiosPromise<IResponse<IOrientationPoi[]>>;
+	 * @description Search POIs of a venue.
+	 * @param keywords
+	 * @param venueId
+	 * @param offset
+	 * @param page
+	 */
+	searchByVenueId(keywords: string, venueId: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
+	/**
+	 * @description Search poi categories by venue id, building id, or floor id.
+	 * Search scope priority: floorId > buildingId > venueId.
+	 * @param paramObject
+	 */
+	searchCategories(paramObject: {
+		venueId?: string;
+		buildingId?: string;
+		floorId?: string;
+	}): AxiosPromise<IResponse<IPoiCategory[]>>;
+	/**
+	 * @description Search orientation and poi.
+	 * BuildingId, floorId and ordinal are mutually exclusive, priority: ordinal > floorId > buildingId.
+	 * @param paramObj
+	 */
+	searchOrientation(paramObj: {
+		/**
+		 * User's current position, [lon, lat].
+		 */
+		center: [
+			number,
+			number
+		];
+		/**
+		 * The angle between cellphone's orientation and the north.
+		 */
+		angle: number;
+		/**
+		 * Radius.
+		 */
+		distance: number;
+		buildingId?: string;
+		floorId?: string;
+		/**
+		 * Floor order in physical space, e.g. '-1', '0'(ground floor), '1'...
+		 */
+		ordinal?: string;
+		/**
+		 * Search type.
+		 */
+		distanceSearchType?: DistanceSearchType;
+	}): AxiosPromise<IResponse<IOrientationPoi[]>>;
 	private _changedRes;
 }
 export interface IResponseRoute {
@@ -1190,7 +1138,7 @@ export declare class RouteService {
 	], fromFloorId: string | null, toFloorId: string | null, fromBuildingId: string | null, toBuildingId: string | null, vehicle?: WayFindingVehicleType, locale?: string, toDoor?: boolean): AxiosPromise<IResponse<IResponseRoute>>;
 }
 export declare class RoutePainter {
-	private _maplibreMap;
+	private readonly _maplibreMap;
 	private _fromCoordinate;
 	private _toCoordinate;
 	private _fromMarkerIcon;
@@ -1199,15 +1147,21 @@ export declare class RoutePainter {
 	private _paintProperties;
 	constructor(maplibreMap: MaplibreMap);
 	/**
-	 * @description Set image of the start marker.
+	 * @description Set image of the start marker. This method must be called after map style loaded.
+	 * This method must be called after map style loaded if you set an external URL.
 	 * @param icon Sprite name in map style or the image url, png format.
+	 * @param callback Called when the image(from an external URL) has loaded
+	 * or with an error argument if there is an error.
 	 */
-	setFromMarkerIcon(icon: string): this;
+	setFromMarkerIcon(icon: string, callback?: VoidFunction): void;
 	/**
-	 * @description Set image of the end marker.
+	 * @description Set image of the end marker. This method must be called after map style loaded.
+	 * This method must be called after map style loaded if you set an external URL.
 	 * @param icon Sprite name in map style or the image url, png format.
+	 * @param callback Called when the image(from an external URL) has loaded
+	 * or with an error argument if there is an error.
 	 */
-	setToMarkerIcon(icon: string): this;
+	setToMarkerIcon(icon: string, callback?: VoidFunction): void;
 	/**
 	 * @description Set image icon scale.
 	 * @param size Default is 1.
@@ -1228,7 +1182,7 @@ export declare class RoutePainter {
 	 */
 	setOutdoorLineColor(color: string): this;
 	/**
-	 * @description Set color of dashed line which connected the start and end markers.
+	 * @description Set color of dashed lines which connected the start and end markers.
 	 * @param color The color type is a color in the sRGB color space.
 	 * Formats: HTML-style hex values, RGB, RGBA, HSL, and HSLA.
 	 * Predefined HTML colors names, like yellow and blue, are also permitted.
@@ -1253,24 +1207,23 @@ export declare class RoutePainter {
 	], toCoordinate: [
 		number,
 		number
-	]): this;
+	]): void;
 	/**
 	 * @description Remove route from the map.
 	 */
-	remove(): this;
+	remove(): void;
 	/**
 	 * @description Filter paths' opacity by venue and ordinal.
 	 * @param venueId {string | null | undefined}
 	 * @param ordinal {string | null | undefined}
 	 */
-	setFilterByVenue(venueId: string | null | undefined, ordinal: string | null | undefined): this;
+	setFilterByVenue(venueId: string | null | undefined, ordinal: string | null | undefined): void;
 	/**
 	 * @description Filter paths' opacity by building and ordinal.
 	 * @param buildingId {string | null | undefined}
 	 * @param ordinal {string | null | undefined}
 	 */
-	setFilterByBuilding(buildingId: string | null | undefined, ordinal: string | null | undefined): this;
-	private _loadImage;
+	setFilterByBuilding(buildingId: string | null | undefined, ordinal: string | null | undefined): void;
 	private _classifyFeatures;
 	private _createLineFeature;
 	private _createIconFeature;
@@ -1285,10 +1238,6 @@ export declare class RoutePainter {
 }
 export declare const OFFSET: number;
 export declare const PAGE: number;
-export declare enum DistanceSearchType {
-	POINT = "Point",
-	POLYGON = "Polygon"
-}
 export declare const version: string;
 export type { ControlPosition, Map as MaplibreMap, MapLayerEventType, FilterSpecification, PointLike, } from "maplibre-gl";