拿到一份地图SDK，最先想干的事往往是往上头扔几个标记点。这事儿听着简单，做起来全是坑。坐标飘了、图标糊了、点击没反应、列表和地图对不上号——这些毛病我当年都踩过，而且踩得相当瓷实。今天这篇就把我折腾出来的那点经验摊开聊，从坐标系到性能优化，从基础标注到自定义气泡，全给你捋一遍，看完你能少走不少弯路。

先说坐标系这关。地图标注第一课，不是学API怎么调用，而是搞清楚你手里的坐标是哪个“地球”。国内常用的有GCJ-02（火星坐标）和BD-09（百度坐标），国际通用的是WGS-84。你要是拿着GPS设备录的WGS-84坐标，直接往高德地图上标，那位置能偏出去几百米，看着就像你把钉子钉在了邻居家房顶上。解决办法很直接——用SDK自带的坐标转换工具，或者干脆在服务端统一转好再下发。我见过不少新手栽在这上面，调了半天以为代码写错了，结果就是坐标没转。记住一个原则：数据入库用WGS-84，展示层转成对应平台坐标，转换这事儿必须做在前端展示之前。

接下来是标注组件的基础用法。拿高德地图JS API举例，创建一个Marker，设置position、content、offset，三步就能出个点。但这里有个容易被忽略的细节——锚点（anchor）。默认锚点在图标中心，可如果你的图标是个水滴形，尖端才是实际指向位置，那你就得手动调整offset或者设置anchor参数，不然标注的位置总感觉差了半个身位。还有z-index层级，多个标注重叠时谁盖谁，这玩意儿不设置，你就会看到后添加的标注莫名其妙被压在下头。别问我怎么知道的，调了一个下午才反应过来是层级问题。

图标和样式这块，很多需求方会丢给你一个设计稿，上面画着花里胡哨的标注样式。这时候别硬刚，也别直接往content里塞HTML。最优雅的做法是用div+css拼一个自定义content，或者干脆用canvas画个图标转成base64。这里有个性能警告：如果你要在地图上放几百上千个标注，千万别每个都搞成富DOM，浏览器会卡到你怀疑人生。正确姿势是改用海量标注（如高德的MassMarks），或者用聚合点（Cluster）把密集区域的点合并成一个数字气泡。聚合这东西还有个好处——用户缩放地图时，点会自动散开和合并，交互体验直接拉满。

说到交互，标注不能只是摆在那儿当静态装饰。点击弹出详情，这是标配。但弹窗（InfoWindow）怎么设计，里头放什么内容，这里头有讲究。我见过有人把整个商品页塞进弹窗里，结果手机上弹窗比屏幕还宽，用户划半天都看不完。弹窗内容要精简，图片、标题、一行描述、一个“查看详情”按钮，够了。最烦人的是弹窗和地图的联动——地图移动时弹窗跟着飘，地图缩放时弹窗跑偏，这些都得监听地图的move、zoom事件，实时更新弹窗位置。另外，点击地图空白处关闭弹窗，这个细节一定得加，不然用户点开一个弹窗，再想关掉只能点右上角叉号，体验太糟糕了。

再往深一层说，标注的展示逻辑往往是跟业务数据绑定的。最常见的需求是：根据某个字段（比如店铺营业状态）动态改变标注颜色。这时候别写死样式，把状态字段塞进标注的data属性里，然后在render的时候读出来判断。更复杂一点的，比如按区域筛选标注，或者根据用户当前位置显示范围内的点，这些逻辑建议都放在数据层处理，别在地图上反复增删标注。增删标注是有性能开销的，尤其是频繁操作时地图会闪烁、抖动，用户看着就烦。我自己的习惯是：维护一个标注数组，需要变更时先清空再重新添加，或者干脆用数据驱动的框架（如Vue/React）来管理标注列表，让视图跟着数据走。

还要说说多图层的问题。做了几年地图开发，我总结出一个经验：别把所有标注都堆在一个地图实例上。比如你有基础店铺标注、活动促销标注、用户自定义标注，这三类业务性质完全不同，建议分别放在不同的图层里。好处很明显——你可以单独控制某一类标注的显示/隐藏，比如用户切换视图模式时，只隐藏活动标注，不影响其他点。而且排查问题也方便，哪一层出bug了，直接看那一层的代码，不用在一堆标注里捞针。

聊一个很多人不在意但实际很重要的点——标注的加载体验。如果你的数据量大，比如几万条POI，一进页面就全量渲染，用户会看到地图卡顿甚至白屏。这时候得用分页加载或者按视野范围加载。监听地图的moveend事件，拿当前视野的boundary去请求接口，只渲染视野内的标注。再配合上聚合，体验直接起飞。还有一个优化点是图标资源——别用几MB的PNG当标注图标，压缩到几十KB的SVG或者WebP，加载速度能快一个量级。用户等不起，地图更等不起。

写到这里，核心的实战技巧基本都过了一遍。从坐标系转换到组件细节，从样式定制到性能优化，再到数据驱动的展示逻辑，这些坑我都替你趟过一遍，你照着绕开就行。地图标注开发这事儿，说到底是细节的活儿——坐标系没错、锚点调准、交互做顺、性能不卡，这四点全做到了，你的地图应用就已经跑赢市面上八成产品了。剩下的，就是在实战里慢慢积累手感，多踩几个坑，自然就熟了。