一周笔记精修:WebGIS 入门基础


一周笔记精修。本周跟着 WebGIS 课连续学习,从「让浏览器里出现一张能点的地图」一路走到「用 JSON 表达式让样式活起来」。下面不按日期/课时,而是按知识类型重新梳理,串成一张知识地图,便于日后按主题复习。

本周知识地图(按类型)

知识类型 核心问题
一、Web 与 JS 基础心智 网页/地图由哪几层构成?回调、箭头函数是什么?
二、坐标、基准与投影 为什么点会「漂」几百米?
三、GeoJSON 数据模型 空间数据怎么表达点线面?
四、Leaflet:用代码画地图 DOM/SVG 时代怎么加交互?
五、MapLibre GL:用配置画地图 WebGL 矢量时代怎么换思路?
六、表达式:让样式「活」起来 样式怎么按属性自动分色分大小?

两条贯穿全篇的暗线:坐标顺序(Leaflet / GeoJSON / MapLibre 三世界横跳)与回调(「到点才执行」的统一心智)。


一、Web 与 JavaScript 基础心智

1.1 网页与地图的两层模型

做网页 = 搭一个「能看、能动」的页面,三件工具各管一层:

  • HTML 描述结构布局(标题、段落、图片放哪),像房子的框架;
  • CSS 管样式(颜色、字号、间距),像刷漆摆家具;
  • JavaScript 管行为(点了发生什么、数据怎么加载),像通了电。

到了 WebGIS,一张地图也是两层叠出来的:

  • 底图瓦片(tiles):预先切好的地图图片,按 z/x/y 编号由浏览器自动拼接;
  • 矢量数据层(GeoJSON 等):点/线/面这类地理要素,想怎么标、怎么弹窗由它决定。

HTML 里:head 是「后台配置」(引入脚本、样式),body 才是页面内容;div 是容器,script 是行为操作。

1.2 四个 JS 概念(以首张地图代码为例)

核心就是把 GeoJSON 读出来、画成圆点、绑弹窗:

fetch('data.geojson')
  .then(res => res.json())
  .then(data => {
    L.geoJSON(data, {
      pointToLayer: (feature, latlng) => L.circleMarker(latlng, {
        radius: 8,
        color: '#2563eb'
      }),
      onEachFeature: (feature, layer) => {
        layer.bindPopup('<b>' + feature.properties.name + '</b><br>' + feature.properties.type);
      }
    }).addTo(map);
  });

① 箭头函数 (原料) => 加工 是匿名函数的简写。Leaflet 调用时临时把 feature(当前要素)和 latlng(坐标)传进来,函数返回画好的圆点。它最妙的一点是可以像普通值一样塞进「键-值结构」里。

② 键-值结构(对象 / object) 就是 JS 里的映射,和 Python 字典一个意思:{ radius: 8, color: '#2563eb' }。值可以是函数(如 pointToLayer),也可以是另一个对象——GeoJSON 本身就是层层嵌套的对象,properties 对应的值是属性,geometry 单独放坐标。

③ 回调函数 .then(callback) 在 fetch() 返回的 Promise 完成后才执行。res => res.json() 里 res 是临时变量,接收响应对象,res.json() 把它解析成 JS 对象交给下一步。一句话:回调就是「先答应一件事,条件满足了再回头做」——网络请求要时间,所以把「拿到数据后怎么办」挂在那儿等。

④ 查表 用类别自动决定颜色:

const colors = { 学习: '#2563eb', 运动: '#f59e0b', 生活: '#16a34a' };
const color = colors[feature.properties.type] || '#16a34a';

object[键] 用方括号按「键」动态查值;|| 是兜底:左边没找到时用默认色,防止某个类别漏配。

1.3 DOM 入口

document.getElementById('count')        // 按 id 找元素
document.querySelectorAll('button')     // 按选择器找所有 button

document 是浏览器页面的入口对象;getElementById() 按名称找,querySelectorAll('button') 按选择器找。


二、坐标、基准与投影

2.1 经纬度不是完整的坐标

