鸿蒙 地图开发：出行路线规划

开发中，路线规划是导航类应用的核心功能。Map Kit提供了两点之间驾车、步行、骑行和公共交通的路径规划能力。

功能包含：

• 四种路线规划方式：驾车、步行、骑行、公共交通

• 驾车规划的特殊功能：途经点、多条路线、未来出行、实时路况

一、路线规划

Map Kit提供以下路线规划能力：

二、核心接口

参数类型：

返回结果类型：

三、开发步骤

3.1 导入模块

import { navi } from '@kit.MapKit'; import { BusinessError } from '@kit.BasicServicesKit';

四、驾车路径规划

驾车路径规划支持以下功能：

async testDrivingRoutes() { let params: navi.DrivingRouteParams = { // 起点的经纬度（支持多个起点） origins: [{ latitude: 31.982129213545843, longitude: 120.27745557768591 }], // 终点的经纬度 destination: { latitude: 31.986129213545843, longitude: 120.32745557768591 }, // 路径的途经点（最多5个） waypoints: [ { latitude: 31.967236140819114, longitude: 120.27142088866847 }, { latitude: 31.972868002238872, longitude: 120.2943211817165 }, { latitude: 31.98469327973332, longitude: 120.29101107384068 } ], language: 'zh_CN' }; try { const result = await navi.getDrivingRoutes(params); console.info(`Succeeded in getting driving routes. result is ${JSON.stringify(result)}`); } catch (error) { const err: BusinessError = error as BusinessError; console.error(`Failed in getting driving routes. Code is ${err.code}, message is ${err.message}`); } }

五、步行路径规划

步行路径规划支持以下功能：

async testWalkingRoutes() { let params: navi.RouteParams = { // 起点的经纬度（支持多个起点） origins: [ { latitude: 39.992281, longitude: 116.31088 }, { latitude: 39.996, longitude: 116.311 } ], // 终点的经纬度 destination: { latitude: 39.94, longitude: 116.311 }, language: 'zh_CN' }; try { const result = await navi.getWalkingRoutes(params); console.info(`Succeeded in getting walking routes. result is ${JSON.stringify(result)}`); } catch (error) { const err: BusinessError = error as BusinessError; console.error(`Failed in getting walking routes. Code is ${err.code}, message is ${err.message}`); } }

六、骑行路径规划

骑行路径规划支持以下功能：

async testCyclingRoutes() { let params: navi.RouteParams = { // 起点的经纬度 origins: [{ latitude: 31.9844102, longitude: 118.7662537 }], // 终点的经纬度 destination: { latitude: 31.9874102, longitude: 118.7362537 }, language: 'zh_CN' }; try { const result = await navi.getCyclingRoutes(params); console.info(`Succeeded in getting cycling routes. result is ${JSON.stringify(result)}`); } catch (error) { const err: BusinessError = error as BusinessError; console.error(`Failed in getting cycling routes. Code is ${err.code}, message is ${err.message}`); } }

七、公共交通规划

公共交通规划根据起点终点坐标，返回两地之间的多种公共交通中转路线（公交、地铁等）。

async testGetTransitRoutes() { let params: navi.TransitRouteParams = { // 起点经纬度 origin: { latitude: 39.921619, longitude: 116.356587 }, // 终点经纬度 destination: { latitude: 39.94161, longitude: 116.353621 }, // 设置出发时间为当前时间（单位秒） departureTime: new Date().getTime() / 1000 }; try { const result = await navi.getTransitRoutes(this.getUIContext().getHostContext(), params); console.info(`Succeeded in getting transit routes. result is ${JSON.stringify(result)}`); } catch (error) { const err: BusinessError = error as BusinessError; console.error(`Failed in getting transit routes. Code is ${err.code}, message is ${err.message}`); } }

八、参数类型

8.1 DrivingRouteParams（驾车）

8.2 RouteParams（步行/骑行）

8.3 TransitRouteParams（公共交通）

九、四种路线规划对比

驾车规划特有功能