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 中运行。读完这篇使用指南你能独立完成这些事从远程 URL 流式加载 GeoParquet 与 COG 图层、为数据做分级统计图并检查属性、运行缓冲与叠加等几何操作、从 DEM 派生山体阴影与等高线、用 DuckDB Spatial 直接查询数据并把结果上图最后把成果分享成公开链接、嵌入任意网页。选运行环境哪些任务零安装、哪些必须桌面端动手前先按任务定环境大多数操作在浏览器在线版web.geolibre.app。任务在线浏览器桌面应用加载远程 GeoParquet / FlatGeobuf / COG、样式化、属性检查✅✅空间 SQL 查询DuckDB-WASM✅✅矢量转 GeoParquet、CSV 转 GeoParquetDuckDB-WASM✅✅Whitebox 地理处理工具箱1000 工具WebAssembly 运行✅✅项目文件读取 / 保存.geolibre.json❌✅本地 MBTiles 与栅格文件❌✅Python 侧车随桌面应用提供的 Python 辅助进程矢量转 FlatGeobuf / 转 PMTiles、栅格转 COG、rasterio 栅格处理❌✅等高线、按掩膜图层裁剪❌✅⚠️ 白名单之外只有一条例外值得记住Whitebox 地理处理工具箱不在必须桌面端名单里它以 WebAssembly 形式在浏览器内运行无需任何安装。数据进门远程图层加载与流式读取GeoLibre 为云原生地理空间格式而生矢量侧的 GeoParquet 与 FlatGeobuf、栅格侧的 COGCloud-Optimized GeoTIFF一种按瓦片友好方式组织的 GeoTIFF、瓦片侧的 PMTiles。远程矢量GeoParquet 与 FlatGeobufGeoParquet 是压缩的列式矢量格式天生适合走 HTTP 读取。打开添加数据 → 矢量图层Add Data → Vector Layer或添加数据 → GeoParquet 图层粘贴文件 URL 后加载地图立刻出现数据图层面板多出对应条目。FlatGeobuf 自带空间索引、对流式读取友好走添加数据 → FlatGeobuf 图层Add Data → FlatGeobuf Layer加载.fgb文件GeoLibre 会在格式允许时只抓取当前视图内的要素。栅格同理COG / GeoTIFF 走添加数据 → 栅格图层Add Data → Raster Layer加载后即可在样式面板调亮度、对比度、饱和度与色相本地栅格文件直接拖到地图上也能作为图层加入。多个教程共用的示例数据是 用户指南 里反复引用的公开世界国家数据集https://data.source.coop/giswqs/opengeos/countries.parquet大文件不拷进内存流式读取 远程文件很大时在添加面板启用流式 GeoParquet不拷贝Stream GeoParquet (no copy)文件通过 HTTP range 请求被原地查询不必整体下载。该模式对行按空间排序的大文件收益最大——GeoLibre 自带转换工具写出的文件正是 Hilbert 序浏览大范围时只拉取相关行组的网络流量。这套按需加载的实现位于apps/geolibre-desktop/src/lib的 DuckDB 矢量加载模块配套测试从元数据与坐标系两个维度验证了整条读取管线。数据进门续本地矢量发布为 GeoParquet转换工具集中在处理 → GeoLibre 工具箱 → 转换Processing → GeoLibre Toolbox → Conversion按 处理工具 分两条路线矢量转 GeoParquetVector to GeoParquet、CSV 转 GeoParquet浏览器内由 DuckDB-WASM 完成矢量转 FlatGeobuf、矢量转 PMTiles、栅格转 COGRaster to COG运行在 Python 侧车上仅桌面应用可用。以本地 GeoJSON 为例目标是在三步内发布成可被远程读取的 GeoParquet在转换分组选择矢量转 GeoParquet指定输入文件与输出路径运行转换再把产物加回地图核对一遍即完成本地 → 云原生的闭环。COG 序列想动起来配合时间滑块插件做时间动画即可参见数据集成。地图出样样式、分级统计图与属性检查让样式承载信息选目标从单调的默认外观到一张分级统计图choropleth。在图层面板选中图层展开右侧样式面板先调填充颜色Fill color、轮廓颜色Outline color、填充不透明度Fill opacity三项基础参数要做分级统计图把样式类型Style type设为Graduated选一个数值型属性Attribute作为驱动字段——示例数据里可用POP_EST或GDP_MD_EST——再指定类别数Classes、配色方案Scheme与色带Colormap最后点应用样式类型Apply style type。出图前摸清数据目标确认字段完整、分布合理再动手。点状态栏属性表Attribute table展开表格选中图层后记录加载进来按列排序、在搜索属性Search attributes框键入关键词定位要素选中行时地图同步高亮对应要素。点探索Explore按钮可一次性剖析每个字段的类型、完整度与值分布。另一种方式是为图层开启要素识别Identify features之后点击地图上的国家即在弹窗中查看其属性细节见属性表。数据加工矢量缓冲、叠加与连接矢量工具箱位于处理 → GeoLibre 工具箱 → 矢量Processing → GeoLibre Toolbox → Vector含缓冲、裁剪、相交、差异、合并、空间连接与属性连接。⚠️ 同一菜单位置上有两个工具箱分隔线上方的处理 → 矢量Processing → Vector属于 Whitebox 目录的矢量类别本阶段使用的是分隔线下方 GeoLibre 工具箱里的同名分组详见一个菜单下的两个工具箱。做叠加前地图上至少要有两个图层例如一组点或线加一个多边形。缓冲三种引擎按精度要求选目标是把点、线要素变成等距范围面。打开处理 → GeoLibre 工具箱 → 矢量 → 缓冲Buffer设置输入图层Input layer、距离Distance与单位Units公里 / 米 / 英里然后选引擎引擎运行位置特点客户端Turf.jsClient浏览器内零配置按地理坐标计算侧车GeoPandasSidecarPython 侧车缓冲前先重投影公制距离更精确仅桌面应用PythonPyodide浏览器内运行与侧车相同的 GeoPandas 代码结果一致且免安装运行时首次使用时下载一次 大范围区域要精确的公制缓冲距离时优先选后两种 GeoPandas 引擎——它们缓冲前先重投影Pyodide 版本让 Web 构建也享有同样的精度。叠加与连接六种工具按需选裁剪Clip保留落在叠加图层内部的输入部分并保留输入属性相交Intersection只留两个多边形图层的重叠区域差异Difference从输入中减去叠加图层的区域合并Union把两个多边形图层合成一个两种引擎都不保留属性空间连接Spatial join按空间关系相交、包含或位于内部把连接图层的属性挂到每个输入要素上——例如给每个点打上包含它的多边形的标签适用于任何几何类型属性连接Attribute join在关键字段匹配时挂接属性不涉及几何比如用共享的 FIPS 代码把人口普查统计挂到边界多边形一对一匹配第一个匹配的连接行胜出两侧各选关键字段可选列出要带过来的字段并选内连接或左连接。选定输入与叠加图层后运行即可。每次运行都记入处理 → 历史Processing → History历史条目一键重跑还能复制出等价的 Python 代码。数据加工栅格从 DEM 派生山体阴影、坡度与等高线栅格工具处理 → GeoLibre 工具箱 → 栅格栅格工具按文件进、文件出的方式工作本地或可访问的栅格效果最好。⚠️ 引擎可用性要先看山体阴影Hillshade、坡度Slope、坡向Aspect都有客户端浏览器引擎浏览器构建零安装可跑等高线Contour与按掩膜图层裁剪Clip by mask layer没有客户端引擎依赖 rasterio 侧车由桌面应用管理。每个工具顶部的引擎选择器会如实列出可用项大栅格或地理 CRS 下的地形建议优先侧车引擎。山体阴影选 DEM 作输入需要调光照时设置方位角azimuth、高度角altitude与 z 因子z-factor。运行后把着色浮雕图层放到其他图层下方再把上层的混合模式设为正片叠底Multiply——浮雕就能透过颜色显现出来而不是靠降不透明度把两边一起冲淡。坡度与坡向分别计算陡峭程度和最陡坡的罗盘方向。对 DEM 运行后用色带给输出配色再从控件菜单打开色条Colorbar显示数值标尺。等高线设置线间高差间距interval即输出矢量等高线可像普通矢量数据一样标注与样式化——此步仅侧车可跑需桌面应用。限区用按范围裁剪Clip by extent边界框浏览器可跑或按掩膜图层裁剪矢量掩膜仅侧车把输出限制在研究区。数据问数SQL 工作区查图层与远程文件SQL 工作区基于 DuckDB-WASM 运行浏览器与桌面应用里都一样可用从处理 → SQL 工作区Processing → SQL Workspace打开。已加载的每个矢量图层都是可查询的表。先载入示例国家图层点运行Run看预估 GDP 前十的国家SELECT NAME, CONTINENT, GDP_MD_EST FROM countries ORDER BY GDP_MD_EST DESC LIMIT 10;NAME、CONTINENT、POP_EST、GDP_MD_EST是示例countries.parquet采用的 Natural Earth 字段名几何列为geom换成别的数据集就先跑DESCRIBE SELECT * FROM your-file-url摸清列名。工作区能识别FROM子句里的裸 URL 并自动包装对应读取器再以 HTTP range 请求流式读取不必先全量下载——标准 DuckDB CLI 里要显式写read_parquet(https://...)这里是 SQL 工作区的便利写法。空间扩展已加载所有ST_*函数可用-- 数据位于 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;查询返回几何列时点添加为图层Add as layer即生成新图层可选命名结果图层像普通矢量图层一样支持识别、选择与属性表一次还能添加多个结果。导出 CSV与导出 GeoParquet两个按钮就排在添加为图层旁边查询结果不用绕道就能落盘。想从可运行的查询起步用示例查询Sample queries菜单重跑旧查询用历史History。成果出门分享令牌、公开链接与网页嵌入发布前先备一个凭证打开设置 → 环境变量Settings → Environment Variables把Share.GeoLibre API token粘贴进对应字段令牌在 share.geolibre.app/settings 的设置 → API 令牌下创建一次配置即可。然后摆好地图——图层、样式、视图位置都调到观众落地的样子——从项目 → 分享...Project → Share...确认标题并上传。系统返回一个指向.geolibre.json的公开 URLhttps://share.geolibre.app/you/my-map.geolibre.json分享文件捕获的内容与本地保存一致图层、样式、插件状态与地图视图。例外是读取你电脑上文件的图层——share.geolibre.app只存项目文件、绝不上传数据文件所以分享前的对话框会把这些图层列为缺失托管本地数据的办法见分享本地数据。让任何人打开它把项目 URL 作为url参数传给在线版即可https://web.geolibre.app/?urlhttps://share.geolibre.app/you/my-map.geolibre.json嵌入网页iframe加 URL 参数控制界面外壳参数可自由组合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加载时强制深色主题读者要能开关图层、浏览数据却不能修改时选layoutviewer地图只是页面插图而非交互对象时选maponly。完整参数表见嵌入与分享。运行时与地图对话URL 参数只在加载时生效一次。要持续对话——飞到用户在你自己界面里点击的记录、监听图内操作——安装类型化客户端实现位于packages/embednpm 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 }); }这段代码只对把你页面源origin加入白名单的部署生效——官方在线版未开放白名单因此运行时 API 适用于你自己托管的构建免依赖的原始postMessage协议见运行时与地图对话。延伸资源视频教程速览文字流程之外官方维护了一组录制好的演示详见视频教程每条一句话说明用途视频时长用途GeoLibre 1.0 完整介绍40:18浏览器 / 桌面 / Jupyter 三种构建的安装与运行覆盖项目、矢量与栅格数据、属性与几何编辑、流式读取 180 GB 数据集、PMTiles、3D 瓦片、LiDAR、DuckDB、控件与分享浏览器中的地理处理21:52WebAssembly 运行的 Whitebox 工具箱700现已 1000地形、水文、LiDAR、遥感、栅格与矢量工具免费高分辨率灾害卫星影像8:26Vantor Open Data 插件安装、STAC 目录检索、灾前灾后影像对比与 COG 下载规整建筑足迹16:25Rust 规整化工具在浏览器内清理不规则建筑多边形附实时示例项目GeoLibre GeoLens25:41部署 GeoLens、浏览其目录、构建带拉伸与表达式样式的 3D 地图、随时间动画建筑增长、编辑并回写Model Builder 与 AI 助手18:55浏览器内构建图形化可复用处理流程从自然语言提示生成模型2026 尼泊尔洪水制图23:14灾害响应全流程查找、查看、对比开放影像构建前后对比滑动地图、3D 地形探索、Overture 建筑足迹提取与导出云原生 GIS 工作流网络研讨会1:07:28COG、GeoParquet、PMTiles、DuckDB 与 WebAssembly 如何协同插件生态、跨平台构建与 GeoAI 集成的项目总览影像地理配准15:35放置地面控制点、选择变换方法、读取逐点与 RMS 残差、导出 GeoTIFF、处理 NoData 透明并用滑动工具对比底图速查与收尾按任务选入口三个高频问题你的任务入口文档快速出第一张图添加数据 → 矢量图层用户指南加载远程大数据集添加数据 → GeoParquet / FlatGeobuf / 栅格图层添加数据缓冲、叠加、连接处理 → GeoLibre 工具箱 → 矢量处理工具DEM 派生产品处理 → GeoLibre 工具箱 → 栅格处理工具SQL 查询与结果上图处理 → SQL 工作区SQL 工作区发布与嵌入网页项目 → 分享...嵌入与分享哪些操作必须桌面应用项目文件读写、本地 MBTiles 与栅格读取、侧车承担的转换矢量转 FlatGeobuf / 转 PMTiles、栅格转 COG与 rasterio 栅格处理、等高线和按掩膜裁剪都属于桌面端专属Whitebox 工具箱是例外——1000 多个工具以 WebAssembly 在浏览器运行加载远程数据、样式、属性表、DuckDB 查询与大部分转换在浏览器端即可完成。缓冲引擎怎么选客户端 Turf.js 零配置但按地理坐标计算大范围要精确公制距离就选两个 GeoPandas 引擎之一——它们缓冲前先重投影。桌面应用用侧车其他任何环境包括 Web 构建可用 PythonPyodide。嵌入参数怎么组合六个参数自由拼maponly纯图、layoutviewer只读浏览、layoutcompact图标工具栏、toolbarnone与panelsnone局部隐藏、themedark深色加载只读探索选layoutviewer插图选maponly。COG 序列怎么动起来配时间滑块插件做时间动画参见数据集成。从添加一个图层到成果嵌入网页整条链路都在你自己的环境里跑完数据始终留在自己手里。建议先在在线版把前四个阶段走一遍需要本地文件或侧车的环节再切到桌面应用按 用户指南 的参考页补齐细节即可。【免费下载链接】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），仅供参考