「东经 121.47°、北纬 31.23°」只是一串数字,本身不能定位,还缺两件事:

  • 大地基准(datum):这串经纬度是站在哪个「地球模型」上说的?地球不是正球,各国用不同椭球和原点去近似。
  • 投影(projection):球面位置怎么摊平到平面屏幕?球面展开必有变形。

常见基准:

基准 说明 谁在用
WGS-84 GPS 默认全球基准(EPSG:4326) 国际通用;OSM;我们的 data.geojson
CGCS2000 中国现行国家大地坐标系(EPSG:4490) 测绘、国土、天地图
北京54 / 西安80 历史上的两代基准 老数据里常见

同一个经纬度在不同基准下对应地球表面不同位置,通常差几十到几百米。

2.2 投影:Web Mercator

Web 地图服务用的是 Web Mercator(EPSG:3857),等角圆柱投影——好处是方向准、瓦片能无缝拼图(浏览器按 z/x/y 取瓦片),代价是面积和距离失真。EPSG:4326 / 3857 / 4490 是坐标参考系统的唯一编号,一一对应。

2.3 中国特有的「加密偏移」

公开地图被加密过:

  • GCJ-02(火星坐标):国测局加密偏移,高德、腾讯底图在用;
  • BD-09:百度在 GCJ-02 上再加密一层。

所以 WebGIS 里最常见的坑——数据偏移,本质是坐标系不匹配:你的 WGS-84 数据叠到 GCJ-02 底图上,会整体漂几百米(上海约 470 米)。


三、GeoJSON:空间数据的通用语言

3.1 三层结构

GeoJSON 是空间数据的标准交换格式(RFC 7946),本质是 JSON + 一套约定:

FeatureCollection            // ① 数据集:一组要素
  └── features: [
        Feature               // ② 一个要素
          ├── geometry       // ③ 在哪:几何
          └── properties     // ③ 是什么:属性
      ]

几何 + 属性 = 要素(Feature);要素的集合 = 数据集(FeatureCollection)≈ 地图上的一个图层。

3.2 第一大坑:坐标顺序

GeoJSON 里坐标永远是 [经度, 纬度](RFC 规定),而 Leaflet 的 latlng 是 [纬度, 经度]。写反了点位就飞到海里。

三种几何与嵌套层级:

几何 coordinates 形态 含义
Point 一层数组 [x, y] 一个点
LineString 两层数组 [[x,y],...] 一串点连成线
Polygon 三层数组 [[[x,y],...]] 面由「环」组成,环由点组成,环必须闭合

记忆法:点一层、线两层、面三层,每多一层「包」就多一维。还有 MultiPoint / MultiLineString / MultiPolygon 及混合的 GeometryCollection,用到再查。

3.3 为什么这个模型重要

前后端共用一套语言(前端 Leaflet、后端 PostGIS、API 都认 GeoJSON);几何与属性天然分离;默认 WGS-84 无偏移,适合互联网交换。

3.4 按属性筛选

filter(f => f.properties.type === type)

f 是箭头函数的参数,表示遍历数组时拿到的当前元素,其实就是 feature。


四、Leaflet:用代码画地图(DOM/SVG 时代)

4.1 加底图与数据层

L.tileLayer(url, opts).addTo(map); // 把瓦片图层加进地图容器
L.geoJSON(data, {
  pointToLayer: (feature, latlng) => L.circleMarker(latlng, { radius: 8, color: '#dc2626' }),
  onEachFeature: (feature, layer) => layer.bindPopup(feature.properties.name)
});

pointToLayer 决定每个点画成什么;onEachFeature 对每个要素执行 layer.bindPopup(...),把属性绑成弹窗。

4.2 线 / 面样式

const lineLayer = L.geoJSON(data.lineData, {
  style: () => ({ color: '#16a34a', weight: 4, dashArray: '8 6' })
});
const areaLayer = L.geoJSON(data.areaData, {
  style: () => ({ color: '#2563eb', fillColor: '#2563eb', fillOpacity: 0.1, weight: 2 })
});

