【HarmonyOS NEXT】地图使用详解(二)

2025-12-03 17:43之家网站 - -

踏入鸿蒙世界的敲门砖,标志着您在技术征途上的全新起点,提升就业竞争力,获得行业认可,点亮职业成长先机,快人一步抢占未来应用开发赛道!https://developer.huawei.com/consumer/cn/training/dev-cert-detail/101666948302721398?ha_source=hmosclass-itzhijia&ha_sourceId=89000249

背景

上篇文章对开发环境初始化进行了讲解,这篇文章是对地图 Picker 系列组件的讲解。包括地点选取模块和地点详情展示模块。

地点选取模块(sceneMap.chooseLocation

  • 参数

  • 返回值

Promise

地点选取初始化参数(LocationChoosingOptions)

location

  • 地图中心点坐标。如果参数未传,使用设备当前位置作为中心点;如果未获取到设备当前位置,默认以故宫博物院为中心点。

language

  • 地图组件显示的语言。仅支持中文和英文,zh_CN 和 en

poiTypes

  • 指定需要展示的 poi 类别。取值范围需要查看 HwLocationType

searchEnabled

  • 是否展示搜索控件,默认值为 false。true:展示;false:不展示

showNearbyPoi

  • 是否展示附近 poi,默认值为 false。true:展示;false:不展示

snapshotEnabled

  • 是否返回映射快照,默认值为 false。true:返回;false:不返回

地点选择返回值(LocationChoosingResult)

siteId

  • 选择的地点 ID,如果选测试非 Poi(即手动滑动到随便某个位置),则不返回

location

  • 选点的坐标点。返回 mapCommon.Latlng

name

  • 选点的 Poi 名称。非 Poi 时,返回 name 值为标记点

address

  • 选点的地址信息

addressComponent

  • 选点地址的详细信息。返回 site.AddressComponent 值,包括国家名字,行政区,地区等信息。

zoom

  • 选点地址的缩放层级。

snapshot

  • 地图快照。返回图片类型

代码

实现效果

地点详情展示模块(sceneMap.queryLocation

由官方提供的地点详情展示模块,可以实现快速调用页面,查看地点详情。

  • 参数

LocationQueryOptions(查询地点详情设置参数)

需要注意点,如果没有填写 siteid 参数时,需要同时填写 location 和 name 才能实现页面的定位

siteId

  • 地点详情页的地点 ID。

language

  • 语言。当前仅支持中文和英文,取值:zh_CN、en。

location

  • 地图中心点坐标。如果没有 siteId,使用 location 查询地点详情。

name

  • 地点的名称。如果没有 siteId,使用 name 作为 location 的名称标注。

address

  • 地点的地址。如果没有 siteId,使用 address 作为 location 的地址标注。

showBusiness

  • 是否显示商业信息(如打车),默认值为 true。

代码

实现效果

  • 当选择的地址是 Poi 时,ID 和 Name 都可以正常显示

  • 当选择地址不是 Poi 时,ID 是为 undefined 的,Name 可以正常显示

总结

这里展示了官方提供的两种地图组件的使用方式,希望可以让你对这两个组件的使用有更深的理解(转载自 CSDN,作者:baobao 熊)

广告声明:文内含有的对外跳转链接(包括不限于超链接、二维码、口令等形式),用于传递更多信息,节省甄选时间,结果仅供参考,IT之家所有文章均包含本声明。

文章价值:
人打分
有价值还可以无价值
置顶评论
    热门评论
      文章发布时间太久,仅显示热门评论
      全部评论
      一大波评论正在路上
        取消发送
        分享成功

        长按关注IT之家公众号
        阅读更多精彩文章

        查看更多原创好文
        软媒旗下人气应用

        如点击保存海报无效,请长按图片进行保存分享