很多人第一次做小程序地图标注,打开官方文档看了半小时,关掉页面脑子里只剩一堆英文单词。map组件、markers、latitude、longitude,每个字都认识,拼在一起就不知道从哪下手。其实这件事拆开来看就三步:拿到坐标、写进代码、调好样式。今天从零开始,把每一步拆到你能直接照着敲的程度。

先解决坐标从哪来的问题。小程序里标注位置需要两个值:纬度和经度。最笨也最稳的办法是打开腾讯地图或高德地图的网页版,找到你要标注的那个点,右键点击,菜单里一般有“这里是什么”或“获取坐标”的选项,点一下就能看到一串数字,前面是纬度后面是经度。比如天安门广场大概是39.9087, 116.3975。记下来,别搞反了,纬度在前经度在后,写反了你的标注就跑到南半球去了。如果你要批量标注多个位置,可以在地图开放平台上注册一个开发者账号,用坐标拾取工具一个个点,效率更高。
坐标到手之后,打开小程序的wxml文件,加一个map组件。最基本的写法就一行:
。这行代码跑起来,你看到的就是一张以天安门为中心的地图,但上面什么标记都没有。接下来要加markers属性,它是一个数组,每个元素代表一个标注点。写法是这样的:markers=”{{markers}}”,然后在js文件的data里定义markers数组。每个marker至少要有id、latitude、longitude这三个字段,id是唯一标识,不能重复。比如data里写markers: [{id: 1, latitude: 39.9087, longitude: 116.3975, width: 30, height: 30}],这样地图上就会出现一个默认的红色大头针图标。
很多人卡在这一步:代码写了,地图上也出现标记了,但点一下没有任何反应。这是因为你没绑定点击事件。map组件上要加bindmarkertap=”onMarkerTap”,然后在js里写一个同名函数。这个函数收到的参数里有一个detail,detail里有个markerId,通过这个id你就能知道用户点的是哪个标注。比如你可以在函数里判断:如果markerId等于1,就弹一个提示框显示“你点击了天安门”。这个交互看起来简单,但它是地图类小程序最核心的体验——用户点一个点,你得给出反馈,否则他不知道自己点中了没有。
默认的大头针图标太小,颜色也不一定符合你的品牌风格。改图标很简单,在markers数组的每个元素里加iconPath字段,值是图片路径,支持本地图片也支持网络图片。本地图片放在项目目录里,写相对路径比如“/images/pin.png”;网络图片直接写完整url。尺寸用width和height控制,单位是px。这里有个细节要注意:图标尺寸别设太大,30到40px比较合适,太大了会挡住地图上的街道名称。另外建议用带透明背景的png图片,圆形的或者水滴形的标注看起来更自然。如果你需要标注多个不同类型的点,比如连锁店用红色、仓库用蓝色,就在iconPath里分别指向不同的图片。
标注点多了之后,地图会显得很乱。这时候可以用callout或者label给每个标注加文字说明。callout是点击后弹出的气泡,label是一直显示在图标旁边的文字。label的写法是在marker里加label: {content: “北京天安门”, color: “333”, fontSize: 12, borderRadius: 4, padding: 4, bgColor: “fff”, anchorX: 0, anchorY: -40}。anchorX和anchorY控制文字相对于图标的位置,anchorY设成负数就是往上偏移,避免文字压在图标上。callout更适合信息量大的场景,比如显示店铺名称加营业时间,用户点一下才展开,不点的时候地图保持干净。两种方式可以同时用,label做简短标识,callout做详细信息。
还有一个经常被忽略的点:地图的缩放级别。scale属性控制地图的初始缩放,取值范围一般是3到20,数字越大看得越近。如果你只标注一个位置,scale设成16左右比较合适,能看到周边的街道。如果标注的是多个分散的点,scale要调小到10到12,让所有点都在视野范围内。另外center属性可以单独指定地图的中心点,不写的话默认以第一个marker为中心。建议把center设成所有标注点的地理中心,这样用户一打开地图就能看到全貌,不用自己拖来拖去。
做到这里,一个能看、能点、能标注的小程序地图已经跑起来了。回头看一眼整个过程:拿坐标、写markers数组、绑点击事件、换图标、加文字、调缩放。每一步都不复杂,关键是别被文档里的术语吓住。地图标注这件事,代码量不大,真正花时间的是想清楚你要标什么、用户点了之后要看到什么。把这两个问题想明白,剩下的就是对着上面这几段代码改改参数的事。
