@baidumap/mapv-three 1.2.0 → 1.3.0

package/dist/types/threemap/services/geocoder/Geocoder.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 地理编码服务
+ *
+ * 支持以下功能：
+ * - 地址转坐标（地理编码）
+ * - 坐标转地址（逆地理编码）
+ * - 支持百度地图和天地图API
+ *
+ * @category Services
+ * @example
+ * ```javascript
+ * // 创建百度地图地理编码服务
+ * const geocoder = new mapvthree.Services.Geocoder({
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU,
+ * });
+ *
+ * // 地址转坐标
+ * geocoder.getPoint('北京市朝阳区', (result) => {
+ *     console.log('坐标:', result.point);
+ *     console.log('地址:', result.address);
+ * });
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // 创建天地图地理编码服务
+ * const geocoder = new mapvthree.Services.Geocoder({
+ *     apiSource: mapvthree.Services.API_SOURCE_TIANDITU,
+ * });
+ *
+ * // 坐标转地址
+ * geocoder.getLocation([116.404, 39.915], (result) => {
+ *     console.log('地址:', result.address);
+ *     console.log('坐标:', result.point);
+ * });
+ * ```
+ */
+export class Geocoder {
+    /**
+     * 创建地理编码服务实例
+     * @param {Object} options 配置参数
+     * @param {string} [options.apiSource] API数据源。
+     * 可以配置为{@link Services.API_SOURCE_BAIDU}或{@link Services.API_SOURCE_TIANDITU}，默认使用配置的数据源
+     */
+    constructor(options?: {
+        apiSource?: string | undefined;
+    });
+    options: {
+        apiSource?: string | undefined;
+    };
+    apiSource: string;
+    _gc: Geocoder_Bd | Geocoder_Tdt;
+    /**
+     * 创建具体的地理编码实现实例
+     * @param {Object} options 配置参数
+     * @returns {Geocoder_Bd|Geocoder_Tdt} 具体的实现实例
+     * @private
+     */
+    private _createInstance;
+    /**
+     * 地址转坐标（地理编码）
+     * @param {string} address 地址字符串
+     * @param {Function} callback 回调函数，返回地理编码结果
+     * @param {Object} callback.result 地理编码结果
+     * @param {Array<number>} callback.result.point 坐标点 [lng, lat]
+     * @param {string} callback.result.address 地址信息
+     * @param {string} [city] 城市名称，用于限定搜索范围
+     * @example
+     * ```javascript
+     * geocoder.getPoint('北京市朝阳区', (result) => {
+     *     console.log('坐标:', result.point); // [116.404, 39.915]
+     *     console.log('地址:', result.address);
+     * }, '北京市');
+     * ```
+     */
+    getPoint(address: string, callback: Function, city?: string): Promise<any> | undefined;
+    /**
+     * 坐标转地址（逆地理编码）
+     * @param {Array<number>} point 坐标点 [lng, lat]
+     * @param {Function} callback 回调函数，返回逆地理编码结果
+     * @param {Object} callback.result 逆地理编码结果
+     * @param {string} callback.result.address 地址信息
+     * @param {Array<number>} callback.result.point 坐标点 [lng, lat]
+     * @param {Object} [opts] 额外选项
+     * @example
+     * ```javascript
+     * geocoder.getLocation([116.404, 39.915], (result) => {
+     *     console.log('地址:', result.address);
+     *     console.log('坐标:', result.point);
+     * });
+     * ```
+     */
+    getLocation(point: Array<number>, callback: Function, opts?: Object): Promise<{
+        address: any;
+        addressComponents: any;
+        point: any;
+    } | null> | undefined;
+}
+import { Geocoder_Bd } from './Geocoder_Bd';
+import { Geocoder_Tdt } from './Geocoder_Tdt';

package/dist/types/threemap/services/geocoder/Geocoder_Bd.d.ts

@@ -0,0 +1,24 @@
+export class Geocoder_Bd {
+    constructor(options?: {});
+    options: {};
+    _baiduMercatorProjection: any;
+    getPoint(address: any, callback: any, city: any): Promise<any> | undefined;
+    getLocation(point: any, callback: any, opts: any): Promise<{
+        point: any;
+        address: any;
+        addressComponents: {};
+        surroundingPois: {
+            title: any;
+            uid: any;
+            point: any;
+            city: any;
+            _poiType: any;
+            type: number;
+            address: any;
+            postcode: any;
+            phoneNumber: any;
+        }[];
+        business: any;
+        content: any;
+    } | null> | undefined;
+}

package/dist/types/threemap/services/geocoder/Geocoder_Tdt.d.ts

