GeoLibre 云原生 GIS 实战指南：从第一张地图到分享嵌入的完整工作流

GeoLibre 云原生 GIS 实战指南从第一张地图到分享嵌入的完整工作流【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibreGeoLibre 是一个轻量级的云原生 GIS 平台能在浏览器、桌面端、移动端和 Jupyter Notebook 中完成地理空间数据的可视化、探索与分析。本文不按教程一二三的顺序罗列而是按你实际要解决的任务组织快速出一张图、不下载就加载远程大数据集、做几何与地形分析、用 SQL 查数上图最后把成果发布并嵌入网页。跟着任务走你就能从空工作区一路做到可分享的分析成果。动手前先分清哪些功能在浏览器里就能跑哪些离不开桌面端️ GeoLibre 同时有浏览器构建版web.geolibre.app无需安装任何软件和桌面应用。两者的能力边界直接决定了你该在哪台设备上动手官方文档也只在需要桌面端的步骤处做了单独标注能力浏览器版桌面应用在线底图 远程数据加载✅✅打开 / 保存.geolibre.json项目文件❌✅读取本地 MBTiles 与本地栅格❌✅Python 侧车工具rasterio 栅格处理、部分格式转换❌✅Whitebox 地理处理工具箱1000 工具✅WebAssembly 运行零安装✅项目分享Project → Share✅✅ 容易误解的一点Whitebox 地理处理工具箱不需要桌面端——它的一千多个工具以 WebAssembly 形式直接在浏览器里运行。真正依赖桌面应用的只有本地文件读写和 Python 侧车相关的工具。多个任务会反复用到同一份公开的世界各国 GeoParquet 示例数据集https://data.source.coop/giswqs/opengeos/countries.parquet它的字段沿用 Natural Earth 命名NAME、CONTINENT、POP_EST、GDP_MD_EST几何列是geom。如何几分钟内做出第一张带样式的地图这是最快的上手路径全程可以在在线版完成。添加第一个矢量图层点击添加数据 → 矢量图层Add Data → Vector Layer。在弹出面板的 URL 输入框中粘贴上面那份countries.parquet的地址。点击加载Load。加载完成后国家边界会直接出现在底图上同时图层面板里多出一个名为countries的图层。支持的数据源类型远不止矢量 URL可查阅 添加数据参考。给图层上色与做分级统计图在图层面板选中countries展开右侧的样式面板若折叠。调整填充颜色、轮廓颜色和填充不透明度地图会实时刷新。想按人口或 GDP 画分级统计图choropleth把样式类型设为Graduated选一个数值属性如POP_EST或GDP_MD_EST再挑类别数Classes、配色方案Scheme与色带Colormap最后点应用样式类型。此时每个分级会在色带下方列出对应颜色。在属性表里检查数据点状态栏上的属性表展开选中countries图层加载记录。按任意列排序或在搜索属性框里输入关键词定位要素选中某一行时地图会同步高亮对应国家。点探索Explore可以一次性剖析每个字段的类型、完整度和值分布。还可以为该图层开启要素识别Identify features之后直接点击地图上的某个国家弹窗即显示它的属性。保存或发布桌面端项目 → 保存写入一个.geolibre.json文件到本地。任何环境项目 → 分享上传后得到一个公开链接后面发布与嵌入一节会展开。如何不下载整个文件就加载远程 GeoParquet、FlatGeobuf 与 COG☁️ GeoLibre 的卖点之一就是为云原生格式而生矢量侧的 GeoParquet 与 FlatGeobuf、栅格侧的 Cloud-Optimized GeoTIFFCOG、瓦片侧的 PMTiles都能通过 HTTP 按需读取而不是先把文件整个拖进内存。流式加载远程 GeoParquetGeoParquet 是压缩的列式矢量格式天生适合 HTTP 读取打开添加数据 → GeoParquet 图层或矢量图层。粘贴一个 GeoParquet 地址例如示例数据集的 URL。勾选流式 GeoParquet不拷贝Stream GeoParquet (no copy)它会改用 HTTP range 请求原地查询文件。这一模式对按空间排序如 Hilbert 序的大文件效果最好——GeoLibre 自带的转换工具写出的文件正是 Hilbert 序——因为这样只需要抓取当前查询涉及的那几个 row group。点击加载。这套按需读取的能力由 duckdb-vector-loader.ts 基于 DuckDB-WASM 实现tests/geoparquet-metadata.test.ts 与 tests/geoparquet-crs.test.ts 则从元数据解析和坐标系两个维度验证了读取管线的正确性。加载 FlatGeobuf 与 COG格式入口特点FlatGeobuf.fgb添加数据 → FlatGeobuf 图层自带空间索引、对流式读取友好GeoLibre 在格式允许时只抓取当前视图内的要素COG.tif添加数据 → 栅格图层经过组织的 GeoTIFF客户端只读取所需瓦片加载后可在样式面板调亮度、对比度、饱和度与色相 不想走菜单把本地 GeoTIFF 或 COG 文件直接拖到地图上也会作为栅格图层添加。把本地数据转换成云原生格式转换工具都在处理 → GeoLibre 工具箱 → 转换下但不同工具跑在不同引擎上转换工具运行位置矢量转 GeoParquet、CSV 转 GeoParquet浏览器内DuckDB-WASM参见 duckdb-processing.ts矢量转 FlatGeobuf、矢量转 PMTilesPython 侧车桌面应用栅格转 COGPython 侧车桌面应用以把本地 GeoJSON 发布为 GeoParquet为例打开转换 → 矢量转 GeoParquet选输入文件和输出路径运行转换再把生成的 GeoParquet 加回地图验证——数据没变、体积更小、还能被流式读取。转换完的数据可以无缝接入后面的空间 SQL 查询SQL 工作区能直接从 URL 读 Parquet、CSV、JSON、GeoJSON也可以用时间滑块插件Time Slider对一串 COG 做时间动画详见 数据集成。如何做矢量分析缓冲、叠加与属性挂接本节完成一个小工作流缓冲一个图层 → 与另一个图层叠加 → 检查结果 → 导出。工具都在处理 → GeoLibre 工具箱 → 矢量菜单下。⚠️ 同一个菜单里藏着两个工具箱处理 → 矢量分隔线上方是 Whitebox 目录的矢量类别本任务要的是处理 → GeoLibre 工具箱 → 矢量里的对话框。选错菜单会打开完全不同的工具集。第一步准备输入至少需要一个矢量图层做叠加则需要两个比如一组点/线要素加一个用于裁剪的多边形图层。第二步缓冲图层注意引擎差异打开处理 → GeoLibre 工具箱 → 矢量 → 缓冲设置输入图层、距离、单位公里、米、英里然后选引擎引擎运行位置适用场景客户端Turf.js浏览器零配置快速验证、小范围缓冲侧车GeoPandasPython 侧车桌面应用大范围区域需要精确公制距离PythonPyodide浏览器内跑同样的 GeoPandas 代码与侧车结果一致却不用装侧车首次使用会下载一次运行时点运行后缓冲结果图层即被添加到地图上。 为什么引擎会影响结果客户端引擎在地理坐标经纬度里做缓冲面积一大误差就明显。要在大范围区域内得到精确的公制距离请选两个 GeoPandas 引擎之一——它们会先重投影再缓冲其中 PythonPyodide引擎在 Web 构建版里也能用。第三步叠加与连接两个图层有了缓冲结果或任意多边形图层和第二个图层可在矢量菜单里选对应工具裁剪Clip只保留输入中落在叠加图层内部的部分并保留输入的属性。相交Intersection只留下两个多边形图层的重叠区域。差异Difference从输入中挖掉叠加图层覆盖的区域。合并Union两个多边形图层并成一个任何引擎下都不保留属性。空间连接Spatial join按空间关系相交、位于内部、包含把连接图层的属性挂到每个输入要素上——典型用法是给每个点打上包含它的那个多边形的标签适用于任何几何类型。属性连接Attribute join不碰几何靠关键字段匹配挂接属性——例如通过共同的 FIPS 代码把人口普查统计挂到边界多边形上。它是一对一的第一条匹配的连接行胜出两侧各选关键字段可选要带过来的字段列表并选择内连接或左连接。选好输入与叠加图层点运行即可。第四步检查输出并复用在结果图层上打开属性表核对属性再调整样式让它与输入图层区分开。每次运行都会记入处理 → 历史历史条目支持一键重跑并且会复制等价的 Python 代码方便你在脚本里复现同样的操作。第五步导出结果要把输出存成云原生文件走处理 → GeoLibre 工具箱 → 转换如矢量转 GeoParquet、矢量转 FlatGeobuf也可以直接从属性表或 SQL 工作区导出记录。如何从 DEM 派生山体阴影、坡度图与等高线️ 地形分析的任务是给一个数字高程模型DEM产出山体阴影、坡度图和等高线。工具位于处理 → GeoLibre 工具箱 → 栅格。先看引擎分工哪些能在浏览器里跑工具客户端浏览器引擎备注山体阴影Hillshade✅浏览器零安装即可运行坡度Slope✅同上坡向Aspect✅同上等高线Contour❌仅侧车rasterio需桌面应用按掩膜图层裁剪Clip by mask layer❌仅侧车需桌面应用每个工具顶部都有引擎选择器会显示当前环境可用的选项。对大栅格或地理坐标系经纬度下的地形数据建议优先用侧车引擎。加载 DEM栅格工具是文件进、文件出本地或可访问的栅格效果最好。添加一个 GeoTIFF 或 COG 格式的 DEM 图层即可。生成山体阴影并叠到底图之上打开处理 → GeoLibre 工具箱 → 栅格 → 山体阴影。选 DEM 为输入按需设置方位角azimuth、高度角altitude与 z 因子来调光照。运行后着色浮雕栅格会作为新图层加入地图。把它拖到其他图层的下方并把上层图层的混合模式设为正片叠底Multiply——这样地形起伏会从颜色里透出来如果用降低不透明度的老办法两个图层会被一起洗淡。计算坡度与坡向栅格 → 坡度计算每个像元的陡峭程度。栅格 → 坡向计算最陡下降方向的罗盘方位。任选其一运行后用色带colormap给输出上色再从地图上的控件菜单打开色条Colorbar显示数值标尺。生成等高线打开栅格 → 等高线Contour。选 DEM设置间距interval即相邻两条线之间的高程差。运行后得到矢量格式的等高线图层可以像任何矢量数据一样加标注、改样式。⚠️ 等高线没有客户端引擎只跑在 Python 侧车上所以这一步必须用桌面应用。裁剪到研究区想把输出限制在特定区域栅格 → 按范围裁剪Clip by extent边界框方式浏览器也能跑或按掩膜图层裁剪矢量掩膜仅侧车。后续可以再用栅格转矢量Polygonize把栅格输出变成矢量或写出栅格转 COG方便分享栅格序列的时间动画同样交给时间滑块插件。如何用 DuckDB 空间 SQL 查询数据并直接上图 从处理 → SQL 工作区打开 SQL 工作区。它基于 DuckDB-WASM 运行所以浏览器和桌面应用里都可用空间扩展也默认加载——所有ST_*函数开箱即用。查询已加载的图层每个已加载的矢量图层就是一张可查询的表。先按前面的步骤加载countries图层然后运行SELECT NAME, CONTINENT, GDP_MD_EST FROM countries ORDER BY GDP_MD_EST DESC LIMIT 10;点运行结果表里就是预估 GDP 最高的十个国家。 换数据集时列名会不同。不确定字段时先跑DESCRIBE SELECT * FROM 你的文件URL看结构比猜列名快得多。直接查询远程文件URL 就是表名不用先加载文件——工作区会识别FROM子句里的裸 URL自动包上正确的读取器再通过 HTTP range 请求流式读取全程不整体下载SELECT COUNT(*) AS n FROM https://data.source.coop/giswqs/opengeos/countries.parquet;这是 SQL 工作区的专属便利写法在标准 DuckDB CLI 里你得显式写read_parquet(https://...)。其按需读取逻辑与流式 GeoParquet 同源duckdb-vector-loader.ts相关行为由 tests/sql-query-layer.test.ts 等测试覆盖。用空间函数做分析-- 数据位于 EPSG:4326面积单位是平方度 -- 排序结论有效但要平方千米请用 ST_Area_Spheroid(geom) / 1e6。 SELECT NAME, ST_Area(geom) AS area, geom FROM https://data.source.coop/giswqs/opengeos/countries.parquet WHERE CONTINENT Africa ORDER BY area DESC;注意保留geom列——这是结果能上图的前提。结果上图与导出当查询返回几何列时点添加为图层即可从结果创建新图层可顺手命名。结果图层与普通矢量图层一样支持识别、选择和属性表还能一次添加多个结果图层。导出 CSV与导出 GeoParquet按钮就在添加为图层旁边查询结果可直接落地为文件。 卡住了就用示例查询菜单从一个可运行的查询起步或用历史重跑之前的查询。如何把项目发布为公开链接并嵌入到网页地图做完后的最后一步是分发。GeoLibre 的分享走share.geolibre.app需要一次性配置个人 API 令牌。配置分享令牌只做一次打开设置 → 环境变量。把令牌粘贴到Share.GeoLibre API token字段令牌在 share.geolibre.app/settings 的设置 → API 令牌处创建。分享项目先摆好地图图层、样式都弄好把视图停在希望观众第一眼看到的位置。打开项目 → 分享...。确认标题并上传返回一个指向.geolibre.json的公开 URL例如https://share.geolibre.app/you/my-map.geolibre.json分享文件捕获的内容与本地保存完全一致图层、样式、插件状态、地图视图。唯一例外是读取你电脑上本地文件的图层——分享前对话框会把它们列为缺失因为share.geolibre.app只存项目文件绝不替你上传数据文件。本地数据需要先托管到公网参见 项目文档 - 分享本地数据。用 url 参数打开分享的项目任何人都可以把项目 URL 作为url参数传给在线版https://web.geolibre.app/?urlhttps://share.geolibre.app/you/my-map.geolibre.json用 iframe 嵌入页面并用参数控制界面外壳一个干净的纯地图嵌入长这样iframe srchttps://web.geolibre.app/?urlhttps://share.geolibre.app/you/my-map.geolibre.jsonamp;maponly titleGeoLibre map width100% height600 styleborder: 0; loadinglazy allowfullscreen; geolocation /iframe常用外观参数可自由组合参数效果典型场景maponly隐藏全部界面外壳只留地图地图是页面里的插图不需要交互layoutviewer只读地图图层开关、视图、控件、底图、搜索/识别保留一切能修改项目的入口被隐藏读者要探索数据但不能改项目layoutcompact保留一条细长的纯图标工具栏空间紧张但需要完整功能toolbarnone隐藏顶部工具栏保留侧面板和状态栏—panelsnone隐藏侧边与底部面板保留工具栏—themedark加载时强制深色主题匹配站点配色完整参数表含data、style、tool深链等见 嵌入与分享参考。进阶从你的页面在运行时驱动地图URL 参数只在加载时生效一次。要在运行时持续对话——飞到用户在你自己界面里点击的记录、监听图内的操作——安装类型化客户端npm install geolibre/embedimport { connect } from geolibre/embed; const map await connect(document.querySelector(iframe), { origin: https://web.geolibre.app, }); map.on(selectionChanged, ({ featureIds }) showRecordFor(featureIds[0])); async function focusField(field) { await map.setView({ bbox: field.bbox }); await map.highlightFeature({ layerId: fields, filter: { parcel_id: field.id }, fit: true }); }这个客户端由 packages/embed/ 提供配套契约见 tests/embed-api.test.ts。⚠️ 运行时 API默认关闭它只对你的页面源origin加入白名单的部署生效。web.geolibre.app本身没有开放白名单所以这套接口面向你自己托管的构建版Docker 镜像设GEOLIBRE_EMBED_ORIGINS环境变量即可开启。不想引依赖的话文档里也记录了免依赖的原始postMessage协议。官方录制的演示视频按主题挑选着看文字之外官方维护了一组从旧到新的实操录屏收录于 视频教程每篇都有分章节索引和摘要可与上文任务对照时长主题你会看到什么40:18GeoLibre 1.0 完整介绍浏览器/桌面/Jupyter 三种构建的安装与运行项目、矢量与栅格数据、属性与几何编辑流式加载 180 GB 数据集而不下载PMTiles、3D 瓦片、LiDAR、DuckDB、地图控件与分享21:52浏览器中的地理处理完全跑在 WebAssembly 上的 Whitebox 工具箱地形、水文、LiDAR、遥感、栅格、矢量当时 700 工具现已增长到 10008:26免费高分辨率灾害卫星影像安装 Vantor Open Data 插件、检索 STAC 目录、对比灾前灾后影像、下载原始 COG16:25浏览器中规整建筑足迹用 Rust 实现的规整化工具清理不规则建筑多边形附可运行的示例项目25:41GeoLibre GeoLens 自托管技术栈部署 GeoLens、从 GeoLibre 浏览目录、做带拉伸与表达式样式的 3D 地图、时间动画展示建筑增长、编辑并回写 GeoLens18:55Model Builder 与 AI 助手在浏览器里搭图形化可复用处理流程简单矢量链 完整水文模型并用自然语言提示让 AI 助手自动生成模型23:14免费高分辨率卫星影像制图 2026 尼泊尔洪水完整灾害响应工作流查找、查看、对比、下载开放影像Vantor Open Data、Planet Crisis Response、OpenAerialMap前后对比滑动地图、3D 地形、Overture Maps 建筑足迹提取与导出1:07:28云原生 GIS 工作流网络研讨会最长的一次项目总览COG、GeoParquet、PMTiles、DuckDB 与 WebAssembly 如何协同插件生态、跨平台构建与 GeoAI 集成15:35浏览器中影像地理配准放置地面控制点、选择变换方法、读逐点与 RMS 残差、导出 GeoTIFF、处理 NoData 透明、滑动工具对比底图高频问题速查哪些操作必须用桌面应用打开/保存项目文件、读取本地 MBTiles 与栅格、Python 侧车工具rasterio 栅格处理等高线按掩膜裁剪矢量转 FlatGeobuf / 矢量转 PMTiles / 栅格转 COG 等转换。Whitebox 工具箱不在此列——它靠 WebAssembly 在浏览器里跑。矢量缓冲选哪个引擎客户端Turf.js零配置适合快速出图要精确公制距离尤其大范围区域选侧车GeoPandas桌面或 PythonPyodide任意环境。COG 序列怎么动起来配合时间滑块插件做时间动画参见 数据集成。嵌入参数能随便组合吗可以。maponly、layoutviewer、layoutcompact、toolbarnone、panelsnone、themedark彼此独立按需叠加即可。收尾把六段任务串成一条线回到任务视角看整条链路是出图添加图层 样式 属性表→喂数据流式读取云原生格式、本地数据转换→加工矢量叠加与 DEM 地形派生→问数DuckDB Spatial SQL 上图与导出→分发分享链接 嵌入参数 运行时 API。先从浏览器在线版零安装走一遍遇到需要本地文件或侧车的步骤再切桌面应用就能以最低成本跑通 GeoLibre 的完整工作流。【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考