@mapxus/mapxus-map-jp 7.3.0 → 7.5.0

package/index.d.ts

@@ -1,4 +1,4 @@
-// Generated by dts-bundle-generator v6.13.0
+// Generated by dts-bundle-generator v8.1.2
 
 import { AxiosPromise } from 'axios';
 import { ControlPosition, FilterSpecification, IControl, LngLat, Map as MaplibreMap, Map as maplibreMap, MapGeoJSONFeature, MapLayerEventType, PaddingOptions, PointLike, RequireAtLeastOne } from 'maplibre-gl';
@@ -58,7 +58,7 @@ export interface IMapOption {
 	 */
 	poiId?: string;
 	hiddenOutdoor?: boolean;
-	theme?: ThemeType;
+	theme?: ThemeType | string;
 	collapseCopyright?: boolean;
 	selectedBuildingBorderStyle?: ISelectedBuildingBorderStyle;
 	floorsControlStyle?: IFloorsControlStyle;
@@ -178,7 +178,17 @@ export declare class Indoor extends Evented {
 	private _dispatch;
 	private readonly _fitBuildingBounds;
 	private readonly _boundsPadding;
-	constructor(map: maplibreMap, isHiddenOutdoor: boolean, floorSwitchMode: FloorSwitchMode, fitBuildingBounds: boolean, boundsPadding: number | RequireAtLeastOne<PaddingOptions>);
+	private readonly _isInitialIndoor;
+	private _maplibreMapLoaded;
+	private _indoorMapLoaded;
+	constructor(props: {
+		map: maplibreMap;
+		isInitialIndoor: boolean;
+		isHiddenOutdoor: boolean;
+		floorSwitchMode: FloorSwitchMode;
+		fitBuildingBounds: boolean;
+		boundsPadding: number | RequireAtLeastOne<PaddingOptions>;
+	});
 	/**
 	 * @description Turn on indoor-outdoor switching.
 	 */
@@ -288,7 +298,7 @@ export declare class Indoor extends Evented {
 	private _getConditionsExpression;
 	private _loadData;
 	private _init;
-	private _load;
+	private _filter;
 	private _clear;
 	private _updateFilter;
 	private _setPoiTextColor;
@@ -362,7 +372,6 @@ export declare class Map extends Evented {
 	private _poi;
 	private _initialHiddenLayers;
 	private _attributionControl;
-	private _mapZoom;
 	private _dispatch;
 	constructor(option: IMapOption);
 	/**
@@ -426,6 +435,19 @@ export declare class Map extends Evented {
 	 * @return {MapGeoJSONFeature | undefined}
 	 */
 	getFeature(id: string): MapGeoJSONFeature | undefined;
+	/**
+	 * @description Get features from bbox by coordinates [and ordinal].
+	 * @param coordinates
+	 * @param ordinal
+	 */
+	getIndoorFeaturesByCoordinates(coordinates: {
+		lng: number;
+		lat: number;
+	}, ordinal?: number): {
+		venue: MapGeoJSONFeature;
+		building: MapGeoJSONFeature;
+		level: MapGeoJSONFeature;
+	};
 	/**
 	 * @description Get features from bbox by id. One id may correspond to multiple features.
 	 * @param id
@@ -445,7 +467,7 @@ export declare class Map extends Evented {
 	selectBuildingById(buildingId: string, callback?: VoidFunction): Promise<void>;
 	/**
 	 * @description Select or exit venue by id.
-	 * @param venueId Exit venue if venueId is null.
+	 * @param venueId 'venueId' can be string or null. Exit indoors if venueId is null.
 	 * @param callback Called after venue has been selected.
 	 */
 	selectVenueById(venueId: string | null, callback?: VoidFunction): Promise<void>;
@@ -521,7 +543,7 @@ export declare class Map extends Evented {
 	private _selectPoiById;
 	private _getBuildingIdByVenueId;
 	private _tilesRequestTransform;
-	private _getMapZoom;
+	private _checkMapZoom;
 	private _setMapStyle;
 	private _clickEventsDispatcher;
 	private _hideIndoorLayers;
@@ -529,6 +551,18 @@ export declare class Map extends Evented {
 	private _updatePermission;
 }
 export type TAnchorPosition = "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export interface IMarkerOptions {
+	lngLat: [
+		number,
+		number
+	];
+	properties?: {
+		[k: string]: string;
+	};
+}
+export interface IMarkerOptionsWithFeatureId extends IMarkerOptions {
+	featureId: number;
+}
 export declare class Marker {
 	private readonly _maplibreMap;
 	private readonly _layerId;
@@ -538,19 +572,11 @@ export declare class Marker {
 	private _iconAnchor;
 	constructor(maplibreMap: MaplibreMap);
 	/**
-	 * @description Set marker by sprite name.
-	 * 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.
+	 * @description Set custom marker image.
+	 * @param icon Sprite name in map style or the URL of the image file.
+	 * Image file must be in png, webp, or jpg format.
 	 */
-	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;
+	setIcon(icon: string): Promise<void>;
 	/**
 	 * @description Set marker image size.
 	 * @param imageScale Default is 1.
@@ -570,30 +596,45 @@ export declare class Marker {
 	 */
 	get sourceId(): string;
 	/**
-	 * @description Create marker[s] source and layer.
-	 * @param array Coordinate and properties arrays of marker[s].
+	 * @description Draw marker[s] on map.
+	 * @param array {IMarkerOptions | IMarkerOptionsWithFeatureId[]} Coordinate and properties arrays of marker[s].
+	 * If you need to use updateData(), the parameter must be IMarkerOptionsWithFeatureId[].
 	 */
-	create(array: Array<{
-		lngLat: [
-			number,
-			number
-		];
-		properties?: {
-			[k: string]: string;
-		};
-	}>): void;
+	create(array: Array<IMarkerOptions | IMarkerOptionsWithFeatureId>): void;
+	/**
+	 * @description Add, delete or update features of this marker layer.
+	 * This approach requires unique IDs for every feature in the source!!! Including create() parameters.
+	 * @param diff {remove: number[], add: IMarkerOptionsWithFeatureId[], update: IMarkerOptionsWithFeatureId[]}
+	 * remove: Array of feature IDs to remove.
+	 * add: Array of new features to add.
+	 * update: Array of features to update, the new properties will replace the old ones.
+	 */
+	updateData(diff: {
+		remove?: number[];
+		add?: IMarkerOptionsWithFeatureId[];
+		update?: IMarkerOptionsWithFeatureId[];
+	}): void;
 	/**
 	 * @description Remove marker[s] layer and source.
 	 */
 	remove(): void;
 	/**
 	 * @description Add marker event listener.
+	 * @deprecated Use 'on' method instead.
 	 * @param eventKey
 	 * @param callback
 	 */
 	onEventListener(eventKey: keyof MapLayerEventType, callback: (marker: MapGeoJSONFeature) => void): {
 		offEventListener: VoidFunction;
 	};
+	/**
+	 * @description Add marker event listener.
+	 * @param eventKey
+	 * @param callback
+	 */
+	on(eventKey: keyof MapLayerEventType, callback: (marker: MapGeoJSONFeature) => void): {
+		off: () => MaplibreMap;
+	};
 	/**
 	 * @description Filter marker by custom properties.
 	 * @param filterExpression A expression specifying conditions on source features.
@@ -746,95 +787,108 @@ export declare class BuildingFilterControl implements IControl {
 	private _$showLayout;
 	private _$hideLayout;
 }
-export interface IResponse<T> {
-	code: number;
-	message: string;
-	result: T;
-}
-export type IPresetLanguage = "en" | "zh-Hans" | "zh-Hant" | "ja" | "ko";
-export interface IMultiLangName extends Partial<Record<IPresetLanguage, string>> {
+export type TPresetLanguage = "en" | "zh-Hans" | "zh-Hant" | "ja" | "ko";
+export interface IMultilingualName extends Partial<Record<TPresetLanguage, string>> {
 	default: string;
 }
-export type IMultiLangAddress = Record<keyof IMultiLangName, {
+export type IMultilingualAddress = Record<keyof IMultilingualName, {
 	housenumber: string;
 	street: string;
 }>;
+export interface ILocation {
+	lat: number;
+	lon: number;
+}
 export interface IBbox {
 	maxLat: number;
 	maxLon: number;
 	minLat: number;
 	minLon: number;
 }
-export interface ILabelCenter {
-	lat: number;
-	lon: number;
+export interface IResponse<T> {
+	code: number;
+	message: string;
+	result: T;
 }
-export interface IBuildingFloor {
-	id: string;
+export interface IBuildingInlineFloor {
 	code: string;
+	id: string;
 	ordinal: number;
-	visualMap: boolean;
 	signalMap: boolean;
+	visualMap: boolean;
 }
 export interface IBuilding {
-	address: IMultiLangAddress;
+	address: IMultilingualAddress;
 	bbox: IBbox;
 	buildingId: string;
 	buildingOutlineId: number;
 	city?: string;
 	country: string;
-	floors: IBuildingFloor[];
+	defaultFloor?: string;
+	floors: IBuildingInlineFloor[];
 	groundFloor: string;
 	isPrivate: "yes" | "no";
-	labelCenter: ILabelCenter;
-	name: IMultiLangName;
+	labelCenter: ILocation;
+	name: IMultilingualName;
 	organization: string;
 	region: string;
 	signalMap: boolean;
 	type: string;
 	venueId: string;
-	venueName: IMultiLangName;
-	defaultFloor?: string;
+	venueName: IMultilingualName;
+	visualMap: boolean;
 }
-export interface IEntityPoint {
-	type: string;
-	coordinates: [
-		number,
-		number
-	];
+export interface IResponseBuildings {
+	buildings: IBuilding[];
+	total: number;
 }
+export type TPromiseBuildings = AxiosPromise<IResponse<IResponseBuildings>>;
 export interface IVenueInlineBuilding {
-	id: string;
-	name: IMultiLangName;
 	buildingOutlineId: number;
-	point: IEntityPoint;
-	floors: IBuildingFloor[];
-	visualMap: boolean;
+	defaultFloor?: string;
+	floors: IBuildingInlineFloor[];
+	id: string;
+	labelCenter: ILocation;
+	name: IMultilingualName;
+	point: {
+		type: string;
+		coordinates: [
+			number,
+			number
+		];
+	};
 	signalMap: boolean;
+	visualMap: boolean;
 }
 export interface IVenue {
-	id: string;
-	name: IMultiLangName;
-	address: IMultiLangAddress;
-	type: string;
-	venueOutlineId: number;
+	address: IMultilingualAddress;
 	bbox: IBbox;
-	labelCenter: ILabelCenter;
-	point: IEntityPoint;
+	buildings: IVenueInlineBuilding[];
+	businessStatus?: {
+		status: string;
+	};
+	country: string;
+	defaultBuilding?: string;
+	id: string;
+	labelCenter: ILocation;
+	name: IMultilingualName;
 	organization: string[];
-	restricted: boolean;
 	owner: string;
-	country: string;
+	publicData?: string[];
+	photos?: object[];
 	region: string;
-	buildings: IVenueInlineBuilding[];
-	visualMap: boolean;
+	restricted: boolean;
 	signalMap: boolean;
-	defaultBuilding?: string;
+	totalPhotoCount?: number;
+	type: string;
+	venueOutlineId: number;
+	visualMap: boolean;
 }
 export interface IResponseVenues {
 	venues: IVenue[];
 	total: number;
 }
+export type TPromiseVenues = AxiosPromise<IResponse<IResponseVenues>>;
 export declare class VenuesService {
 	private _api;
 	private _request;
@@ -843,7 +897,7 @@ export declare class VenuesService {
 	 * @description Search venues by ids.
 	 * @param ids The number of IDs cannot exceed 10.
 	 */
-	searchByIds(ids: string | string[]): AxiosPromise<IResponse<IResponseVenues>>;
+	searchByIds(ids: string | string[]): TPromiseVenues;
 	/**
 	 * @description Search venues by center and distance.
 	 * @param keywords
@@ -855,7 +909,7 @@ export declare class VenuesService {
 	searchByDistance(keywords: string, center: [
 		number,
 		number
-	], distance: number, offset?: number, page?: number): AxiosPromise<IResponse<IResponseVenues>>;
+	], distance: number, offset?: number, page?: number): TPromiseVenues;
 	/**
 	 * @description Search venues in specified bbox.
 	 * @param keywords
@@ -868,18 +922,15 @@ export declare class VenuesService {
 		number,
 		number,
 		number
-	], offset?: number, page?: number): AxiosPromise<IResponse<IResponseVenues>>;
+	], offset?: number, page?: number): TPromiseVenues;
 	/**
 	 * @description Search venues by global.
 	 * @param keywords
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByGlobal(keywords: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponseVenues>>;
-}
-export interface IResponseBuildings {
-	buildings: IBuilding[];
-	total: number;
+	searchByGlobal(keywords: string, offset?: number, page?: number): TPromiseVenues;
+	private _changedRes;
 }
 export declare class BuildingsService {
 	private _api;
@@ -889,7 +940,7 @@ export declare class BuildingsService {
 	 * @description Search buildings by id[s].
 	 * @param ids Single id string or id string array. The number of IDs cannot exceed 10.
 	 */
-	searchByIds(ids: string | string[]): AxiosPromise<IResponse<IResponseBuildings>>;
+	searchByIds(ids: string | string[]): TPromiseBuildings;
 	/**
 	 * @description Search buildings by center and distance.
 	 * @param keywords
@@ -898,7 +949,7 @@ export declare class BuildingsService {
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByDistance(keywords: string, center: number[], distance: number, offset?: number, page?: number): AxiosPromise<IResponse<IResponseBuildings>>;
+	searchByDistance(keywords: string, center: number[], distance: number, offset?: number, page?: number): TPromiseBuildings;
 	/**
 	 * @description Search buildings in specified bbox.
 	 * @param keywords
@@ -906,34 +957,31 @@ export declare class BuildingsService {
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByBbox(keywords: string, bbox: number[], offset?: number, page?: number): AxiosPromise<IResponse<IResponseBuildings>>;
+	searchByBbox(keywords: string, bbox: number[], offset?: number, page?: number): TPromiseBuildings;
 	/**
 	 * @description Search buildings global.
 	 * @param keywords
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByGlobal(keywords: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponseBuildings>>;
+	searchByGlobal(keywords: string, offset?: number, page?: number): TPromiseBuildings;
 	/**
 	 * @description Search building by floor id.
 	 * @param floorId
 	 */
-	searchByFloorId(floorId: string): AxiosPromise<IResponse<IResponseBuildings>>;
+	searchByFloorId(floorId: string): TPromiseBuildings;
 	private _changedRes;
 }
-export interface ILocation {
-	lat: number;
-	lon: number;
-}
 export interface IPoi {
 	accessibilityDetail: object;
 	buildingId: string;
 	category: string[];
+	distance: number;
 	floor: string;
 	floorId: string;
 	id: string;
 	location: ILocation;
-	name: IMultiLangName;
+	name: IMultilingualName;
 	osmRefId: number;
 	poiId: string;
 	venueId: string;
@@ -947,15 +995,19 @@ export interface IResponsePois {
 	pois: IPoi[];
 	total: number;
 }
+export type TPromisePois = AxiosPromise<IResponse<IResponsePois>>;
+export type TPromiseCategories = AxiosPromise<IResponse<IPoiCategory[]>>;
+export type TPromiseOrientationPois = AxiosPromise<IResponse<IOrientationPoi[]>>;
 export declare enum DistanceSearchType {
 	POINT = "Point",
-	POLYGON = "Polygon"
+	POLYGON = "Polygon",
+	GATE = "Gate"
 }
 export interface IPoiCategory {
 	category: string;
-	description: string;
+	description: string | null;
 	id: string;
-	title: Partial<Record<keyof IMultiLangName, string>>;
+	title: Partial<Record<keyof IMultilingualName, string>>;
 }
 export interface IOrientationPoi {
 	angle: number;
@@ -967,9 +1019,148 @@ export interface IOrientationPoi {
 	floorId: string;
 	id: string;
 	location: ILocation;
-	name: IMultiLangName;
+	name: IMultilingualName;
 	osmRefId: number;
 	poiId: string;
+	description?: string;
+	email?: string;
+	openingHours?: string;
+	phone?: string;
+	website?: string;
+}
+export interface ISearchDistance {
+	/**
+	 * The center of searching range, [lng, lat].
+	 */
+	center: [
+		number,
+		number
+	];
+	/**
+	 * Radius from center, unit is meter, cannot exceed 10,000.
+	 */
+	distance: number;
+	/**
+	 * The maximum value is 100, default is 10.
+	 */
+	offset?: number;
+	/**
+	 * Results for specified page number. Default is 1.
+	 */
+	page?: number;
+}
+export interface IPoiSearchByCategoryOptions extends ISearchDistance {
+	category: string;
+}
+export interface IPoiSearchByExcludedCategoriesOptions extends ISearchDistance {
+	excludedCategories: string | string[];
+}
+export type TPoiSearchByCategoryOptions = IPoiSearchByCategoryOptions | IPoiSearchByExcludedCategoriesOptions;
+export interface IPoiSearchByDistanceOptions extends ISearchDistance {
+	/**
+	 * Keywords of POI name.
+	 */
+	keywords?: string;
+}
+export interface ISearchOrientation {
+	/**
+	 * User's position, [lng, lat].
+	 */
+	center: [
+		number,
+		number
+	];
+	/**
+	 * The angle between the user's orientation and true north.
+	 */
+	angle: number;
+	/**
+	 * The radius with 'center' as the center of the circle.
+	 */
+	distance: number;
+	/**
+	 * The type of POI, default is 'Point'.
+	 */
+	distanceSearchType?: DistanceSearchType;
+}
+export interface IPoiSearchByOrientationAndBuildingOptions extends ISearchOrientation {
+	buildingId: string;
+}
+export interface IPoiSearchByOrientationAndFloorOptions extends ISearchOrientation {
+	floorId: string;
+}
+export interface IPoiSearchByOrientationAndOrdinalOptions extends ISearchOrientation {
+	ordinal: string;
+}
+export type TPoiSearchByOrientationOptions = IPoiSearchByOrientationAndBuildingOptions | IPoiSearchByOrientationAndFloorOptions | IPoiSearchByOrientationAndOrdinalOptions;
+export interface IPoiSearchOrientationOptions {
+	/**
+	 * User's current position, [lng, 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;
+}
+export declare enum PoisOrderBy {
+	DEFAULT_NAME = "DefaultName"
+}
+export interface ISearchKeywords {
+	keywords?: string;
+	/**
+	 * Quantity per page, the maximum is 100, default is 10.
+	 */
+	offset?: number;
+	/**
+	 * Results for specified page number. Default is 1.
+	 */
+	page?: number;
+}
+export interface IPoiSearchByBuildingOptions extends ISearchKeywords {
+	buildingId: string;
+	orderBy?: PoisOrderBy;
+}
+export interface IPoiSearchByVenueOptions extends ISearchKeywords {
+	venueId: string;
+	orderBy?: PoisOrderBy;
+}
+export interface IPoiSearchByFloorOptions extends ISearchKeywords {
+	floorId: string;
+	orderBy?: PoisOrderBy;
+}
+export interface IPoiSearchByBoundsOptions extends ISearchKeywords {
+	/**
+	 * An array of LngLat coordinates in [sw, ne] order
+	 */
+	bounds: [
+		[
+			number,
+			number
+		],
+		[
+			number,
+			number
+		]
+	];
+	orderBy?: PoisOrderBy;
 }
 export declare class PoisService {
 	private _api;
@@ -980,40 +1171,63 @@ export declare class PoisService {
 	 * @description Search POIs by id[s].
 	 * @param ids Single id string or id string array. The number of IDs cannot exceed 100.
 	 */
-	searchByIds(ids: string | string[]): AxiosPromise<IResponse<IResponsePois>>;
+	searchByIds(ids: string | string[]): TPromisePois;
 	/**
 	 * @description Search POIs by radius distance of the center point.
-	 * @param category
-	 * @param center
-	 * @param distance Radius from center, unit is meter, cannot exceed 10,000.
-	 * @param offset The maximum value is 100, default is 10.
-	 * @param page Default is 1.
+	 * @param options {IPoiSearchByDistanceOptions}
 	 */
-	searchByDistance(category: string, center: number[], distance: number, offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
+	searchByDistance(options: IPoiSearchByDistanceOptions): TPromisePois;
 	/**
 	 * @description Search POIs in a bbox.
+	 * @deprecated Use searchByBounds instead.
 	 * @param keywords
 	 * @param bbox Rectangular area, [minLon, minLat, maxLon, maxLat].
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByBbox(keywords: string, bbox: number[], offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
+	searchByBbox(keywords: string, bbox: number[], offset?: number, page?: number): TPromisePois;
+	/**
+	 * @description Search POIs in a rectangular area.
+	 * @param options {IPoiSearchByBoundsOptions}
+	 * 'orderBy' cannot be used with 'keywords'.
+	 */
+	searchByBounds(options: IPoiSearchByBoundsOptions): TPromisePois;
 	/**
 	 * @description Search POIs of a building.
+	 * @deprecated Use searchByBuilding instead.
 	 * @param keywords
 	 * @param buildingId
 	 * @param offset The maximum value is 100, default is 10.
 	 * @param page Default is 1.
 	 */
-	searchByBuildingId(keywords: string, buildingId: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
+	searchByBuildingId(keywords: string, buildingId: string, offset?: number, page?: number): TPromisePois;
+	/**
+	 * @description Search POIs of a building.
+	 * @param options {IPoiSearchByBuildingOptions}
+	 * 'orderBy' cannot be used with 'keywords'.
+	 */
+	searchByBuilding(options: IPoiSearchByBuildingOptions): TPromisePois;
 	/**
 	 * @description Search POIs of a venue.
+	 * @deprecated Use searchByVenue instead.
 	 * @param keywords
 	 * @param venueId
 	 * @param offset
 	 * @param page
 	 */
-	searchByVenueId(keywords: string, venueId: string, offset?: number, page?: number): AxiosPromise<IResponse<IResponsePois>>;
+	searchByVenueId(keywords: string, venueId: string, offset?: number, page?: number): TPromisePois;
+	/**
+	 * @description Search POIs of a venue.
+	 * @param options {IPoiSearchByVenueOptions}
+	 * 'orderBy' cannot be used with 'keywords'.
+	 */
+	searchByVenue(options: IPoiSearchByVenueOptions): TPromisePois;
+	/**
+	 * @description Search POIs of a floor.
+	 * @param options {IPoiSearchByFloorOptions}
+	 * 'orderBy' cannot be used with 'keywords'.
+	 */
+	searchByFloor(options: IPoiSearchByFloorOptions): TPromisePois;
 	/**
 	 * @description Search poi categories by venue id, building id, or floor id.
 	 * Search scope priority: floorId > buildingId > venueId.
@@ -1023,44 +1237,31 @@ export declare class PoisService {
 		venueId?: string;
 		buildingId?: string;
 		floorId?: string;
-	}): AxiosPromise<IResponse<IPoiCategory[]>>;
+	}): TPromiseCategories;
 	/**
-	 * @description Search orientation and poi.
+	 * @description Search surrounding POIs based on the user's location and orientation.
 	 * BuildingId, floorId and ordinal are mutually exclusive, priority: ordinal > floorId > buildingId.
-	 * @param paramObj
+	 * @deprecated Use searchByOrientation instead.
+	 * @param options
 	 */
-	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[]>>;
+	searchOrientation(options: IPoiSearchOrientationOptions): TPromiseOrientationPois;
+	/**
+	 * @description Search surrounding POIs based on the user's location and orientation.
+	 * @param options {TPoiSearchByOrientationOptions}
+	 */
+	searchByOrientation(options: TPoiSearchByOrientationOptions): TPromiseOrientationPois;
+	/**
+	 * @description Search POIs by category or excluded categories.
+	 * @param options {TPoiSearchByCategoryOptions}
+	 */
+	searchByCategory(options: TPoiSearchByCategoryOptions): TPromisePois;
 	private _changedRes;
 }
-export interface IResponseRoute {
-	infos: IRouteInfo | null;
-	paths: IRoutePath[];
+export declare enum VehicleType {
+	FOOT = "foot",
+	WHEELCHAIR = "wheelchair",
+	ESCALATOR = "escalator",
+	EMERGENCY = "emergency"
 }
 export interface IRouteInfo {
 	copyrights: string[];
@@ -1108,60 +1309,67 @@ export interface IRoutePath {
 	};
 	time: number;
 }
-export declare enum WayFindingVehicleType {
-	FOOT = "foot",
-	WHEELCHAIR = "wheelchair",
-	ESCALATOR = "escalator"
+export interface IResponseRoute {
+	infos: IRouteInfo | null;
+	paths: IRoutePath[];
+}
+export type TPromiseRoute = AxiosPromise<IResponse<IResponseRoute>>;
+export interface IRouteSearchOptions {
+	/**
+	 * @description Points are in order, from -> stops -> to.
+	 * The length of points must be: 1 < {points.length} < 6.
+	 */
+	points: Array<{
+		lat: number;
+		lon: number;
+		buildingId?: string;
+		floorId?: string;
+	}>;
+	/**
+	 * @description Default is "foot".
+	 */
+	vehicle?: VehicleType;
+	/**
+	 * @description Language-specific response. Default is "en".
+	 */
+	locale?: TPresetLanguage;
+	/**
+	 * @description Whether the end point of the route is at the door(otherwise in the room), default is "true".
+	 * @deprecated
+	 */
+	toDoor?: boolean;
 }
 export declare class RouteService {
 	private _api;
 	private _request;
 	constructor();
 	/**
-	 * @description Search the route of any two points.
-	 * @param fromCoordinate Coordinate [lng, lat] of start point.
-	 * @param toCoordinate Coordinate [lng, lat] of end point.
-	 * @param fromFloorId {string | null}
-	 * @param toFloorId {string | null}
-	 * @param fromBuildingId {string | null}
-	 * @param toBuildingId {string | null}
-	 * @param vehicle
-	 * @param locale Language-specific response.
-	 * @param toDoor Whether the end point of the route is in the room(otherwise at the door), default is "true".
-	 */
-	search(fromCoordinate: [
-		number,
-		number
-	], toCoordinate: [
-		number,
-		number
-	], fromFloorId: string | null, toFloorId: string | null, fromBuildingId: string | null, toBuildingId: string | null, vehicle?: WayFindingVehicleType, locale?: string, toDoor?: boolean): AxiosPromise<IResponse<IResponseRoute>>;
+	 * @description Search the route of two or more points.
+	 * @param options {IRouteSearchOptions}
+	 */
+	search(options: IRouteSearchOptions): TPromiseRoute;
 }
 export declare class RoutePainter {
 	private readonly _maplibreMap;
-	private _fromCoordinate;
-	private _toCoordinate;
 	private _fromMarkerIcon;
 	private _toMarkerIcon;
+	private _stopMarkerIcons;
 	private _markerIconSize;
 	private _paintProperties;
 	constructor(maplibreMap: MaplibreMap);
 	/**
-	 * @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, callback?: VoidFunction): void;
-	/**
-	 * @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.
+	 * @description Set image[s] of the stop marker[s].
+	 * @param icons Array of sprite names or URLs, or the object with specifying icon.
+	 * Markers use images in order of icons array.
+	 * First is as from-marker, last is as to-marker, the middles are as stop-markers.
+	 * If icons array has only one element, all stop markers use this image.
+	 * Image file must be in png, webp, or jpg format.
 	 */
-	setToMarkerIcon(icon: string, callback?: VoidFunction): void;
+	setMarkerIcons(icons: string[] | {
+		from?: string;
+		to?: string;
+		stops?: string[];
+	}): Promise<void>;
 	/**
 	 * @description Set image icon scale.
 	 * @param size Default is 1.
@@ -1198,16 +1406,12 @@ export declare class RoutePainter {
 	/**
 	 * @description Render route on the map.
 	 * @param path Route path from RouteService.search response.
-	 * @param fromCoordinate Coordinate [lng, lat] of start point.
-	 * @param toCoordinate Coordinate [lng, lat] of end point.
+	 * @param markerLocations Coordinate([lng, lat]) array of markers, order from beginning to end.
 	 */
-	render(path: IRoutePath, fromCoordinate: [
-		number,
-		number
-	], toCoordinate: [
+	render(path: IRoutePath, markerLocations: Array<[
 		number,
 		number
-	]): void;
+	]>): void;
 	/**
 	 * @description Remove route from the map.
 	 */
@@ -1230,7 +1434,7 @@ export declare class RoutePainter {
 	private _renderSolidLines;
 	private _renderDashedLines;
 	private _renderConnectors;
-	private _renderFromToMarkers;
+	private _renderMarkers;
 	private _addCollectionSource;
 	private _addLineLayer;
 	private _addTriangleLayer;
@@ -1239,6 +1443,6 @@ export declare class RoutePainter {
 export declare const OFFSET: number;
 export declare const PAGE: number;
 export declare const version: string;
-export type { ControlPosition, Map as MaplibreMap, MapLayerEventType, FilterSpecification, PointLike, } from "maplibre-gl";
+export type { ControlPosition, Map as MaplibreMap, MapLayerEventType, FilterSpecification, PointLike, MapGeoJSONFeature, } from "maplibre-gl";
 
 export {};