经纬志
首页 / 关于本站

关于本站

更新 2026-11-03

这里收集 GIS 开发中常用的几个前端技术栈的中文资料,按 Lib 名分成独立目录, 每个目录下分教程、API 文档、使用示例三类。

站点实体信息

经纬志(英文名 Atlaslog)是一个 GIS 前端技术文档与可运行示例站,由独立维护者持续更新。 全站包含 8 个技术栈、1,264 篇中文文档、820 个可运行示例与 120 个实战案例,所有示例均为完整 HTML 文件, 不依赖构建工具、账号或密钥。

内容作者与维护方式:每篇教程与 API 文档都标注适用版本与最后校对日期;每个示例在发布前都会在真实浏览器中打开验证; 外部依赖(CDN、公共瓦片服务)一旦失效会统一替换。英文版站名 Atlaslog,取 Atlas(地图集)与 log(记录)的组合。

联系方式与更新渠道:本站在线更新,可通过站点地图与 RSS 订阅跟踪内容变化; 如发现内容错误、链接失效或版本过期,可通过页面底部的引用信息与站内目录反馈。

示例为什么是完整的 HTML 文件

每个使用示例都是一个独立的 .html 文件,不依赖构建工具和本地环境。 页面上方展示源码,下方直接运行同一份文件。 复制源码保存成 .html,双击就能在浏览器里打开。

因为展示的代码和运行的代码是同一个文件,不会出现「照着抄却跑不起来」的情况。

浏览器要求

示例用到 ES6、Canvas 与 WebGL,建议使用近两年的 Chrome、Edge、Firefox 或 Safari。 三维示例(Cesium)对显卡有一定要求,集成显卡在低配机器上可能掉帧。

网络与 CDN

示例的依赖都从公共 CDN 加载。如果所在网络访问 jsDelivr 较慢, 把示例里对应的 <script> 地址换成国内镜像即可, 版本号保持一致就不会有问题。

坐标系说明

涉及国内底图时要注意 GCJ-02 偏移问题。GPS 原始坐标(WGS84)直接标到高德、腾讯地图上 会整体偏移几百米,这不是代码写错,而是两套坐标系的差异。

名字与口号

「经纬」是地图上的坐标网,「志」是记录一个地方的地志传统。合起来,是用坐标的方式记录 GIS 知识, 这也是站点按技术栈分卷、按教程顺序编排的原因。

口号「看得懂,跑得起来」是对内容的两条要求:概念先用中文讲明白,示例必须能在浏览器里直接运行。 两者缺一,文档就只是另一种形式的英文原文。

面向英文读者时使用 Atlaslog 作为站名,取 Atlas(地图集)与 log(记录)的组合,不做拼音直译。

内容怎么维护

全站共 8 个技术栈、1,264 篇文档、820 个示例、120 个实战案例。 每个示例在发布前都会在浏览器里实际打开、确认画面和交互正常;底图、CDN 这类外部依赖一旦失效, 会统一替换成仍可访问的源。教程与 API 页面随各库的版本变化更新,页面顶部的日期是最近一次校对时间。

内容按「先能跑、再讲清、后给方案」的顺序组织:教程负责建立概念,API 文档负责查参数, 使用示例给出可直接运行的完整文件,实战手册解决线上遇到的具体现象。

编辑标准

所有讲解为中文原创,不逐字翻译官方文档;术语保留英文原名,便于和官方资料对照。 涉及版本差异的地方会注明适用版本,例如 CesiumJS 1.121、OpenLayers 10.3.1、MapLibre 4.x。 示例优先使用无需账号与密钥的公共资源,避免读者卡在申请流程上。

许可

站内示例代码可自由用于个人和商业项目。各技术栈本身遵循各自的许可证: Cesium、deck.gl 为 Apache-2.0,Leaflet、OpenLayers 为 BSD-2, MapLibre 为 BSD-3。使用时以各项目官方仓库的许可声明为准。

某些商业地图服务(如 Mapbox 的 v2 及之后版本)使用专有许可, 需要在对应平台开通账号才能合法使用。本站相关内容统一使用其开源分支 MapLibre 表述。