打开手机点外卖,你能实时看到骑手在地图上移动的小图标。用打车软件,车辆位置每几秒刷新一次。这些功能背后都离不开同一个技术活:地图标注代码。说白了,就是把一个坐标点变成地图上看得见的标记,再加点交互,让它能点、能动、能弹信息。今天就从最基础的写起,一步步把手感练出来。

先搞清楚地图标注到底在标什么。地球表面任何一个位置,都可以用经纬度表示。纬度是南北方向,赤道为0度,往北到90度,往南到负90度。经度是东西方向,本初子午线为0度,往东到180度,往西到负180度。比如北京天安门广场,大概在北纬39.9度、东经116.4度。你写代码时给地图一个这样的坐标对,它就能把标记钉在正确的位置上。所有地图API的标注逻辑,起点都是这组数字。
选一个地图平台是动手的第一步。国内常用高德、百度、腾讯,国外有Google Maps和Leaflet加OpenStreetMap的组合。高德和百度对国内地址解析更准,文档也是中文的,新手友好。Leaflet是开源库,代码轻量,适合练手。不管你选哪个,注册开发者账号、申请API Key这个环节跑不掉。Key相当于你的身份证,地图服务器靠它识别请求来源。申请时注意勾选Web端JavaScript API,别选错服务类型。
拿到Key之后,写一个最小可运行的标注页面。HTML骨架里引入地图JS文件,然后在script标签里初始化地图对象。以Leaflet为例,三行代码就能出效果:创建map实例绑定到div容器,设置中心点和缩放级别,再加一个tileLayer加载瓦片图。这时候地图已经能看了,但还没有标记。加标记用L.marker方法,传入经纬度数组,再调addTo(map)把它挂上去。刷新浏览器,一个默认的蓝色水滴图标就出现在你指定的位置了。这是最原始的标注,没有任何交互,但已经跑通了核心链路。
光有一个图标不够,实际项目里每个标记都得带信息。点击图标弹出详情窗口,这是标配。Leaflet里用bindPopup方法,把HTML字符串塞进去,支持加粗、换行、甚至图片。高德地图用setContent方法设置信息窗内容。再进一步,你可以自定义图标样式,把默认蓝色水滴换成公司Logo或者任意PNG图片。用L.icon定义图标路径、尺寸、锚点位置,再传给marker的icon参数。锚点很关键,它决定图标的哪个点对准经纬度坐标。默认是图标底部中心,如果你设错了,标记会偏移到离谱的位置。
多个标记的场景会复杂一些。比如你做一个门店分布图,全国200家店,每个都要标出来。手动写200个marker对象不现实,得用循环遍历数据数组。数据通常从后端API拉取,格式是JSON,每个对象包含名称、经纬度、电话等字段。遍历时动态创建marker,绑定对应的弹窗内容。这里有个性能坑:标记超过500个时,地图拖动会卡顿。解决办法是用聚合插件,比如Leaflet.markercluster,它把相邻的标记合并成一个数字圆圈,放大后才散开。用户体验和渲染性能都能兼顾。
标注的交互还能做得更细。拖动标记更新坐标,这个功能在地址纠错场景很实用。监听marker的dragend事件,在回调里读取新的经纬度,同步更新到表单或数据库。再比如鼠标悬停标记时高亮显示,移开恢复原样,用mouseover和mouseout事件控制CSS类名切换。如果做物流追踪,标记需要按轨迹移动,那就不能用静态marker了,得用polyline画路径,配合定时器不断更新marker的setLatLng。这些技巧组合起来,就能覆盖大部分业务需求。
说一个容易忽略的点:坐标系转换。国内地图服务商用的坐标系不一样,高德和腾讯用GCJ-02,百度用BD-09,GPS设备输出的是WGS-84。你把GPS原始坐标直接标到百度地图上,会偏移几百米。转换公式网上有现成的开源函数,搜“WGS84转GCJ02”就能找到。调一下参数,标记就准了。这个坑不踩一次很难记住,但踩过一次就永远不会忘。
回到标题说的入门到实战,路径其实很清晰:理解经纬度、选平台拿Key、写最小标注、加弹窗和自定义图标、批量处理加聚合、搞定坐标转换。每一步都有现成的文档和社区答案,难的不是写代码,而是动手把第一个标记钉到地图上。钉上去了,后面的都是顺水推舟。
