打开手机叫车,盯着屏幕上那个小车图标一点点挪向你的位置;刷短视频看到探店博主标记了一家藏在巷子里的面馆;打开外卖软件看骑手距离你还有几百米——这些场景背后都藏着一个不起眼但极其重要的技术活:地图标注。很多人觉得地图标注是前端工程师的专属技能,其实只要你会一点JavaScript,完全可以自己动手实现。今天就从零开始,聊聊地图标注代码到底怎么写。

先说清楚地图标注的本质是什么。你在地图上看到的每一个图标、文字标签、弹窗信息,底层都是一段代码在操控。以最常用的高德地图JS API为例,一个标注的核心对象叫Marker。创建它只需要两行代码:先new一个AMap.Marker实例,传入经纬度和图标地址,再用map.add()把它挂到地图上。就这么简单——不需要什么复杂的配置,也不用理解底层渲染逻辑。很多人卡在第一步是因为被官方文档吓到了,其实文档里80%的参数你暂时都用不上,先把最基本的点位标出来再说。
动手之前有个准备工作绕不开:申请API Key。不管用高德、百度还是腾讯地图,你都得先去开发者平台注册账号、创建应用、拿到一串密钥。这个过程大概花五分钟,不要嫌麻烦。拿到Key之后,在HTML页面里引入对应的JS文件,然后在初始化地图时把Key填进去。这里有个新手常踩的坑:Key有域名白名单限制,本地开发时记得把localhost加进去,不然地图加载出来是空白,你会以为是代码写错了。
基础标注跑通之后,接下来要解决的是“多个点怎么批量标”的问题。实际项目里你不可能手动一个个写经纬度,数据通常来自后端接口返回的JSON数组。做法很简单:拿到数组后forEach遍历,用每一项的lng和lat创建Marker,同时把名称、地址等业务信息存到Marker的扩展属性里。这样几十上百个点几秒钟就能全部渲染到地图上。如果你标注的点特别多,比如上千个,建议了解一下海量点标记(MassMarks)或者聚合标注(MarkerClusterer),性能差距非常明显——普通Marker超过五百个就会开始卡。
标注加上去了,用户总得能点击看详情吧。给Marker绑定点击事件用marker.on(‘click’, fn),在回调函数里弹出一个信息窗体(InfoWindow)。信息窗体的内容支持HTML字符串,你可以放文字、图片甚至按钮。这里有个细节值得注意:多个标注共用同一个InfoWindow实例时,每次点击要先调用infoWindow.setContent()更新内容再open,不要每次都new一个新的,否则内存里会堆积一堆用不上的窗体对象。另外,移动端上信息窗体的宽度最好控制在屏幕宽度的70%以内,不然会溢出。
再往深走一步,说说自定义标注图标。默认的红色水滴图标满大街都是,你的项目大概率需要换成品牌色的图标或者带编号的圆形标记。做法是在new AMap.Marker时传icon参数,指定图片地址和尺寸。如果不想用图片,也可以用Content属性直接写HTML+CSS来画图标——比如一个带数字的圆形div,灵活度更高。有个实际经验:自定义图标一定要设置anchor(锚点),也就是图标哪个位置对准经纬度坐标。默认是底部中心,但如果你画的是圆形标记,通常要把锚点设为中心点,不然标注位置会偏。
聊一个容易被忽略但很实用的功能:标注拖拽。设置draggable: true之后,用户可以手动拖动标注到任意位置,松开鼠标时触发dragend事件,你在回调里拿到新的经纬度。这个功能在“用户手动修正地址”或者“商户自己标注店铺位置”的场景里特别好用。配合逆地理编码接口,拖拽结束后还能自动解析出详细地址文字,体验直接拉满。代码量不大,但产品经理看到这个交互通常会眼睛一亮。
回到标题说的“手把手”——地图标注代码真没什么高深门槛。核心流程就是:拿Key、初始化地图、创建Marker、绑事件、调样式。你把上面这几步跑一遍,半小时就能做出一个带交互标注的demo。剩下的无非是根据业务需求往上叠功能:聚合、拖拽、自定义窗体、路径绘制。别被官方文档的厚度劝退,打开编辑器动手写第一行new AMap.Marker的时候,这事就已经成了一半。