weight 线宽;dashArray 是「实线长度 空格长度」的虚线节奏;fillOpacity 填充透明度。

4.3 回调的第三种场景:用户操作后执行

前两种回调是 fetch().then()(数据到了)和 pointToLayer(遇到要素)。第三种是用户操作时:

layer.on('mouseover', () => layer.setStyle({ color: '#f59e0b', weight: 5 }));

layer.on('事件', (对象) => 执行),事件名有 click dblclick mouseover mouseout move zoomend 等。同样是「到点才执行」。

4.4 图层开关

L.control.layers(
  { 'OSM底图': osm },
  { 'POI': layers.pointLayer, 'Line': layers.lineLayer, 'Area': layers.areaLayer }
).addTo(map);

第一个参数是底图(单选),第二个是叠加层(可多选)。勾选/取消会直接把图层从地图上加/撤,不用自己写逻辑。

4.5 反思:mouseout 恢复样式的坑

一开始没理解 mouseover 的意思,和「双击标记变橙」混在一起(都是橙色),直到去读 Leaflet 美国人口密度示例才直观懂。关键是:先存原样式,mouseout 再 setStyle 回去——而且 original 已经是对象,别再套一层 {}:

const original = { color: layer.options.color, weight: layer.options.weight };
layer.on('mouseout', () => layer.setStyle(original)); // 正确:original 本身就是对象
// layer.setStyle({ original });  // 错误:多包了一层 {},会变成 { original: {...} }

4.6 点击取坐标

map.on('click', (e) => {
  console.log('纬度 ' + e.latlng.lat + ' / 经度 ' + e.latlng.lng);
});

注意 Leaflet 的事件对象是 e.latlng(先纬后经)。


五、MapLibre GL:用配置画地图(WebGL 矢量时代)

5.1 为什么换库:Leaflet vs MapLibre

Leaflet(DOM/SVG) MapLibre GL(WebGL 矢量)
渲染 DOM/SVG + 图片瓦片 WebGL + 矢量瓦片
样式 代码(setStyle / circleMarker) JSON 配置(style spec)
坐标 [纬度, 经度] [经度, 纬度]
事件 eachLayer 遍历后逐个绑 直接按图层 id 绑

不是 Leaflet 不好——它轻量简单够用;MapLibre 强在矢量瓦片渲染(百万点不卡)和样式即配置(换主题 = 换 JSON)。两种都该会。

5.2 核心心智:一个样式 = 数据源 + 图层

{
  "version": 8,
  "sources": { ... },
  "layers":  [ ... ]
}
  • source:数据从哪来(geojson / raster / vector);
  • layer:一个图层负责渲染 source 里的一种几何,用 type 声明:circle(点) / line(线) / fill(面) / symbol(文字图标)。

和 Leaflet 的关键差别:Leaflet 是一个要素一个图层对象;MapLibre 是一个 source 配多个图层,每个图层按几何类型「挑」出它要画的要素——同一份数据,circle 只画点、line 只画线、fill 只画面。

坐标顺序又反了:MapLibre 用 [经度, 纬度],和 GeoJSON 一致、和 Leaflet 相反。三个世界终于串起来:GeoJSON 先经后纬、MapLibre 先经后纬、Leaflet 先纬后经。

5.3 事件按图层 id 绑定

map.on('mouseenter', 'poi-circle', () => {
  map.getCanvas().style.cursor = 'pointer';
  map.setPaintProperty('poi-circle', 'circle-color', '#f59e0b');
  map.setPaintProperty('poi-circle', 'circle-radius', 12);
});
map.on('click', (e) => {
  info.textContent = '纬度 ' + e.lngLat.lat.toFixed(5) + ' / 经度 ' + e.lngLat.lng.toFixed(5);
});

注意事件对象是 e.lngLat(MapLibre),不是 Leaflet 的 e.latlng;info.textContent 是控件的显示文字。


六、表达式:让样式「活」起来(数据驱动)

6.1 栅格瓦片 vs 矢量瓦片

