一张世界地图上,278,975个Telegram频道被钉在150个国家里,其中152座城市画出了道路、水域和行政区边界。从整个星球一路缩到某条街道,只需要一次连续操作。

这张地图底下没有地图库。频道是小型WebGL引擎里的点,点下面的一切——陆地、边界、城市——全部由Canvas 2D绘制。有意思的问题都出在第二部分。

世界轮廓本身就很重

国界轮廓来自Natural Earth的1:10m数据。做过拓扑简化之后,共享边界只简化一次,一个国家的填充和它的边界线逐点吻合,文件依然不小。

能上线靠两件事。坐标以整数存储,步长为1e-6地图单位,每个点只存与前一个点的差值,解码就是一路累加。小数字压缩效果好:原始文件约2.9 MB,gzip后1.15 MB。

另一件是细节层级。Worker里保留六份不同简化容差的轮廓副本,按当前缩放比例挑一份。世界级缩放下画的是点数很少的那份,一帧耗时2到4毫秒。俄罗斯、加拿大这类超大环,落在视口外的点会在进入lineTo之前就被折叠掉。

绘制不能卡住平移

整套逻辑跑在Web Worker的OffscreenCanvas里,主线程只负责搬运位图。但Worker的帧天生会迟到,缩放过程中就会看到空白边缘或者被拉伸的模糊画面。

解法是在点下面叠三层:一层清晰帧,覆盖屏幕加一圈边距,全分辨率;一层宽帧,覆盖视口周围约五个屏幕,三分之一分辨率;再加一张只画一次的世界总览。缩小时清晰帧收缩,宽帧从底下露出来,画面会软一下,但那是正确的图,不是把总览放大一百倍。缩小时Worker还会提前请求下一张清晰帧,范围比当前视口更大。

拿不到OffscreenCanvas的浏览器(iOS 16.4之前)走降级路径:主线程画简化轮廓,不画城市。

城市是独立的数据包

每座城市单独打包:轮廓、行政区、水域和道路来自OpenStreetMap,镜头靠近时才加载,在那之前城市只是一个点。

两个细节比预想中重要。城市淡入,当它在屏幕上很小时道路再淡出——不做这一步,挤进100像素的路网会糊成一团白斑。道路、水域和区界都被裁剪到城市轮廓内,不会伸进相邻区域。

拥有海域的城市

最丑的bug出在这里。OpenStreetMap里沿海城市的行政边界常常包含其水域,胡志明市就拥有一大片南海海域。渲染器会擦掉城市底下的陆地再填上城市色,结果一个和城市本身一样大的多边形被画到了开阔海面上。

152座城市里有23座存在这个问题,包括纽约、洛杉矶、东京、新加坡、香港、巴库等。

构建步骤现在把两样东西光栅化到同一张640像素网格上:城市轮廓,以及所有国家的陆地。不涉及几何库,只有用numpy写的扫描线填充(奇偶规则),加上scipy.ndimage算距离和连通部分。如果轮廓中超过3%、且超过20平方公里不在陆地上,这个数据包就带上sea标记。城市的包围盒、中心和镜头取景框随后只按陆地部分计算。

渲染器里这个标记切换一个分支:带sea时用source-atop合成,城市画的一切只落在已经不透明的像素上,而那一刻不透明的像素只有陆地。河流、道路、区界照常工作,海还是海,世界海岸线穿过城市时不会断。

纽约就是对照:曼哈顿两侧的河,是世界的海从城市中间透出来。

慢设备和Safari

还有两件各花掉一天的小事。自适应画质:视图移动时测量帧耗时中位数,如果差于22、36或50毫秒,画质档位下调——背景、地图帧和点引擎的分辨率一起降。一次会话内不会升回去,因为来回切换比一直低画质更难看。

地址栏:URL跟随镜头,任何视图都能分享。Safari在30秒内调用超过100次history.replaceState后会抛SecurityError。地图在移动时每400毫秒写一次URL,留有余量。

回头看值得再做的选择:把几何留在Worker里,把主线程当合成器;用光栅而不是多边形裁剪来判断"这个多边形在不在陆地上",640像素网格对一座城市足够精确,代码只有三十行;给数据目录加版本号,浏览器会永久缓存这些文件,重建就换一个新路径。