geolens-io /geolens

Self-hosted geospatial data catalog with semantic search (pgvector), OGC/STAC APIs, and map builder. Built on FastAPI, PostGIS, React, and MapLibre.

★ 300⑂ 46👁 2⑃ 2,610● 1,275▤ 64
PythonApache-2.0Created 2026-03-22getgeolens.com
下载:v1.31.0v1.31.0 ↓1.31.02026-11-10
+0
日增长
300
stars
46
forks
2
watchers
2,610
prs
1,275
issues
64
releases

README

GeoLens


  A self-hosted spatial data catalog and map builder that keeps track of where every dataset came from.



  Live demo ·
  Install ·
  Documentation ·
  Connect QGIS or code ·
  Discussions




English · Español · Français · Deutsch · 简体中文










  
    
      
      
    
  
  
  Manhattan's buildings at their surveyed roof heights, colored by construction era, with the subway network. Browse the demo's maps.


GeoLens is for teams whose spatial data is spread across file shares, PostGIS databases, web
services and STAC catalogs. It puts that data in one searchable catalog, records where each
dataset came from and checks whether the source is still current. Teams build and share maps in
the browser, and QGIS, scripts and AI agents read the same data through OGC API and STAC. It runs
on your own servers with Docker Compose, sends no telemetry and is licensed under Apache 2.0.

The demo needs no install or account; sign in with Google, GitHub
or Microsoft to use the map builder. Demo data may be wiped at any time.

 A closer look








Search by meaning: "where storms hit the coast" finds hurricane tracks and coastal exposure layers.






Each dataset has a page with its metadata and source, plus a map preview when it has an extent.








Before you import a service layer, GeoLens previews its columns and first rows.






Each replacement is recorded in the history, and you can restore the previous version.








Layers render as points, symbols, heatmaps or clusters, and the ramp list can be limited to colorblind-safe ones.






3D terrain from your own elevation data, here the Matterhorn from swissALTI3D lidar.








Sentinel-2 scenes referenced from a STAC catalog. The imagery stays where it is and is tiled on request.






Keep a map to yourself, open it to your team, or make it public with a link and embed code.








The admin overview shows service health next to dataset and storage totals.






Viewer, editor and admin roles, with each capability switched on or off per role.




 How it fits together

mermaid
flowchart LR
    subgraph IN ["Bring data in"]
      F["FilesGeoPackage · Shapefile · GeoParquetGeoTIFF · COPC · 3D Tiles"]
      DB["Existing PostGIS tables"]
      SVC["ServicesArcGIS · WFS · OGC API Features"]
      ST["Remote STAC assets"]
    end
    subgraph GL ["GeoLens"]
      CAT["Catalogsearch · metadata · provenance"]
      MB["Map builderstyles · 3D · analysis · stories · dashboards · sharing"]
      STD["Open APIsOGC API · STAC · DCAT · tiles"]
    end
    subgraph OUT ["Use it anywhere"]
      WEB["Browsers and embeds"]
      GIS["QGIS · ArcGIS · CesiumJS"]
      CODE["curl · Python · TypeScript · DuckDB"]
      AG["AI agents via MCP"]
    end
    F & DB & SVC & ST -- CAT
    CAT -- MB -- WEB
    CAT -- STD -- GIS & CODE & AG


 One catalog for scattered data

- Upload Shapefile, GeoPackage, GeoJSON, GeoParquet, FlatGeobuf, KML/KMZ, zipped File
  Geodatabase, CSV, Excel or GeoTIFF (converted t

Top issues

Discussions

Latest release

v1.31.0 v1.31.0 2026-11-10
An instance on 1.30.1 moves to 1.31.0 with one additive migration (0103,
which allows the database source format), and releases back to 1.29.2 keep
serving while it runs. SQL Server import stays off until an operator sets
DATABASE_SOURCES. Overlays must declare EXTENSION_API_VERSION 23.

 Added
- The aggregate endpoint takes blank_text_as_null for value_counts and group_by, counting a text column's empty strings with its NULLs. Dashboard widgets use it, so a category stored as both reads as one "(no value)" row. Whitespace-only text keeps its own key.
- Database connections: an operator lists 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON