@baidumap/mapv-three 1.2.1 → 1.3.0

package/dist/types/threemap/services/boundary/Boundary.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 行政区划边界服务
+ *
+ * 支持以下功能：
+ * - 获取省、直辖市的轮廓线坐标
+ * - 仅支持百度地图API
+ * - 返回坐标数组格式的边界数据
+ *
+ * @category Services
+ * @example
+ * ```javascript
+ * // 创建百度地图边界服务
+ * const boundary = new mapvthree.Services.Boundary({
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU
+ * });
+ *
+ * // 获取山东省边界
+ * boundary.get('山东省', (result) => {
+ *     console.log('边界坐标:', result.boundaries);
+ * });
+ * ```
+ */
+export class Boundary {
+    /**
+     * 创建边界服务实例
+     * @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;
+    _boundary: Boundary_Bd | Boundary_Tdt;
+    /**
+     * 创建具体的边界实现实例
+     * @param {Object} options 配置参数
+     * @returns {Boundary_Bd|Boundary_Tdt} 具体的实现实例
+     * @private
+     */
+    private _createInstance;
+    /**
+     * 获取行政区划边界坐标
+     * @param {string} name 行政区划名称，如'山东省'、'北京市'、'台湾省'等
+     * @param {Function} cbk 回调函数，返回边界数据
+     * @param {Object} cbk.result 边界数据结果
+     * @param {Array<Array<Array<number>>>} cbk.result.boundaries 边界坐标数组，每个元素是一个坐标环
+     * @example
+     * ```javascript
+     * boundary.get('山东省', (result) => {
+     *     // result.boundaries 是一个数组，每个元素是一个坐标环
+     *     // 每个坐标环是一个坐标数组，每个坐标是 [lng, lat] 格式
+     *     console.log('边界数量:', result.boundaries.length);
+     *     console.log('第一个边界坐标:', result.boundaries[0]);
+     * });
+     * ```
+     */
+    get(name: string, cbk: Function): void;
+    /**
+     * 返回服务名称
+     * @returns {string} 服务名称
+     */
+    toString(): string;
+}
+import { Boundary_Bd } from './Boundary_Bd.js';
+import { Boundary_Tdt } from './Boundary_Tdt.js';

package/dist/types/threemap/services/boundary/Boundary_Bd.d.ts

@@ -0,0 +1,56 @@
+export class Boundary_Bd {
+    constructor(options?: {});
+    options: {};
+    /**
+     * 检查是否为渤海区域
+     * @param {Object} pt 坐标点
+     * @returns {boolean}
+     */
+    _isBohai(pt: Object): boolean;
+    /**
+     * 检查是否为澳门区域
+     * @param {Object} pt 坐标点
+     * @returns {boolean}
+     */
+    _isMacao(pt: Object): boolean;
+    /**
+     * 处理海南地区的特殊逻辑
+     * @param {Object} pt 当前坐标点
+     * @param {Object} nextpt 下一个坐标点
+     * @param {number} j 当前索引
+     * @param {Object} hainanInfo 海南信息对象
+     */
+    _dealHainan(pt: Object, nextpt: Object, j: number, hainanInfo: Object): void;
+    /**
+     * 处理单个坐标记录
+     * @param {Array} rec 坐标记录
+     * @param {string} name 地区名称
+     * @returns {Array} 处理后的坐标数组
+     */
+    _processCoordinateRecord(rec: any[], name: string): any[];
+    /**
+     * 分割海南边界线
+     * @param {Array} coordinates 坐标数组
+     * @param {Object} hainanInfo 海南信息
+     * @returns {Array} 分割后的边界线数组
+     */
+    _splitHainanBoundary(coordinates: any[], hainanInfo: Object): any[];
+    /**
+     * 获取省、直辖市、县的轮廓线坐标
+     * @param {String} name 查询省、直辖市或县的名称
+     * @param {Function} cbk 回调函数，成功返回一个轮廓线的数组（有些地区由多部分构成）,失败数组长度为0
+     *                       数组形式如下：
+     *                       arr[0] = [[x1, y1], [x2, y2], [x3, y3], ...]
+     *                       arr[1] = [[x1, y1], [x2, y2], [x3, y3], ...]
+     *                       ....
+     */
+    get(name: string, cbk: Function): void;
+    /**
+     * 处理边界响应数据
+     * @param {Object} jsonBoundaries 边界响应数据
+     * @param {string} name 地区名称
+     * @param {Object} results 结果对象
+     */
+    _processBoundariesResponse(jsonBoundaries: Object, name: string, results: Object): void;
+    toString(): string;
+}