@@ -0,0 +1,10 @@
+export class Geocoder_Tdt {
+    constructor(options?: {});
+    options: {};
+    getPoint(address: any, callback: any, city: any): Promise<any> | undefined;
+    getLocation(point: any, callback: any): Promise<{
+        address: any;
+        addressComponents: any;
+        point: any;
+    } | null> | undefined;
+}

package/dist/types/threemap/services/index.d.ts

@@ -0,0 +1,11 @@
+export { Geocoder } from "./geocoder/Geocoder";
+export { LocalSearch } from "./localSearch/LocalSearch";
+export { AutoComplete } from "./autoComplete/AutoComplete";
+export { Boundary } from "./boundary/Boundary";
+export { DistrictLayer } from "./district/DistrictLayer";
+export { DrivingRoute } from "./routeSearch/DrivingRoute";
+export { RidingRoute } from "./routeSearch/RidingRoute";
+export { TransitRoute } from "./routeSearch/TransitRoute";
+export { WalkingRoute } from "./routeSearch/WalkingRoute";
+export * from "./constants";
+export { setApiSource, getApiSource } from "./configs";

package/dist/types/threemap/services/localSearch/LocalResult.d.ts

@@ -0,0 +1,47 @@
+export class LocalResult {
+    constructor(opts?: {});
+    /**
+     * 检索关键字
+     */
+    keyword: any;
+    /**
+     * 当前页面索引
+     */
+    pageIndex: any;
+    /**
+     * 当前页面结果数
+     */
+    currentNumPois: any;
+    /**
+     * 总结果数
+     */
+    total: any;
+    /**
+     * 总页数
+     */
+    numPages: number;
+    /**
+     * 中心点（周边检索）
+     */
+    center: any;
+    /**
+     * 半径（周边检索）
+     */
+    radius: any;
+    /**
+     * 范围（范围检索）
+     */
+    bounds: any;
+    /**
+     * 检索结果所在城市
+     */
+    city: any;
+    /**
+     * 检索结果所在省份
+     */
+    province: any;
+    /**
+     * 结果点数组
+     */
+    pois: any;
+}

package/dist/types/threemap/services/localSearch/LocalSearch.d.ts

