# 通过地图应用实现导航等能力 ## 场景介绍 从5.0.3(15)开始，支持地图应用首页、搜索地点、查看地点详情、规划路线和进行导航功能；从6.0.1(21)开始，支持地图应用发起打车功能；从6.1.1(24)开始，打开地图应用查看地点详情支持终点描述，支持拉起地图应用离线地图管理页面。 本章节将向您介绍如何打开地图应用实现如下能力： * 打开地图应用首页 * 打开地图应用搜索地点 * 打开地图应用查看地点详情 * 打开地图应用规划路线 * 打开地图应用进行导航 * 打开地图应用发起打车 * 打开地图应用离线地图管理页面 ## 接口说明 调用地图应用的功能主要通过[petalMaps](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps)命名空间下的[openMapHomePage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaphomepage)、[openMapTextSearch](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptextsearch)、[openMapPoiDetail](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmappoidetail)、[openMapRoutePlan](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaprouteplan)、[openMapNavi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapnavi)、[openMapTaxi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptaxi)、[openMapOfflineDataManagement](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapofflinedatamanagement)等接口实现，更多接口及使用方法请参见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps)。 |接口说明|描述| |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------| |[TextSearchParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#textsearchparams)|文本搜索的参数。| |[PoiDetailParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#poidetailparams)|POI详情的参数。| |[RoutePlanParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#routeplanparams)|路线规划的参数。| |[NaviParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#naviparams)|导航的参数。| |[TaxiParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#taxiparams)|打车的参数。| |[OfflineDataParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#offlinedataparams)|离线地图管理参数。| |[openMapHomePage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaphomepage)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context)): Promise|打开地图应用首页。| |[openMapTextSearch](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptextsearch)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), textSearchParams: [TextSearchParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#textsearchparams)): Promise|打开地图应用搜索地点。| |[openMapPoiDetail](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmappoidetail)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), poiDetailParams: [PoiDetailParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#poidetailparams)): Promise|打开地图应用查看地点详情。| |[openMapRoutePlan](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaprouteplan)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), routePlanParams: [RoutePlanParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#routeplanparams)): Promise|打开地图应用规划路线。| |[openMapNavi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapnavi)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), naviParams: [NaviParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#naviparams)): Promise|打开地图应用进行导航。| |[openMapTaxi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptaxi)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), taxiParams: [TaxiParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#taxiparams)): Promise|打开地图应用打车页面。| |[openMapOfflineDataManagement](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapofflinedatamanagement)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), offlineDataParams: [OfflineDataParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#offlinedataparams)): Promise|打开地图应用的离线地图管理页面。| ## 地图应用使用的坐标类型 在国内站点，中国大陆使用GCJ02坐标系，中国台湾使用WGS84坐标系。 在海外站点，统一使用WGS84坐标系。坐标系转换参考：[坐标纠偏](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-convert-coordinate)。 ## 开发步骤 导入相关模块 ```TypeScript import { petalMaps } from '@kit.MapKit'; import { mapCommon } from '@kit.MapKit'; ``` ### 打开地图应用首页 通过[openMapHomePage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaphomepage)，打开地图应用首页。 ```typescript try { await petalMaps.openMapHomePage(this.getUIContext().getHostContext()); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图1** 打开地图应用首页 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/04/v3/WpLru4BuR4SSVfBc_pPmug/zh-cn_image_0000002779851504.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=90014E997ABA414F64EFAF035D3F2117F1E6C54F1BADD91C9F87C83A0DDBAFF3 "点击放大") ### 打开地图应用进行地点搜索 通过[openMapTextSearch](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptextsearch)，传入搜索目标名称，打开地图应用进行地点搜索。 ```typescript try { let params: petalMaps.TextSearchParams = { destinationName: '云谷' }; await petalMaps.openMapTextSearch(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图2** 打开地图应用进行地点搜索 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/U05g6ohSRjqUSKCWnVD9KA/zh-cn_image_0000002779691536.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=F2781FD9E40A8477B851AFA8182C3C31A06C881B0B7F78A67C6BEAC3969A767D "点击放大") ### 打开地图应用查看地点详情 通过[openMapPoiDetail](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmappoidetail)，传入地点的经纬度，打开地图应用查看地点详情。 ```typescript try { let params: petalMaps.PoiDetailParams = { destinationPosition: { latitude: 31.968789, longitude: 118.798537 }, destinationName: '标记点', zoom: 17, coordinateType: mapCommon.CoordinateType.GCJ02, destinationAddress: '这是我选择的演示名称' }; await petalMaps.openMapPoiDetail(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图3** 打开地图应用查看地点详情 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/gZTNCUEcTHeE79MabdO_3Q/zh-cn_image_0000002809011157.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=DFC9A9BEFF5D698EECDDB04514ED8A5F5C521ED8C26242BBBAE8F860CFFFC02C "点击放大") ### 打开地图应用规划路线 通过[openMapRoutePlan](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaprouteplan)，传入终点经纬度，打开地图应用规划路线。 ```typescript try { let params: petalMaps.RoutePlanParams = { destinationPosition: { latitude: 31.983015468224288, longitude: 118.78058590757131 } }; await petalMaps.openMapRoutePlan(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图4** 打开地图应用规划路线 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fc/v3/5k6fYVsjSJOXbdLhdDITxQ/zh-cn_image_0000002809051071.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=E742B65D053C7E889A02A901CC6C78DEFF4CE7214AD1D8151A92345995CF552F "点击放大") ### 打开地图应用进行导航 通过[openMapNavi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapnavi)，传入终点经纬度，打开地图应用发起导航。 ```typescript try { let params: petalMaps.NaviParams = { destinationPosition: { latitude: 31.983015468224288, longitude: 118.78058590757131 } }; await petalMaps.openMapNavi(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图5** 打开地图应用进行导航 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e8/v3/WCyGR5XKQg6YFlBE5MOcGQ/zh-cn_image_0000002779851506.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=00C3D14134BF376C2301CD59D5EDCDFD7216AD6E26D94679CDCC1B3BFCF9F4C8 "点击放大") ### 打开地图应用打车页面 通过[openMapTaxi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmaptaxi)，传入终点经纬度，打开地图应用发起打车。 ```typescript try { let params: petalMaps.TaxiParams = { destinationPosition: { latitude: 31.983015468224288, longitude: 118.78058590757131 } }; await petalMaps.openMapTaxi(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图6** 打开地图应用进行打车 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e0/v3/NO7Diq-tRdGDF_xJ_8y1yQ/zh-cn_image_0000002779691538.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=DCF0593962A2BBE00B60639FFE3167A00A904B4A4E331D3FED73F0D8C411306A "点击放大") ### 打开地图应用离线地图管理页面 通过[openMapOfflineDataManagement](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-petal-maps#openmapofflinedatamanagement)，传入离线地图管理参数，打开地图应用离线地图管理页面。 ```typescript try { // 打开地图应用手表离线地图管理页面 let params: petalMaps.OfflineDataParams = { scenarios: 'WATCH', // 推荐下载离线地图的地区集合 recommendedRegionIds: ['1026355368865976081'] }; await petalMaps.openMapOfflineDataManagement(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } try { // 打开地图应用地图资源（手机离线地图）管理页面 let params: petalMaps.OfflineDataParams = { scenarios: 'PHONE', // 推荐下载离线地图的地区集合 recommendedRegionIds: ['1026355368865976081'] }; await petalMaps.openMapOfflineDataManagement(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } try { // 打开地图应用导航语音管理页面 let params: petalMaps.OfflineDataParams = { scenarios: 'VOICE' }; await petalMaps.openMapOfflineDataManagement(this.getUIContext().getHostContext(), params); } catch (e) { console.error(`code:${e.code}, message:${e.message}`); } ``` **图7** 打开地图应用手表离线地图管理页面 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/13/v3/zBzKPcwMTieux1slHIhdJg/zh-cn_image_0000002809011159.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=FAB82B8EE6BAE75AEF9F50E436F821F13AC4293BC097C7791D18290C129B962D "点击放大") **图8** 打开地图应用地图资源（手机离线地图）管理页面 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/56/v3/ydRTdp1WS56JHVRGQpgv1A/zh-cn_image_0000002809051073.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=08D9031C0A3F4A68E16B16430AA41276D1F31D1FC719C46D7A9AA6E338A374AE "点击放大") **图9** 打开地图应用导航语音管理页面 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e4/v3/NQ0P_11CRuuA0_7WwVs9Mg/zh-cn_image_0000002779851508.jpg?HW-CC-KV=V1&HW-CC-Date=20261102T125428Z&HW-CC-Expire=31536000000&HW-CC-Sign=66D8FFB27B8F5ADD59FF8518FB6979CCAEFE05A8FACCF5FB0BB388369D245381 "点击放大")