@baidumap/mapv-three 1.2.0 → 1.3.0

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

@@ -0,0 +1,63 @@
+/**
+ * 骑行路线规划服务类
+ * 提供骑行路线规划功能，计算最优骑行路径
+ * 继承自 {@link BaseRoute}，提供统一的路线规划接口
+ *
+ * 主要功能：
+ * - 根据起点和终点计算最优骑行路线
+ * - 支持途经点设置
+ * - 自动渲染路线到地图上
+ * - 仅支持百度地图API
+ *
+ * @category Services
+ * @extends BaseRoute
+ * @example
+ * ```javascript
+ * // 创建骑行路线规划实例
+ * const ridingRoute = new RidingRoute({
+ *     renderOptions: {
+ *         engine: engine, // 渲染引擎
+ *         autoViewport: true // 自动调整视野
+ *     }
+ * });
+ *
+ * // 搜索骑行路线
+ * const result = await ridingRoute.search(
+ *     new THREE.Vector3(116.404, 39.915, 0), // 起点坐标
+ *     new THREE.Vector3(116.414, 39.925, 0), // 终点坐标
+ * );
+ * ```
+ */
+export class RidingRoute extends BaseRoute {
+    /**
+     * 查询类型：骑行路线规划
+     * @type {string}
+     * @readonly
+     */
+    readonly QUERY_TYPE: string;
+    /**
+     * 路线类型：骑行路线
+     * @type {number}
+     * @readonly
+     */
+    readonly ROUTE_TYPE: number;
+    /**
+     * 服务名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+    /**
+     * 具体的路线规划实现实例
+     * @type {DWRoute_Bd}
+     * @private
+     */
+    private _dw;
+    /**
+     * 渲染引擎实例
+     * @type {Engine}
+     * @private
+     */
+    private _engine;
+}
+import { BaseRoute } from './BaseRoute';

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

@@ -0,0 +1,39 @@
+export class RouteResult {
+    constructor(opts?: {});
+    /**
+     * 起点
+     */
+    start: any;
+    /**
+     * 终点
+     */
+    end: any;
+    /**
+     * 途经点
+     */
+    waypoints: any;
+    /**
+     * 距离
+     */
+    distance: any;
+    /**
+     * 时间
+     */
+    duration: any;
+    /**
+     * 路线
+     */
+    steps: any;
+    /**
+     * 绘制路线坐标
+     */
+    paths: any;
+    /**
+     * 绘制步行路线坐标
+     */
+    walkingPaths: any;
+    /**
+     * 路线类型
+     */
+    type: any;
+}

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

@@ -0,0 +1,111 @@
+/**
+ * 公交路线规划服务类
+ * 提供公交路线规划功能，支持百度地图和天地图两种数据源
+ * 继承自 {@link BaseRoute}，提供统一的路线规划接口
+ *
+ * 主要功能：
+ * - 根据起点和终点计算最优公交路线
+ * - 支持途经点设置
+ * - 自动渲染路线到地图上
+ * - 支持多种数据源切换
+ * - 显示公交站点和换乘信息
+ *
+ * @category Services
+ * @extends BaseRoute
+ * @example
+ * ```javascript
+ * // 创建公交路线规划实例
+ * const transitRoute = new TransitRoute({
+ *     apiSource: mapvthree.Services.API_SOURCE_BAIDU, // 使用百度地图数据源
+ *     renderOptions: {
+ *         engine: engine, // 渲染引擎
+ *         autoViewport: true // 自动调整视野
+ *     }
+ * });
+ *
+ * // 搜索公交路线
+ * const result = await transitRoute.search(
+ *     new THREE.Vector3(116.404, 39.915, 0), // 起点坐标
+ *     new THREE.Vector3(116.414, 39.925, 0), // 终点坐标
+ * );
+ * ```
+ */
+export class TransitRoute 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 transitRoute = new TransitRoute({
+     *     apiSource: mapvthree.Services.API_SOURCE_BAIDU,
+     *     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 {TransitRoute_Bd|TransitRoute_Tdt}
+     * @private
+     */
+    private _dw;
+    /**
+     * 渲染引擎实例
+     * @type {Engine}
+     * @private
+     */
+    private _engine;
+    /**
+     * 创建具体的公交路线规划实现实例
+     * 根据API数据源类型创建对应的实现类
+     * @param {object} options 配置选项
+     * @returns {TransitRoute_Bd|TransitRoute_Tdt} 公交路线规划实现实例
+     * @private
+     */
+    private _createInstance;
+}
+import { BaseRoute } from './BaseRoute';

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

@@ -0,0 +1,33 @@
+export class TransitRoute_Bd {
+    static LINE_TYPE_MAPPING: number[];
+    static LINE_TYPE_MAPPING_CROSS_CITY: number[];
+    constructor(options?: {});
+    options: {};
+    _baiduMercatorProjection: any;
+    search(start: any, end: any, opts: any): Promise<RouteResult | undefined>;
+    _processRawInCity(json: any, ud: any): RouteResult;
+    _processRawCrossCity(json: any, ud: any): RouteResult;
+    /**
+     * 本格式化起点和终点的请求串
+     * @param {Object|Array|Vector2|Vector3} dest 起点或终点对象
+     * @return {string} 格式化后的串
+     * @private
+     */
+    private _formatCoordYXString;
+    /**
+     * 判断是否为uid
+     * @param {string} uid uid
+     * @returns {boolean} 是否为uid
+     * @private
+     */
+    private _isUid;
+    /**
+     * 获取线路类型
+     * @param {number} type 线路类型
+     * @param {boolean} cross_city 是否跨城
+     * @returns {number} 线路类型
+     * @private
+     */
+    private _getLineType;
+}
+import { RouteResult } from './RouteResult';

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * 步行路线规划服务类
+ * 提供步行路线规划功能，计算最优步行路径
+ * 继承自 {@link BaseRoute}，提供统一的路线规划接口
+ *
+ * 主要功能：
+ * - 根据起点和终点计算最优步行路线
+ * - 支持途经点设置
+ * - 自动渲染路线到地图上
+ * - 仅支持百度地图API
+ *
+ * @category Services
+ * @extends BaseRoute
+ * @example
+ * ```javascript
+ * // 创建步行路线规划实例
+ * const walkingRoute = new WalkingRoute({
+ *     renderOptions: {
+ *         engine: engine, // 渲染引擎
+ *         autoViewport: true // 自动调整视野
+ *     }
+ * });
+ *
+ * // 搜索步行路线
+ * const result = await walkingRoute.search(
+ *     new THREE.Vector3(116.404, 39.915, 0), // 起点坐标
+ *     new THREE.Vector3(116.414, 39.925, 0), // 终点坐标
+ * );
+ * ```
+ */
+export class WalkingRoute extends BaseRoute {
+    /**
+     * 查询类型：步行路线规划
+     * @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;
+    /**
+     * 具体的路线规划实现实例
+     * @type {DWRoute_Bd}
+     * @private
+     */
+    private _dw;
+    /**
+     * 渲染引擎实例
+     * @type {Engine}
+     * @private
+     */
+    private _engine;
+}
+import { BaseRoute } from './BaseRoute';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baidumap/mapv-three",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A powerful 3D map engine.",
   "author": "mapopen-fe@baidu.com",
   "main": "dist/mapvthree.umd.js",