@@ -0,0 +1,175 @@
+/**
+ * 本地搜索服务
+ *
+ * 支持以下功能：
+ * - 关键词搜索POI（兴趣点）
+ * - 支持百度地图和天地图API
+ * - 分页搜索支持
+ * - 自动渲染搜索结果到地图
+ *
+ * @category Services
+ * @example
+ * ```javascript
+ * // 创建百度地图本地搜索服务
+ * const localSearch = new mapvthree.Services.LocalSearch({
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU,
+ *     pageCapacity: 20,
+ *     renderOptions: {
+ *         engine: engine,
+ *         autoViewport: true,
+ *     },
+ * });
+ *
+ * // 搜索餐厅
+ * localSearch.search('餐厅', {
+ *     pageNum: 0,
+ * });
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // 创建天地图本地搜索服务
+ * const localSearch = new mapvthree.Services.LocalSearch({
+ *     apiSource: mapvthree.Services.API_SOURCE_TIANDITU,
+ *     pageCapacity: 10,
+ *     renderOptions: {
+ *         engine: engine,
+ *         autoViewport: false,
+ *     },
+ * });
+ *
+ * // 搜索酒店
+ * const result = await localSearch.search('酒店');
+ * console.log('搜索结果:', result.pois);
+ * ```
+ */
+export class LocalSearch {
+    static DEFAULT_PAGE_CAPACITY: number;
+    static MIN_PAGE_CAPACITY: number;
+    static MAX_PAGE_CAPACITY: number;
+    static DEFAULT_RADIUS: number;
+    static MAX_RADIUS: number;
+    static DEFAULT_PAGE_NUM: number;
+    /**
+     * 创建本地搜索服务实例
+     * @param {Object} options 配置参数
+     * @param {number} [options.pageCapacity=10] 每页结果数，默认10
+     * @param {number} [options.pageNum=0] 页码，默认0
+     * @param {string} [options.apiSource] API数据源。
+     * 可以配置为{@link Services.API_SOURCE_BAIDU}或{@link Services.API_SOURCE_TIANDITU}，默认使用配置的数据源
+     * @param {Object} [options.renderOptions] 渲染配置
+     * @param {Engine} options.renderOptions.engine 地图引擎实例
+     * @param {boolean} [options.renderOptions.autoViewport=true] 是否自动调整地图视图以包含所有搜索结果
+     */
+    constructor(options?: {
+        pageCapacity?: number | undefined;
+        pageNum?: number | undefined;
+        apiSource?: string | undefined;
+        renderOptions?: {
+            engine: Engine;
+            autoViewport?: boolean | undefined;
+        } | undefined;
+    });
+    result: null;
+    _markers: any[];
+    _popup: null;
+    options: {
+        pageCapacity?: number | undefined;
+        pageNum?: number | undefined;
+        apiSource?: string | undefined;
+        renderOptions?: {
+            engine: Engine;
+            autoViewport?: boolean | undefined;
+        } | undefined;
+    };
+    apiSource: string;
+    _local: any;
+    _engine: any;
+    _createInstance(options: any): any;
+    /**
+     * 搜索POI（兴趣点）
+     * @param {string} keyword 搜索关键词
+     * @param {Object} [opts={}] 搜索选项
+     * @param {number} [opts.pageCapacity] 每页结果数
+     * @param {number} [opts.pageNum] 页码
+     * @returns {Promise<Object>} 搜索结果
+     * @param {Array<Object>} result.pois POI列表
+     * @param {Array<number>} result.pois[].point POI坐标 [lng, lat]
+     * @param {string} result.pois[].title POI标题
+     * @param {string} result.pois[].address POI地址
+     * @example
+     * ```javascript
+     * const result = await localSearch.search('餐厅', {
+     *     pageCapacity: 20,
+     *     pageNum: 0,
+     * });
+     * console.log('找到', result.pois.length, '个餐厅');
+     * ```
+     */
+    search(keyword: string, opts?: {
+        pageCapacity?: number | undefined;
+        pageNum?: number | undefined;
+    }): Promise<Object>;
+    /**
+     * 跳转到指定页码
+     * @param {number} pageNum 页码
+     */
+    gotoPage(pageNum: number): void;
+    /**
+     * 渲染搜索结果到地图
+     * @param {Object} result 搜索结果
+     * @param {Array<Object>} result.pois POI列表
+     * @private
+     */
+    private renderMap;
+    /**
+     * 设置在索引为index的标注点处显示弹窗
+     * @param {number} index 索引
+     */
+    setPopupByIndex(index: number): void;
+    clearMap(): void;
+    /**
+     * 设置检索结果每页容量
+     * @param {number} cap 每页容量，支持1-100
+     * @example
+     * ```javascript
+     * localSearch.setPageCapacity(20); // 设置每页显示20个结果
+     * ```
+     */
+    setPageCapacity(cap: number): void;
+    /**
+     * 获取当前每页容量
+     * @returns {number} 每页容量
+     * @example
+     * ```javascript
+     * const capacity = localSearch.getPageCapacity();
+     * console.log('当前每页容量:', capacity);
+     * ```
+     */
+    getPageCapacity(): number;
+    /**
+     * 设置页码
+     * @param {number} num 页码，从0开始
+     * @example
+     * ```javascript
+     * localSearch.setPageNum(1); // 设置第2页
+     * ```
+     */
+    setPageNum(num: number): void;
+    /**
+     * 获取当前页码
+     * @returns {number} 当前页码
+     * @example
+     * ```javascript
+     * const pageNum = localSearch.getPageNum();
+     * console.log('当前页码:', pageNum);
+     * ```
+     */
+    getPageNum(): number;
+    /**
+     * 获取搜索结果
+     * @returns {Object} 搜索结果
+     */
+    getResult(): Object;
+    clearResult(): void;
+}

package/dist/types/threemap/services/localSearch/LocalSearch_Bd.d.ts

@@ -0,0 +1,18 @@
+export class LocalSearch_Bd {
+    constructor(options?: {});
+    options: {};
+    _baiduMercatorProjection: any;
+    search(keyword: any, opts: any): Promise<LocalResult | undefined>;
+    /**
+     * 验证请求类型是否与返回的数据匹配
+     * @param {String} 请求类型qt
+     * @param {Number} 返回类型type
+     * @returns {Boolean} 是否匹配
+     */
+    _isReqDataMap: (qt: any, type: any) => boolean;
+    /**
+     * 根据poi类型格式化地址字段，其中地铁站和公交站的线路要去重
+     */
+    _formatAddr: (addr: any, poiType: any) => any;
+}
+import { LocalResult } from './LocalResult';

package/dist/types/threemap/services/localSearch/LocalSearch_Tdt.d.ts

@@ -0,0 +1,6 @@
+export class LocalSearch_Tdt {
+    constructor(options?: {});
+    options: {};
+    search(keyword: any, opts: any): Promise<LocalResult | undefined>;
+}
+import { LocalResult } from './LocalResult';