package/dist/types/threemap/services/boundary/Boundary_Tdt.d.ts

@@ -0,0 +1,17 @@
+export class Boundary_Tdt {
+    constructor(options?: {});
+    options: {};
+    /**
+     * 解析WKT边界为坐标数组
+     * @param {string} wkt WKT字符串
+     * @returns {Array} 坐标数组
+     */
+    _parseWktBoundary(wkt: string): any[];
+    /**
+     * 获取行政区划边界
+     * @param {string} name 行政区划名称或adcode
+     * @param {function} cbk 回调函数，返回 {boundaries: [ [ [lng, lat], ... ], ... ]}
+     */
+    get(name: string, cbk: Function): void;
+    toString(): string;
+}

package/dist/types/threemap/services/common/baiduCommon.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @file 公共部分
+ */
+/**
+ * 状态码StatusCodes常量
+ */
+export const BMAP_STATUS_SUCCESS: 0;
+export const BMAP_STATUS_CITY_LIST: 1;
+export const BMAP_STATUS_UNKNOWN_LOCATION: 2;
+export const BMAP_STATUS_UNKNOWN_ROUTE: 3;
+export const BMAP_STATUS_INVALID_KEY: 4;
+export const BMAP_STATUS_INVALID_REQUEST: 5;
+export const BMAP_STATUS_PERMISSION_DENIED: 6;
+export const BMAP_STATUS_SERVICE_UNAVAILABLE: 7;
+export const BMAP_STATUS_TIMEOUT: 8;
+/**
+ * 道路类型RouteTypes常量
+ */
+export const BMAP_ROUTE_TYPE_DEFAULT: 0;
+export const BMAP_ROUTE_TYPE_TRANSIT: 1;
+export const BMAP_ROUTE_TYPE_WALKING: 2;
+export const BMAP_ROUTE_TYPE_DRIVING: 3;
+export const BMAP_ROUTE_TYPE_RIDING: 6;
+/**
+ * 起终点状态常量
+ */
+export const BMAP_ROUTE_STATUS_NORMAL: 0;
+export const BMAP_ROUTE_STATUS_EMPTY: 1;
+export const BMAP_ROUTE_STATUS_ADDRESS: 2;
+/**
+ * 请求类型QueryTypes常量
+ * @private
+ */
+export const QUERY_TYPE_CARPORT_LIST: "carport_list";
+export const QUARY_TYPE_CARPORT_AUTH: "carport_auth";
+export const QUERY_TYPE_CURRENT_CITY: "cur";
+export const QUERY_TYPE_CENTER: "cen";
+export const QUERY_TYPE_POI_SEARCH: "s";
+export const QUERY_TYPE_POI_SEARCH_CON: "con";
+export const QUERY_TYPE_SEARCH_INBOUNDS: "bd";
+export const QUERY_TYPE_SEARCH_NEARBY: "nb";
+export const QUERY_TYPE_TRANSIT: "bt";
+export const QUERY_TYPE_DRIVING: "nav";
+export const QUERY_TYPE_WALKING: "walk";
+export const QUERY_TYPE_GEOCODER: "gc";
+export const QUERY_TYPE_REVERSE_GEOCODER: "rgc";
+export const QUERY_TYPE_LOCALCITY: "dec";
+export const QUERY_TYPE_IPLOCCITY: "iploc";
+export const QUERY_TYPE_TRANSIT_SINGLE: "bse";
+export const QUERY_TYPE_DRIVING_SINGLE: "nse";
+export const QUERY_TYPE_BUSLIST: "s";
+export const QUERY_TYPE_BUSLINE: "bsl";
+export const QUERY_TYPE_SEARCH_INBOUNDS_MULTIKEY: "bda";
+export const QUERY_TYPE_SEARCH_MULTIKEY: "sa";
+export const QUERY_TYPE_SEARCH_NEARBY_MULTIKEY: "nba";
+export const QUERY_TYPE_DARG: "drag";
+export const QUERY_TYPE_EXT: "ext";
+export const QUERY_TYPE_EXTS: "exts";
+export const QUERY_TYPE_IPLOCATION: "hip";
+export const QUERY_TYPE_RIDING: "ride";
+export const QUERY_TYPE_DIRECTION: "drct";
+export const QUERY_TYPE_TRUCKROUTE: "ldt";
+export const QUERY_TYPE_POI_PLACE: "place";
+/**
+ * 返回类型ReturnTypes常量
+ * @private
+ */
+export const RETURN_TYPE_CURRENT_CITY: 2;
+export const RETURN_TYPE_CENTER: 4;
+export const RETURN_TYPE_CITY_LIST: 7;
+export const RETURN_TYPE_POI_SEARCH: 11;
+export const RETURN_TYPE_SEARCH_NEARBY: 12;
+export const RETURN_TYPE_TRANSIT: 14;
+export const RETURN_TYPE_BUSLIST: 15;
+export const RETURN_TYPE_BUSLINE: 18;
+export const RETURN_TYPE_DRIVING: 20;
+export const RETURN_TYPE_SEARCH_INBOUNDS: 21;
+export const RETURN_TYPE_NAV_ADDRESS: 19;
+export const RETURN_TYPE_ROUTE_ADDRESS: 23;
+export const RETURN_TYPE_SPECIAL_REGION: 26;
+export const RETURN_TYPE_NODATA_REGION: 28;
+export const RETURN_TYPE_WALKING: 31;
+export const RETURN_TYPE_GEOCODER: 35;
+export const RETURN_TYPE_REVERSE_GEOCODER: 44;
+export const RETURN_TYPE_SEARCH_INBOUNDS_MULTIKEY: 45;
+export const RETURN_TYPE_SEARCH_MULTIKEY: 46;
+export const RETURN_TYPE_SEARCH_NEARBY_MULTIKEY: 47;
+/**
+ * 区域设置参数类型常量
+ */
+export const LOC_TYPE_UNKNOWN: -1;
+export const LOC_TYPE_MAP: 0;
+export const LOC_TYPE_POINT: 1;
+export const LOC_TYPE_STRING: 2;
+export const LOC_TYPE_NUMBER: 3;
+/**
+ * POI点类型常量
+ */
+export const BMAP_POI_TYPE_NORMAL: 0;
+export const BMAP_POI_TYPE_BUSSTOP: 1;
+export const BMAP_POI_TYPE_BUSLINE: 2;
+export const BMAP_POI_TYPE_SUBSTOP: 3;
+export const BMAP_POI_TYPE_SUBLINE: 4;
+export const DIRECTION_RETURN_TYPE_UNCLEAR: 1;
+export const DIRECTION_RETURN_TYPE_CLEAR: 2;
+/**
+ * 公交出行方案类型，TransitType
+ */
+export const BMAP_TRANSIT_TYPE_IN_CITY: 0;
+export const BMAP_TRANSIT_TYPE_CROSS_CITY: 1;
+/**
+ * VehicleType常量，用作识别direction api返回的交通方式类型判断，不开放
+ * @const
+ */
+export const BMAP_VEHICLE_TYPE_BUS: 3;
+export const BMAP_VEHICLE_TYPE_DRIVING: 4;
+export const BMAP_VEHICLE_TYPE_TRAIN: 1;
+export const BMAP_VEHICLE_TYPE_AIRPLANE: 2;
+export const BMAP_VEHICLE_TYPE_WALKING: 5;
+export const BMAP_VEHICLE_TYPE_COACH: 6;
+/**
+ * TransitPlanType常量，某一路段的交通方式
+ * @const
+ */
+export const BMAP_TRANSIT_PLAN_TYPE_ROUTE: 0;
+export const BMAP_TRANSIT_PLAN_TYPE_LINE: 1;
+/**
+ * LineTypes常量
+ * @const
+ */
+export const BMAP_LINE_TYPE_BUS: 0;
+export const BMAP_LINE_TYPE_SUBWAY: 1;
+export const BMAP_LINE_TYPE_FERRY: 2;
+export const BMAP_LINE_TYPE_TRAIN: 3;
+export const BMAP_LINE_TYPE_AIRPLANE: 4;
+export const BMAP_LINE_TYPE_COACH: 5;

