一周笔记精修: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,实现分色、分大小、过滤。
两条暗线:
- 坐标顺序三世界:GeoJSON
[经,纬]= MapLibre[经,纬]≠ Leaflet[纬,经]。写 MapLibre 时脑子切回「数据世界」即可。 - 回调是统一心智:
fetch().then()(数据到)、pointToLayer(遇要素)、layer.on()/map.on()(用户操作)——都是「先约定、到点执行」。
下一步:继续深入 queryRenderedFeatures 点击查询、interpolate 插值表达式,把地图从「看得见」变成「点得动、查得到」。