package/dist/types/threemap/services/routeSearch/BaseRoute.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 路线规划服务基类
+ * 提供路线规划的基础功能，包括路线搜索、地图渲染、标记点管理等
+ * 所有具体的路线规划服务类都继承自此类
+ *
+ * 主要功能：
+ * - 路线搜索和结果管理
+ * - 路线在地图上的可视化渲染
+ * - 起点、终点和途经点的标记显示
+ * - 自动视野调整
+ * - 地图元素的清理和管理
+ *
+ * @category Services
+ */
+export class BaseRoute {
+    /**
+     * 创建路线规划服务基类实例
+     * @param {object} options 配置选项
+     * @param {object} [options.renderOptions] 渲染选项
+     * @param {Engine} [options.renderOptions.engine] 渲染引擎实例
+     * @param {boolean} [options.renderOptions.autoViewport] 是否自动调整视野
+     */
+    constructor(options?: {
+        renderOptions?: {
+            engine?: Engine;
+            autoViewport?: boolean | undefined;
+        } | undefined;
+    });
+    /**
+     * 路线搜索结果
+     * @type {Object|null}
+     */
+    result: Object | null;
+    /**
+     * 路线线段对象数组
+     * @type {Array<Polyline>}
+     * @private
+     */
+    private _polylines;
+    /**
+     * 标记点对象数组
+     * @type {Array<Marker>}
+     * @private
+     */
+    private _markers;
+    options: {
+        renderOptions?: {
+            engine?: Engine;
+            autoViewport?: boolean | undefined;
+        } | undefined;
+    };
+    /**
+     * 搜索路线
+     * 根据起点和终点计算最优路线
+     * @param {Array<number>|THREE.Vector3|THREE.Vector2} start 起点坐标 [lng, lat]
+     * @param {Array<number>|THREE.Vector3|THREE.Vector2} end 终点坐标 [lng, lat]
+     * @param {object} [opts] 搜索选项
+     * @param {Array<Array<number>|THREE.Vector3|THREE.Vector2>} [opts.waypoints] 途经点坐标数组，只有{@link DrivingRoute}支持途经点
+     * @returns {Promise<Object>} 路线搜索结果
+     * @example
+     * ```javascript
+     * const result = await route.search(
+     *     new THREE.Vector3(116.404, 39.915, 0), // 起点
+     *     new THREE.Vector3(116.414, 39.925, 0), // 终点
+     *     {
+     *         waypoints: [new THREE.Vector3(116.409, 39.920, 0)] // 途经点
+     *     }
+     * );
+     * console.log('路线距离:', result.distance);
+     * console.log('预计时间:', result.duration);
+     * ```
+     */
+    search(start: Array<number> | THREE.Vector3 | THREE.Vector2, end: Array<number> | THREE.Vector3 | THREE.Vector2, opts?: {
+        waypoints?: any[] | undefined;
+    }): Promise<Object>;
+    /**
+     * 渲染路线到地图上
+     * 包括路线线段和标记点的渲染
+     * @param {Object} result 路线搜索结果
+     * @private
+     */
+    private renderMap;
+    /**
+     * 渲染路线线段
+     * 将路线路径绘制为折线对象
+     * @param {Object} result 路线搜索结果
+     * @private
+     */
+    private renderPly;
+    /**
+     * 渲染标记点
+     * 包括起点、终点和途经点的标记
+     * @param {Object} result 路线搜索结果
+     * @private
+     */
+    private renderMkr;
+    /**
+     * 清除地图上的路线元素
+     * 移除所有路线线段和标记点
+     * @private
+     */
+    private clearMap;
+    /**
+     * 获取路线搜索结果
+     * @returns {Object|null} 路线搜索结果
+     */
+    getResult(): Object | null;
+    /**
+     * 清除路线搜索结果
+     * @private
+     */
+    private clearResult;
+}

package/dist/types/threemap/services/routeSearch/DWRoute_Bd.d.ts

@@ -0,0 +1,46 @@
+export class DWRoute_Bd {
+    constructor(options?: {});
+    options: {};
+    _baiduMercatorProjection: any;
+    _d: {
+        plys: never[];
+        viaPts: never[];
+        viaPtsInfo: never[];
+        dragOverlays: never[];
+        tipLbl: null;
+        sliderMkr: null;
+        dragReqFlag: boolean;
+        cbkDragPt: null;
+        cbkPly: null;
+        isSearchByDrag: boolean;
+        curDragPly: null;
+        dragSrcCityCode: number;
+        dragEndCityCode: number;
+        mouseOnViaMkr: boolean;
+        cxtMenu: never[];
+    };
+    search(start: any, end: any, opts: any): Promise<{
+        walkingPaths: any[][];
+        paths: any[];
+    } | undefined>;
+    _searchOpts: any;
+    waypoints: string | undefined;
+    _processRaw(json: any, ud: any): {
+        walkingPaths: any[][];
+        paths: any[];
+    };
+    /**
+     * 本格式化起点和终点的请求串
+     * @param {Object|Array|Vector2|Vector3} dest 起点或终点对象
+     * @return {string} 格式化后的串
+     * @private
+     */
+    private _formatCoordYXString;
+    /**
+     * 判断是否为uid
+     * @param {string} uid uid
+     * @returns {boolean} 是否为uid
+     * @private
+     */
+    private _isUid;
+}

