mirror of
https://github.com/opengeos/GeoLibre.git
synced 2026-11-04 10:43:36 +00:00
Qiusheng Wu
38ed979d3b
* docs: review the docs against the code and fix drift Check every docs page against the current code and correct what no longer matches: menu paths and labels, plugin placement (most plugins now open in a docked panel), Cesium ion tokens being optional, desktop OAuth sign-in for sharing, browser project save/open, project schema fields, server and collaboration endpoints, Python and MCP APIs, and stale paths in the source-code deep dives. Fix the Spatial SQL tutorial's ST_Area_Spheroid query, which needs ST_FlipCoordinates for lat/lon axis order. Document the Settings sections that were listed but never described (Language, Appearance, Interface, Geocoding, AI Providers), and add the USGS NLDI and ArcGIS feature editing pages to the nav. * docs: keep the NLDI and ArcGIS editing pages out of the nav * Address CodeRabbit review feedback - collaboration.md: give both snapshot-cap defaults, 10 MB for the relay and 1 MB in the Docker Compose setup. - features.md, cesium-renderer.md: without an Ion token the globe still gets terrain from keyless Terrarium elevation (or a configured COG), not a bare ellipsoid (cesium-engine.ts enableWorldTerrain). * Address CodeRabbit review feedback - project-format.md: type blankBackgroundColor and selectedLayerId as string | null, matching ProjectFile in packages/core/src/types.ts.
2.7 KiB
2.7 KiB
Cloud-Native Data
GeoLibre is built for cloud-native geospatial formats: GeoParquet and FlatGeobuf for vector, Cloud-Optimized GeoTIFF (COG) for raster, and PMTiles for tiles. This tutorial loads them from remote URLs and converts a local dataset.
Load a remote GeoParquet
GeoParquet is a compressed, columnar vector format that reads well over HTTP.
- Open Add Data → GeoParquet Layer (or Vector Layer).
- Enter a GeoParquet URL, for example:
https://data.source.coop/giswqs/opengeos/countries.parquet - To avoid copying a large file into memory, enable Stream GeoParquet (no copy), which queries it in place with HTTP range requests. This works best for large remote files whose rows are spatially sorted (for example, Hilbert order, as written by GeoLibre's own Conversion tools), so only the relevant row groups are fetched.
- Click Load.
Load a FlatGeobuf
FlatGeobuf is a streaming-friendly vector format with a spatial index.
- Open Add Data → FlatGeobuf Layer.
- Enter a
.fgbURL and load it. GeoLibre fetches only the features in view where the format allows.
Load a COG
A Cloud-Optimized GeoTIFF is a regular GeoTIFF organized so clients can read just the tiles they need.
- Open Add Data → Raster Layer.
- Enter the URL of a COG (
.tif) and load it. You can then adjust brightness, contrast, saturation, and hue in the Style panel.
!!! tip "Drag and drop" You can also drag a local GeoTIFF or COG onto the map to add it as a raster layer. See Adding Data.
Convert local data to cloud-native
Use Processing → GeoLibre Toolbox → Conversion to write cloud-native files. See Processing Tools.
- In the browser build, Vector to GeoParquet and CSV to GeoParquet run on DuckDB-WASM, and Vector to FlatGeobuf, Vector to PMTiles, and Raster to COG run on WebAssembly (
geolibre-wasm), so none of them needs a sidecar. - The desktop app runs these on the Python sidecar instead, which reads more input formats (Raster to COG in the browser reads GeoTIFF only) and preserves data types the browser writers cannot.
For example, to publish a local GeoJSON as GeoParquet:
- Open Processing → GeoLibre Toolbox → Conversion → Vector to GeoParquet.
- Choose the input file and an output path.
- Run the conversion, then add the resulting GeoParquet back to the map to verify it.
Next steps
- Query these formats directly in Spatial SQL; the SQL Workspace reads Parquet, CSV, JSON, and GeoJSON from URLs.
- Animate a time series of COGs with the Time Slider plugin. See Data Integrations.