做电子地图开发的人，十有八九都绕不开标注这件事。我见过不少人，地图SDK集成了，底图加载了，结果卡在标注上——不是位置偏了，就是样式丑得没法看，再要么一缩放就全乱了。这篇文章不跟你讲虚的，直接讲清楚标注开发里的门道，从最基础的经纬度换算，到性能优化和交互细节，一条线捋到底。
先说最容易被忽视的地基问题：坐标系。国内地图用的GCJ-02（火星坐标），跟GPS原始坐标WGS-84之间差了几百米。你要是直接把GPS坐标丢进去标点，点会漂到隔壁街去。标注开发的第一步，不是写代码，是搞清楚你手里的数据是什么坐标系。高德、腾讯用GCJ-02，百度用BD-09，国际版Google Map用WGS-84。好在各家SDK都提供了坐标转换工具类，但注意，转换函数有精度损耗，尤其是在城市峡谷地带，误差能到十几米。所以，能存GCJ-02就存GCJ-02，别在数据库里存WGS-84再每次实时转。
接着讲标注的数据模型设计。很多人习惯用字符串存坐标，比如“116.397428,39.90923”，这是大坑。你要做的是把经纬度拆成两个double字段，再加一个type字段标记POI类型，比如餐饮、地铁站、加油站。为什么？因为标注渲染时，根据type决定图标和点击行为。再一个，加一个priority字段，控制缩放级别不同时哪些标注优先显示。你不想在1公里视野内同时看到500个奶茶店图标吧？数据模型里没priority，前端就得做额外过滤，性能直接打折。
说到性能，标注点多了以后，地图卡顿是必然的。我见过一个项目，2万个标注点，用户一拖地图，帧率掉到个位数。解决办法主要靠聚合。聚合分两类：网格聚合和距离聚合。网格聚合简单粗暴，把屏幕划分成固定像素的格子，每个格子内的点合并成一个，显示数量；距离聚合更智能，基于四叉树或者GeoHash把相近的点聚成簇，缩放级别变化时自动拆散。高德和百度SDK都内置了聚合功能，但默认参数往往不适合你的业务场景。你要调的核心参数是聚合半径和最小聚合数量。比如景区App，半径设80像素，数量超过3个才聚，效果就比较舒服。
聚合做完了，还有一层优化叫分级加载。说白了，就是标注点不要一次性全丢给地图。按缩放级别划分数据级别：城市级别只看大商圈和交通枢纽，区县级别看主要道路和小区，街道级别才展示全部POI。实现方式有两种，一是后端接口带zoom参数，按级别返回不同粒度数据；二是前端预置多份数据，按zoom切换。前者更灵活，但要求后端配合；后者适合数据量稳定的场景。我推荐前者，因为用户缩放操作是动态的，你永远猜不到他下一秒想看什么。
标注的视觉设计，这关过了才算入门。图标不要直接丢个PNG上去就完事，要考虑密度适配和清晰度。iOS和Android的屏幕密度不一样，你要切三套图：@1x、@2x、@3x。还有，图标底部有一个锚点，对应地图上的真实坐标点。默认锚点在图片中心，但如果你用的是图钉型图标，中心点其实是图钉的尖端，不调整锚点，标注就会偏上几个像素。小尺寸下看不出来，一旦放大看细节，就露馅了。另外，文字标签要跟图标分离设计，图标变化时文字不重绘，省性能。
交互层面，标注点击后的弹窗（InfoWindow）是重头戏。很多人直接套SDK默认的弹窗，丑且不说，还容易遮挡地图信息。自定义弹窗要记住，弹窗的布局必须轻量，不要塞大图和高清视频。地图在拖动时，弹窗会跟着标注走，如果弹窗里有复杂的布局，掉帧是必然的。更好的做法是，点击标注时，弹窗只显示标题和副标题，详情页单独跳转。还有一个细节：弹窗出现时要有动画，但动画时间控制在150毫秒以内，太长了用户会烦躁。
再聊一个进阶玩法：动态标注。比如外卖配送员的实时位置、共享单车的实时分布。这种标注不能走普通的addMarker流程，因为位置在不停变化，每次更新都要刷新，性能开销很大。正确的做法是用自定义覆盖物（Overlay），自己管理绘制逻辑，或者使用SDK提供的平滑移动接口。核心思路是，位置更新时，不要销毁重建标注，而是调用setPosition方法，让SDK内部做插值动画。另外，动态标注的更新频率要控制在每秒1-2次，太频繁了，用户眼睛也跟不上，反而觉得卡。
踩坑记录给你提个醒。第一，标注点击事件的回调里，不要做耗时操作，比如网络请求，要异步处理，否则会阻塞UI线程。第二，地图的onCameraChange和onCameraIdle事件触发频繁，不要在回调里做数据加载，要用防抖或者标记位控制。第三，Android上要注意内存泄漏，标注对象持有Activity引用的话，页面销毁时地图没释放，就会崩。我见过太多应用在退出地图页时崩溃，十有八九是标注回调里还引着旧的Context。第四，iOS上要注意Annotation的复用机制，跟UITableView的Cell复用一个道理，不重用的话，内存涨得飞快。
写到这，标注开发的门道基本都过了一遍。从坐标系的坑，到数据模型设计，再到聚合和分级加载，然后是视觉和交互细节，是动态标注和避坑指南。这套流程走下来，你至少能做出一个不卡顿、不漂移、点击响应快的标注系统。但话说回来，地图标注这东西，纸上谈兵没意义，你得真去写代码，真去拿几千个点压一压，才知道哪里会炸。建议你打开IDE，先拿一个简单的Demo，把聚合和锚点这两个点调明白，再谈其他的。