package/dist/types/threemap/services/routeSearch/DWRoute_Tdt.d.ts

@@ -0,0 +1,8 @@
+export class DWRoute_Tdt {
+    constructor(options?: {});
+    options: {};
+    search(start: any, end: any, opts: any): Promise<RouteResult | undefined>;
+    _searchOpts: any;
+    _pointsToString(points: any): any;
+}
+import { RouteResult } from './RouteResult';

package/dist/types/threemap/services/routeSearch/DrivingRoute.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 驾车路线规划服务类
+ * 提供驾车路线规划功能，支持百度地图和天地图两种数据源
+ * 继承自 {@link BaseRoute}，提供统一的路线规划接口
+ *
+ * 主要功能：
+ * - 根据起点和终点计算最优驾车路线
+ * - 支持途经点设置
+ * - 自动渲染路线到地图上
+ * - 支持多种数据源切换
+ * - 支持百度地图和天地图API
+ *
+ * @category Services
+ * @extends BaseRoute
+ * @example
+ * ```javascript
+ * // 创建驾车路线规划实例
+ * const drivingRoute = new DrivingRoute({
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU, // 使用百度地图数据源
+ *     renderOptions: {
+ *         engine: engine, // 渲染引擎
+ *         autoViewport: true // 自动调整视野
+ *     }
+ * });
+ *
+ * // 搜索路线
+ * const result = await drivingRoute.search(
+ *     new THREE.Vector3(116.404, 39.915, 0), // 起点坐标
+ *     new THREE.Vector3(116.414, 39.925, 0), // 终点坐标
+ *     {
+ *         waypoints: [new THREE.Vector3(116.409, 39.920, 0)] // 途经点
+ *     }
+ * );
+ * ```
+ */
+export class DrivingRoute extends BaseRoute {
+    /**
+     * 创建驾车路线规划服务实例
+     * @param {object} options 配置选项
+     * @param {string} [options.apiSource] API数据源。
+     * 可以配置为{@link Services.API_SOURCE_BAIDU}或{@link Services.API_SOURCE_TIANDITU}，默认使用配置的数据源
+     * @param {object} [options.renderOptions] 渲染选项
+     * @param {Engine} [options.renderOptions.engine] 渲染引擎实例
+     * @param {boolean} [options.renderOptions.autoViewport] 是否自动调整视野
+     * @example
+     * ```javascript
+     * const drivingRoute = new DrivingRoute({
+     *     renderOptions: {
+     *         engine: engine,
+     *         autoViewport: true
+     *     }
+     * });
+     * ```
+     */
+    constructor(options?: {
+        apiSource?: string | undefined;
+        renderOptions?: {
+            engine?: Engine;
+            autoViewport?: boolean | undefined;
+        } | undefined;
+    });
+    /**
+     * 查询类型：驾车路线规划
+     * @type {string}
+     * @readonly
+     */
+    readonly QUERY_TYPE: string;
+    /**
+     * 返回类型：驾车路线规划结果
+     * @type {number}
+     * @readonly
+     */
+    readonly RETURN_TYPE: number;
+    /**
+     * 路线类型：驾车路线
+     * @type {number}
+     * @readonly
+     */
+    readonly ROUTE_TYPE: number;
+    /**
+     * 服务名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+    /**
+     * API数据源类型
+     * @type {string}
+     * @private
+     */
+    private apiSource;
+    /**
+     * 具体的路线规划实现实例
+     * @type {DWRoute_Bd|DWRoute_Tdt}
+     * @private
+     */
+    private _dw;
+    /**
+     * 渲染引擎实例
+     * @type {Engine}
+     * @private
+     */
+    private _engine;
+    /**
+     * 创建具体的路线规划实现实例
+     * 根据API数据源类型创建对应的实现类
+     * @param {object} options 配置选项
+     * @returns {DWRoute_Bd|DWRoute_Tdt} 路线规划实现实例
+     * @private
+     */
+    private _createInstance;
+}
+import { BaseRoute } from './BaseRoute';