package/dist/types/threemap/services/common/baiduRequest.d.ts

@@ -0,0 +1,3 @@
+export namespace SearchRequestMgr {
+    function request(params: any, userData: any, path: any, disableLog: any): Promise<boolean | undefined>;
+}

package/dist/types/threemap/services/common/baiduUtils.d.ts

@@ -0,0 +1,13 @@
+export namespace SUtil {
+    function unique(a: any): any[];
+    function parseGeo(geo: string, usePoint: any): number | {
+        geoType: number;
+        geo: any[][];
+    } | {
+        type: any;
+    } | undefined;
+    function pathToPoints(path: string): any[];
+    function pointsToString(points: any[]): string;
+    function getX(coord: any): any;
+    function getY(coord: any): any;
+}

package/dist/types/threemap/services/common/tdtRequest.d.ts

@@ -0,0 +1,34 @@
+export class ScriptLoader {
+    /**
+     * 请求天地图API
+     * @param {string} url - 脚本文件URL
+     * @returns {Promise} 返回Promise，resolve时包含tdt_loadResult的内容
+     */
+    static request(url: string): Promise<any>;
+    /**
+     * 获取可用的脚本加载器实例
+     * @param {Window} win - 目标窗口对象
+     * @returns {ScriptLoader} 脚本加载器实例
+     */
+    static getObject(win?: Window): ScriptLoader;
+    static getElementWindow(element: any): any;
+    static processEventArguments(args: any): any;
+    static createCallback(context: any, callback: any): (...args: any[]) => void;
+    objName: string;
+    win: Window & typeof globalThis;
+    charset: string;
+    src: string | null;
+    callback: ((...args: any[]) => void) | null;
+    oScript: HTMLScriptElement | null;
+    running: boolean;
+    /**
+     * 加载脚本文件
+     * @param {string} src - 脚本文件URL
+     * @param {string} charset - 字符编码，默认为utf-8
+     * @param {Object} context - 回调函数的上下文
+     * @param {Function} callback - 加载完成后的回调函数
+     */
+    loadScript(src: string, charset: string, context: Object, callback: Function): void;
+    handleLoadComplete(): void;
+    cleanupScriptElement(): void;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * 设置LBS服务
+ * @param {string} source 服务类型，{@link Services.API_SOURCE_BAIDU}或{@link Services.API_SOURCE_TIANDITU}
+ */
+export function setApiSource(source: string): void;
+/**
+ * 获取LBS服务
+ * @returns {string} 服务类型，{@link Services.API_SOURCE_BAIDU}或{@link Services.API_SOURCE_TIANDITU}
+ */
+export function getApiSource(): string;

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

@@ -0,0 +1,8 @@
+/**
+ * 百度地图LBS服务，坐标系为bd09，默认是百度LBS服务
+ */
+export const API_SOURCE_BAIDU: "baidu";
+/**
+ * 天地图LBS服务，坐标系为CGCS2000（和wgs84误差接近）
+ */
+export const API_SOURCE_TIANDITU: "tdt";

package/dist/types/threemap/services/district/DistrictLayer.d.ts

@@ -0,0 +1,167 @@
+/**
+ * 行政区划聚合图层
+ *
+ * 支持以下功能：
+ * - 自动获取行政区划边界数据
+ * - 仅支持百度地图API
+ * - 多层级行政区划显示（省级、市级）
+ * - 自动视口跳转
+ *
+ * @category Services
+ * @example
+ * ```javascript
+ * // 创建百度地图行政区划图层
+ * const district = new mapvthree.Services.DistrictLayer({
+ *     name: '(山东省)',
+ *     kind: 0, // 省级
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU,
+ *     renderOptions: {
+ *         engine: engine,
+ *         fillColor: '#618bf8',
+ *         fillOpacity: 0.6,
+ *         autoViewport: true,
+ *     },
+ * });
+ * ```
+ */
+export class DistrictLayer {
+    /**
+     * 创建行政区划聚合图层实例
+     * @param {Object} options 配置参数
+     * @param {string} options.name 行政区划名称，格式如'(山东省)'、'(北京市)'
+     * @param {number} options.kind 行政区划层级，0=省级，1=市级，2=区县级
+     * @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} optiosn.renderOptiosn.autoViewport 自动跳转到区域中心
+     * @param {string|Array<string>} [options.renderOptions.fillColor='#ff0'] 填充颜色，支持单个颜色或颜色数组
+     * @param {number} [options.renderOptions.fillOpacity=0.6] 填充透明度，0-1之间
+     * @returns {DistrictLayer_Bd|DistrictLayer_Tdt} 行政区划图层实例
+     */
+    constructor(options?: {
+        name: string;
+        kind: number;
+        apiSource?: string | undefined;
+        renderOptions?: {
+            engine: Engine;
+        } | undefined;
+    });
+    renderOptions: {};
+    apiSource: string;
+    options: {
+        name: string;
+        kind: number;
+        apiSource?: string | undefined;
+        renderOptions?: {
+            engine: Engine;
+        } | undefined;
+    };
+    autoViewport: any;
+    _distrctLayer: DistrictLayer_Bd | DistrictLayer_Tdt;
+    _engine: any;
+    _fillColor: any;
+    _fillOpacity: any;
+    /**
+     * 异步加载行政区划数据
+     * @private
+     */
+    private _loadDistrict;
+    _data: Object | undefined;
+    /**
+     * 计算区域中心点和边界范围
+     * @private
+     * @returns {Object} 包含center和bounds的对象
+     */
+    private _calculateBounds;
+    /**
+     * 递归展平坐标数组
+     * @private
+     * @param {Array} coords 坐标数组
+     * @returns {Array} 展平后的坐标数组
+     */
+    private _flattenCoordinates;
+    /**
+     * 自动飞行到区域中心
+     * @private
+     */
+    private _flyToDistrict;
+    /**
+     * 渲染行政区划到地图
+     * @private
+     */
+    private renderMap;
+    _layer: any;
+    /**
+     * 重置图层，移除当前渲染的行政区划
+     * @example
+     * ```javascript
+     * district.reset();
+     * ```
+     */
+    reset(): void;
+    /**
+     * 设置行政区划名称
+     * @param {string} name 行政区划名称，格式如'(山东省)'、'(北京市)'
+     * @example
+     * ```javascript
+     * district.setName('(广东省)');
+     * ```
+     */
+    setName(name: string): void;
+    /**
+     * 设置行政区划层级
+     * @param {number} kind 行政区划层级，0=省级，1=市级，2=区县级
+     * @example
+     * ```javascript
+     * district.setKind(1); // 设置为市级
+     * ```
+     */
+    setKind(kind: number): void;
+    /**
+     * 设置行政区划选项，支持同时更新名称和层级
+     * @param {Object} options 配置选项
+     * @param {string} [options.name] 行政区划名称
+     * @param {number} [options.kind] 行政区划层级
+     * @example
+     * ```javascript
+     * district.setOptions({
+     *     name: '(广东省)',
+     *     kind: 1,
+     * });
+     * ```
+     */
+    setOptions(options: {
+        name?: string | undefined;
+        kind?: number | undefined;
+    }): void;
+    /**
+     * 创建具体的行政区划实现实例
+     * @param {Object} options 配置参数
+     * @returns {DistrictLayer_Bd|DistrictLayer_Tdt} 具体的实现实例
+     * @private
+     */
+    private _createInstance;
+    /**
+     * 搜索行政区划边界数据
+     * @param {Object} options 搜索选项
+     * @param {string} [options.name] 行政区划名称
+     * @param {number} [options.kind] 行政区划层级
+     * @param {Function} callback 回调函数，返回边界数据
+     * @example
+     * ```javascript
+     * district.searchBoundary({
+     *     name: '(山东省)',
+     *     kind: 1,
+     * }, (result) => {
+     *     console.log('边界数据:', result.boundaries);
+     * });
+     * ```
+     */
+    searchBoundary(options: {
+        name?: string | undefined;
+        kind?: number | undefined;
+    }, callback: Function): void;
+}
+import { DistrictLayer_Bd } from './DistrictLayer_Bd';
+import { DistrictLayer_Tdt } from './DistrictLayer_Tdt';

package/dist/types/threemap/services/district/DistrictLayer_Bd.d.ts

@@ -0,0 +1,41 @@
+export class DistrictLayer_Bd {
+    constructor(options?: {});
+    options: {};
+    _map: any;
+    _layer: any;
+    _data: Object | null;
+    setOptions(options: any): void;
+    setName(name: any): void;
+    setKind(kind: any): void;
+    _loadDistrict(): Promise<Object>;
+    /**
+     * 解析百度地图API返回的边界数据为GeoJSON格式
+     * @param {Object} jsonBoundaries 百度地图API返回的边界数据
+     * @returns {Object} GeoJSON格式的FeatureCollection
+     * @private
+     */
+    private _parseGeoData;
+    /**
+     * 转换GeoJSON坐标，将MC坐标系转换为LL坐标系
+     * @param {Object} geojson GeoJSON数据
+     * @private
+     */
+    private geojsonCoordConvert;
+    /**
+     * 将GeoJSON数据转换为边界数组格式
+     * @param {Object} geojson GeoJSON数据
+     * @returns {Object} 边界数组格式数据 {boundaries: Array}
+     */
+    geojson2boundaries(geojson: Object): Object;
+    /**
+     * 搜索行政区划边界数据
+     * @param {Object} options 搜索选项
+     * @param {string} [options.name] 行政区划名称
+     * @param {number} [options.kind] 行政区划层级
+     * @param {Function} callback 回调函数，返回边界数据
+     */
+    searchBoundary(options: {
+        name?: string | undefined;
+        kind?: number | undefined;
+    }, callback: Function): void;
+}

package/dist/types/threemap/services/district/DistrictLayer_Tdt.d.ts

@@ -0,0 +1,47 @@
+export class DistrictLayer_Tdt {
+    constructor(options?: {});
+    options: {};
+    _data: Object | null;
+    setOptions(options: any): void;
+    setName(name: any): void;
+    setKind(kind: any): void;
+    _loadDistrict(): Promise<Object>;
+    /**
+     * 请求天地图行政区划数据
+     * @param {string} name 行政区划名称
+     * @param {number} kind 行政区划层级
+     * @returns {Promise<Object>} 天地图API返回的数据
+     * @private
+     */
+    private _requestDistrictData;
+    /**
+     * 解析天地图API返回的边界数据为GeoJSON格式
+     * @param {Object} jsonBoundaries 天地图API返回的边界数据
+     * @returns {Object} GeoJSON格式的FeatureCollection
+     * @private
+     */
+    private _parseGeoData;
+    /**
+     * 转换GeoJSON坐标，确保坐标是数值类型
+     * @param {Object} geojson GeoJSON数据
+     * @private
+     */
+    private geojsonCoordConvert;
+    /**
+     * 将GeoJSON数据转换为边界数组格式
+     * @param {Object} geojson GeoJSON数据
+     * @returns {Object} 边界数组格式数据 {boundaries: Array}
+     */
+    geojson2boundaries(geojson: Object): Object;
+    /**
+     * 搜索行政区划边界数据
+     * @param {Object} options 搜索选项
+     * @param {string} [options.name] 行政区划名称
+     * @param {number} [options.kind] 行政区划层级
+     * @param {Function} callback 回调函数，返回边界数据
+     */
+    searchBoundary(options: {
+        name?: string | undefined;
+        kind?: number | undefined;
+    }, callback: Function): void;
+}