OpenLayers 投影设置与坐标转换示例
OpenLayers 投影设置与坐标转换的核心是 ol/proj 模块。地图默认投影为 Web Mercator（EPSG:3857），经纬度坐标用 fromLonLat 或 transform 即可转到视图坐标；自定义投影则需配合 proj4 定义并 register 后再指定到 View。按此流程可完成绝大多数 openlayers投影转换场景。截至 2026 年 11 月，最新稳定版为 v10.11.0。
默认投影与内置支持有哪些
不显式设置时，OpenLayers 视图一律使用 EPSG:3857，便于直接叠加 OSM、Bing 等全球瓦片。内置可直接互相转换的投影包括：EPSG:4326（WGS 84 地理坐标）及其常见别名，以及南北半球 UTM 分区（EPSG:32601–32660 与 EPSG:32701–32760）。UTM 内置实现精度大约 0.1 米，生产中若要求更高精度，建议改用 proj4 重新注册。
| 投影代码 | 说明 | 典型用途 |
|---|---|---|
| EPSG:3857 | Web Mercator（球面墨卡托） | 默认视图、在线瓦片 |
| EPSG:4326 | WGS 84 经纬度 | GPS、GeoJSON 输入输出 |
| EPSG:326xx / 327xx | UTM 分区 | 区域大比例尺工程 |
坐标顺序固定为 [经度, 纬度]（即 [lon, lat]）。忘记这一点是导致位置跑偏的最常见原因。更多细节见 OpenLayers 官方 FAQ 投影说明。
坐标转换函数怎么用
解决“我有经纬度，怎么放到地图上”或“我要反过来导出经纬度”这类问题，按下面步骤操作即可。
- 通过 npm 安装：npm install ol（推荐模块化导入，配合 Vite、webpack 等打包）。
- 导入所需函数：import {fromLonLat, toLonLat, transform, get as getProjection} from ‘ol/proj.js’;
- 创建 View 时直接写 center: fromLonLat([116.397, 39.908])，或先用 transform([lon, lat], ‘EPSG:4326’, ‘EPSG:3857’) 得到米制坐标。
- 需要反向时调用 toLonLat(mapCoordinate) 或 transform(mapCoordinate, ‘EPSG:3857’, ‘EPSG:4326’)。
- 若整张地图都想用地理坐标操作，可在初始化前调用 useGeographic()，之后 API 参数即可直接传 [lon, lat]。
transform 在找不到可用变换时会抛错，生产代码建议先用 getProjection 确认投影已注册。完整函数列表见 ol/proj 模块最新 API 文档。
自定义投影如何注册
当业务需要国家 2000、地方独立坐标系或非内置 UTM 时，必须引入 proj4（版本要求 ≥ 2.8.0）。
- 安装：npm install proj4。
- 从 epsg.io 或 spatialreference.org 复制完整定义字符串，执行 proj4.defs(‘EPSG:xxxx’, ‘+proj=… …’)。
- 立刻调用 import {register} from ‘ol/proj/proj4.js’; register(proj4);。
- 用 getProjection(‘EPSG:xxxx’) 取出实例，强烈建议再调用 setExtent([…]) 写入有效范围，否则 zoom 0 分辨率与 TileGrid 计算会出错。
- 在 new View({projection: ‘EPSG:xxxx’, …}) 或图层 source 的 projection 选项中直接使用该代码即可。
也可异步用 fromProjectionCode 拉取定义，但仍需先 register。extent 未设置是自定义投影最常见的“看起来注册成功却显示空白”原因。
栅格重投影与显示异常排查
当瓦片或影像源投影与视图投影不一致时，OpenLayers 会在浏览器端自动做栅格重投影（基于三角形仿射）。可设置图层的 reprojectionErrorThreshold 控制误差阈值，并用 layer.setExtent 限制可见范围，避免重投影后出现“双份”影像。验收标准很简单：中心点落在预期位置、比例尺正确、无空白或拉伸花屏。
- 地图中心跑到几内亚湾（Null Island）：几乎一定是把经纬度当成了 3857 米制坐标。改用 fromLonLat 即可。
- 奥地利坐标显示到也门：坐标顺序写反成了 [lat, lon]。
- getProjection 返回 null 或 transform 抛错：忘记 register(proj4)，或 defs 语法写成了旧版 Proj4js.defs。
- 自定义投影下瓦片错位：未设置 extent，或 TileGrid 分辨率与投影单位不匹配。
常见问题
为什么我设置了 projection 但地图还是空白？
最常见原因是自定义投影没有调用 register，或没有设置有效 extent。先用 getProjection 打印确认实例存在，再补 setExtent，并检查中心点是否落在该 extent 内。
fromLonLat 和 transform 有什么区别？
fromLonLat 是 transform 的快捷封装，默认目标为 EPSG:3857；transform 可指定任意已注册的源与目标投影。日常经纬度进地图用前者更简洁。
内置 UTM 够用吗？什么时候必须上 proj4？
内置 UTM 误差约 0.1 米，一般可视化够用。若做高精度量算、工程放样或地方坐标系，必须用 proj4 重新定义并注册。
CDN 引入后投影转换失败怎么办？
CDN 完整构建体积大且省略部分模块，生产环境不推荐。改用 npm 模块化导入，并确保同时安装并注册了 proj4，问题通常消失。
总结：先确认默认 EPSG:3857 是否够用，不够再用 proj4 注册并务必设置 extent；坐标永远按 [lon, lat] 传递。建议新建项目时直接 npm install ol proj4，并在入口文件统一 register，后续所有转换与图层投影都走同一套定义，可大幅减少运行时异常。