GeoLibre 完整实操指南:五步从第一张地图到分享嵌入,跑通云原生 GIS 全流程 📅 发布时间:2026/9/20 20:51:01 👁 浏览次数: 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 平台能把地理空间数据加载、分析、加工和发布一气呵成并且直接在浏览器里运行数据不离开你的机器。本指南面向第一次接触它的人带你走完一条完整工作流。能力全景先看 GeoLibre 能帮你做什么模块解决什么问题对应章节添加数据Add Data本地或远程 URL 加载矢量、栅格、瓦片数据第 2 章样式面板Style配色、不透明度、分级统计图choropleth第 2 章属性表Attribute Table查看、筛选、探索、导出要素属性第 2 章处理工具箱Processing缓冲、叠加、地形产品、格式转换第 3 章SQL 工作区SQL Workspace用 DuckDB Spatial SQL 查询并上图第 4 章分享与嵌入Share / Embed发布公开链接、嵌入网页、运行时控制第 5 章Whitebox 工具箱1000 地理处理工具WebAssembly 浏览器内运行第 6 章动手之前环境与安装差异在线版浏览器构建版web.geolibre.app打开即用本章绝大多数操作都能在这里完成。桌面应用Windows、macOS、Linux 都有安装包。以下操作只能在桌面端做打开/保存本地项目文件、读取本地 MBTiles 和栅格文件、Python 侧车sidecar工具rasterio 栅格处理、栅格转 COG、矢量转 FlatGeobuf/PMTiles 等。不用装任何东西的例外Whitebox 地理处理工具箱的 1000 工具以 WebAssembly 形式跑在浏览器里在线版同样可用。多个章节共用的示例数据是一份公开的世界国家 GeoParquet 文件后续会反复用到https://data.source.coop/giswqs/opengeos/countries.parquet小贴士先用在线版把整条流程跑一遍碰到需要本地文件再装桌面应用能省不少时间。第一张地图从空工作区到可检查的样式化地图目标几分钟后得到一张有数据、有样式、属性可查的地图。打开应用在线版直接开浏览器桌面端启动应用。你看到的是一张底图 空的图层面板Layers panel。加一个图层打开Add Data → Vector Layer在矢量 URL 输入框里粘贴上面那份国家数据地址点Load。地图上出现各国边界图层面板多出countries图层。样式化在图层面板选中countries展开右侧样式面板调整Fill color填充色、Outline color轮廓色、Fill opacity填充不透明度。想做分级统计图把Style type设为Graduated选一个数值字段如POP_EST或GDP_MD_EST再定Classes类别数、Scheme、Colormap最后点Apply style type。检查数据点状态栏的Attribute table展开属性表选中countries加载记录。可以按列排序、在Search attributes里搜关键词选中行会在地图高亮对应要素点Explore一次性查看每个字段的类型、完整度和值分布。再给图层打开Identify features点击地图上的国家就能在弹窗看它的属性。保存或分享桌面端用Project → Save写出一个.geolibre.json项目文件任何环境都能用Project → Share上传拿到公开链接见第 5 章。可观察的结果地图上是按数值着色的国家多边形属性表能查到 200 多条记录点击国家弹属性。接下来去哪把数据换成远程云原生格式让不用先下载文件成为常态 → 第 2 章。数据进来加载云原生格式并转换本地文件目标从远程 URL 流式加载 GeoParquet、FlatGeobuf、COG并把本地数据转成云原生格式。远程 GeoParquet打开Add Data → GeoParquet Layer粘贴 URL 后勾选Stream GeoParquet (no copy)再Load。这个开关让应用通过 HTTP range 请求原地查询文件而不整体拷贝进内存对行按空间排序如 Hilbert 序的大文件效果最好——只抓取当前视图相关的 row group。底层逻辑可以看 duckdb-vector-loader.ts 的按需加载实现读取管线的元数据与坐标系也有专门的测试覆盖geoparquet-metadata.test.ts、geoparquet-crs.test.ts。FlatGeobufAdd Data → FlatGeobuf Layer输入.fgb地址加载。该格式自带空间索引GeoLibre 在格式允许时只抓取当前视图内的要素。COG 栅格Add Data → Raster Layer输入 COG.tifURL 加载之后在样式面板调亮度、对比度、饱和度、色相。本地 GeoTIFF/COG 也可以直接拖到地图上。本地转云原生Processing → GeoLibre Toolbox → Conversion下选工具。其中Vector to GeoParquet、CSV to GeoParquet在浏览器内由 DuckDB-WASM 完成对应 duckdb-processing.ts 的浏览器内处理管线Vector to FlatGeobuf、Vector to PMTiles、Raster to COG走 Python 侧车桌面端。验证把刚生成的 GeoParquet 重新加回地图确认渲染正常。⚠️注意流式模式对未排序的大文件收益有限此时还是会把文件读进来。想发布大文件先用转换工具写出 Hilbert 序的 GeoParquet 再分享。接下来去哪数据进来了对它做几何和地形加工 → 第 3 章。数据加工矢量分析与地形分析矢量缓冲 叠加 导出目标缓冲一个图层与另一图层叠加导出结果。准备输入至少一个矢量图层做叠加需要两个例如点/线图层 一个裁剪用多边形图层。缓冲Processing → GeoLibre Toolbox → Vector → Buffer设Input layer、Distance和Units公里/米/英里选Engine后RunClient (Turf.js)浏览器内跑零配置但按地理坐标缓冲Sidecar (GeoPandas)Python 侧车跑投影感知桌面端Python (Pyodide)浏览器里跑同一套 GeoPandas 代码结果与侧车一致运行时首次使用下载一次。叠加同菜单下选工具。Clip保留输入中落在叠加点内部的部分保留属性Intersection只留重叠区Difference减去叠加点区域Union合并两个多边形不保留属性Spatial join按空间关系把连接图层属性挂到输入要素上Attribute join按关键字段挂接属性表一对一第一个匹配胜出可选内连接/左连接。检查与复跑在结果图层上开属性表核对输出Processing → History记录每次运行可一键重跑并复制等价 Python 代码。⚠️注意同一个处理菜单下有两个Vector——分隔线上方的Processing → Vector是 Whitebox 目录的矢量类别本流程用的是Processing → GeoLibre Toolbox → Vector别点混了。小贴士大范围要精确的公制距离时用两个 GeoPandas 引擎之一缓冲前先重投影网页端选Python (Pyodide)即可不必装侧车。地形从 DEM 派生山体阴影、坡度与等高线目标一张高程栅格DEM进三个地形产品出。加载 DEM以栅格图层方式添加 GeoTIFF/COG 高程数据。栅格工具是文件进、文件出本地或可访问的路径最稳。山体阴影Processing → GeoLibre Toolbox → Raster → Hillshade选 DEM按需调方位角azimuth、高度角altitude、z 因子运行后把浮雕栅格放到其他图层下方上方图层 混合模式 设Multiply——浮雕能透过颜色显现而不是像降低不透明度那样把两层一起洗淡。坡度与坡向同菜单下的Slope算陡峭程度Aspect算最陡坡向的罗盘方向。输出用色带colormap上色从控件菜单打开Colorbar显示数值标尺。等高线Raster → Contour选 DEM 并设interval等高线间距即线间高差生成的是矢量图层可像矢量一样标注和上色。裁剪到研究区Clip by extent边界框浏览器可跑或Clip by mask layer矢量掩膜仅侧车。⚠️注意Hillshade、Slope、Aspect 都有Client (browser)引擎在线版零安装可跑Contour和Clip by mask layer只有侧车引擎需要桌面应用。每个工具顶部有引擎选择器大栅格或地理坐标系下的地形建议优先侧车。接下来去哪不想一步步点菜单用 SQL 把同样的分析写成一条查询 → 第 4 章。结果输出用 SQL 查询并导出目标从Processing → SQL Workspace打开 SQL 工作区DuckDB-WASM 驱动浏览器/桌面均可查完直接上图或导出。查已加载的图层每个矢量图层都是一张表。载入国家图层后运行SELECT NAME, CONTINENT, GDP_MD_EST FROM countries ORDER BY GDP_MD_EST DESC LIMIT 10;直接查远程文件工作区会识别FROM子句里的裸 URL 并自动包上对应读取器通过 range 请求流式读取无需先加载标准 DuckDB CLI 里你得显式写read_parquet(https://...)。这条能力与 duckdb-vector-loader.ts 同源防护边界由 duckdb-vector-guard.test.ts 覆盖。SELECT COUNT(*) AS n FROM https://data.source.coop/giswqs/opengeos/countries.parquet;用空间函数空间扩展已加载ST_*函数全可用。例如算面积并保留geom以便结果上图EPSG:4326 下ST_Area单位是平方度要平方千米用ST_Area_Spheroid(geom) / 1e6。结果上图查询返回几何列时点Add as layer可选命名结果图层支持识别、选择和属性表可一次加多个。导出Add as layer旁边的Export CSV与Export GeoParquet按钮直接导出查询结果。小贴士不知道字段名就先跑DESCRIBE SELECT * FROM 你的文件URLSample queries菜单有可运行的示例查询History可重跑之前的查询。接下来去哪分析做完了把地图变成一个链接或网页组件 → 第 5 章。发布与嵌入把地图变成链接和网页组件目标拿到一个公开项目链接并能嵌入任意网页。配置分享令牌一次性Settings → Environment Variables把你在 share.geolibre.app 后台设置 → API 令牌里创建的令牌粘贴到Share.GeoLibre API token字段。分享项目先把地图调到你希望观众落地的视图然后Project → Share...确认标题上传。返回一个指向.geolibre.json的公开 URL形如https://share.geolibre.app/you/my-map.geolibre.json。打开分享的地图任何人把项目地址作为url参数传给在线版即可打开如https://web.geolibre.app/?url你的项目地址。嵌入网页用iframe 嵌入参数控制外壳参数可组合参数效果maponly只留地图其余全隐layoutviewer只读地图图层/视图/控件/底图/搜索都在修改入口隐藏layoutcompact细长的纯图标工具栏toolbarnone隐顶部工具栏保留面板和状态栏panelsnone隐侧边与底部面板保留工具栏themedark加载时强制深色主题运行时驱动URL 参数只在加载时生效一次。要持续对话飞到指定要素、监听图内操作装类型化客户端npm install geolibre/embed实现见 packages/embed/契约由 embed-api.test.ts 和 embed-client.test.ts 验证。注意运行时 API 只在把你的页面源加入白名单的自建部署上生效官方在线版没有开放白名单。⚠️注意分享文件只存项目本身图层、样式、插件状态、视图绝不上传你的数据文件。读取本地文件的图层会在分享前被对话框列为缺失——这类图层的数据需要你自己找地方托管。接下来去哪还有 1000 工具和一批进阶玩法值得看 → 第 6 章。进阶与生态视频教程、插件与跨端视频教程收录在 docs/tutorials/videos.md按时间排列、均带章节和总结涵盖 1.0 全功能介绍、浏览器内 Whitebox 地理处理、免费灾害卫星影像、建筑足迹规整、GeoLens 自托管数据栈、Model Builder AI 助手生成工作流、尼泊尔洪水灾害响应全流程、云原生工作流网络研讨会、影像地理配准等。Whitebox 工具箱1000 工具按类别组织矢量 313、栅格 256、遥感 154、水文 100、地形 99、LiDAR 65、转换 49、网络 26 等任一工具都可用?toolURL 参数深链预填表单。插件生态插件市场提供 Time Slider栅格序列时间动画、Vantor Open Data免费卫星影像、Atmosphere Effects深空背景等机制见 docs/plugin-api.md。跨端同一个工作区还有 Android、iOS 原生应用、Chrome 扩展在任何网页把数据集直接丢进 GeoLibre、Jupyter 里的 Python 包python/与 R 包。想从源码跑见 docs/getting-started.md。答疑与选型常见问题哪些步骤必须桌面端打开/保存项目文件、读本地 MBTiles 与栅格、侧车工具等高线、按掩膜裁剪、栅格转 COG 等转换。Whitebox 工具箱不在其列——浏览器 WASM 就够。缓冲该选哪个引擎小范围快速预览用Client (Turf.js)大范围要精确公制距离用Sidecar (GeoPandas)桌面或Python (Pyodide)任意环境。COG 序列怎么动起来装 Time Slider 插件做时间动画参考 docs/user-guide/data-integrations.md。嵌入参数能随便组合吗能maponly、layout、toolbar、panels、theme自由叠加。按场景选起点只想快速出图 → 第 2 章第一张地图。面对远程大数据集Parquet / COG / PMTiles→ 第 3 章数据进来。做几何操作缓冲、叠加、连接→ 第 4 章矢量部分。从 DEM 派生地形产品 → 第 4 章地形部分。用 SQL 分析并上图 → 第 5 章。发布与嵌入 → 第 6 章。收尾整条主线其实就四件事数据进来本地或远程 URL、数据加工菜单驱动的几何/地形工具或一条 SQL、结果输出属性表、SQL 导出、转换工具、发布分享链接与 iframe 嵌入。建议先在浏览器里零安装走完一遍再装桌面端解锁本地文件与侧车工具。想深入某个环节docs/user-guide/ 下有逐项参考docs/tutorials/ 保留着官方原版教程可对照练习。【免费下载链接】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),仅供参考