栅格瓦片(raster) 矢量瓦片(vector)
传输 服务器渲染好的图片(PNG) 几何 + 属性数据(pbf)
改样式 要重新出图 改一行 JSON 立刻生效
点选 点不到「属性」 可查属性、做交互
体积/性能 大、慢 小、快(客户端渲染)

表达式对 vector / geojson source 完全通用——这是矢量瓦片时代「样式即配置」的灵魂。

6.2 表达式 = 写在样式里的「小函数」

表达式是一个 JSON 数组,第一个元素是函数名,后面是参数:

表达式 作用 示例
['get', '属性名'] 取要素某属性值 ['get', 'type']
['match', 输入, 标签1, 输出1, ..., 默认] 分支:等于哪个标签用哪个输出 见下
['==', a, b] 比较是否相等 ['==', ['get','type'], '学习']
['interpolate', ...] 插值(随 zoom/数值渐变) 后续再讲

关键:paint 属性值可以是一个表达式数组——这就是「数据驱动样式」。以前在 Leaflet 里写 if/else 的地方,现在变成一行 JSON。心智模型:表达式就是「不写代码的代码」,把 if (type === '学习') color = '蓝' 翻译成 ['match', ['get','type'], '学习', '蓝', ...]。

6.3 动手:分色、分大小、过滤

// 圆点按类型分色
'circle-color': ['match', ['get', 'type'], '学习', '#2563eb', '生活', '#16a34a', '#9ca3af']

// 圆点按类型分大小
'circle-radius': ['match', ['get', 'type'], '学习', 12, '生活', 8, 6]

// 按钮过滤
map.setFilter('poi-circle', type === '全部' ? null : ['==', ['get', 'type'], type]);

type === '全部' 做条件判断,三元表达式 ? 是 : 否。注意表达式里一个是数据 JSON 的 'type' 键(要加引号),一个是变量 type,别混。

6.4 挑战:点击要素弹名称

map.on('click', 'poi-circle', (e) => {
  if (!e.features || e.features.length === 0) return; // 防御:没命中就不报错
  const name = e.features[0].properties.name;
  new maplibregl.Popup()
    .setLngLat(e.lngLat)
    .setHTML('<b>' + name + '</b>')
    .addTo(map);
});

图层级事件的命中要素都在 e.features 数组里;if (!e.features || e.features.length === 0) return; 是防御机制,避免空指针报错。


本周小结(按类型回顾)

  • Web / JS 心智:网页 = HTML/CSS/JS 三层;地图 = 底图瓦片 + 矢量数据层。箭头函数、键-值结构、回调、查表是读地图代码的四块基石。
  • 坐标与投影:经纬度要配「基准 + 投影」才完整;Web Mercator 方向准但面积失真;中国底图有 GCJ-02/BD-09 加密,WGS-84 数据叠上去会漂几百米。
  • GeoJSON 模型:FeatureCollection → Feature(geometry+properties);坐标永远 [经,纬];点线面嵌套层数递增。前后端通用语言。
  • Leaflet(代码画地图):pointToLayer/onEachFeature 加数据,layer.on() 做交互,L.control.layers 做开关;悬停高亮记得 setStyle(original) 别多包一层 {}。
  • MapLibre(配置画地图):style = source + layers,一个 source 配多图层按几何挑要素;事件按图层 id 绑;坐标 [经,纬] 与 GeoJSON 一致。
  • 表达式(活样式):get/match/== 把 if/else 翻译成一行 JSON,实现分色、分大小、过滤。

两条暗线:

  1. 坐标顺序三世界:GeoJSON [经,纬] = MapLibre [经,纬] ≠ Leaflet [纬,经]。写 MapLibre 时脑子切回「数据世界」即可。
  2. 回调是统一心智:fetch().then()(数据到)、pointToLayer(遇要素)、layer.on() / map.on()(用户操作)——都是「先约定、到点执行」。

下一步:继续深入 queryRenderedFeatures 点击查询、interpolate 插值表达式,把地图从「看得见」变成「点得动、查得到」。