Runnable examples

GeoLens is a self-hosted spatial data hub.

One place to catalog, search, map and analyze your spatial data. It publishes all of it through OGC API Features and Records, STAC, vector tiles and raster tiles. The integration is a URL.

So the client library never has to know what GeoLens is. Every browser and Python example here is one file that reads the public demo anonymously, with no key and no build step. Most need no GeoLens library at all; the two marked SDK use one to show what the catalog knows that a URL cannot. The CLI card is the exception: publishing writes to a catalog, so it runs against your own instance with a credential.

GET /api/collections/{id}/items GeoJSON features

GET /api/tiles/{table}/{z}/{x}/{y}.pbf Vector tiles

GET /raster-tiles/{id}/tiles/{z}/{x}/{y}.png Raster tiles

See what GeoLens itself builds

Maps composed and styled in the GeoLens map builder, then published on the public demo. All four open without an account.

Restless Earth. Seven layers: 30 days of USGS earthquakes, 6,000 years of deadly eruptions, plate boundaries, ETOPO relief.
Manhattan - A Century of Skyline. Every building extruded to its surveyed roof height, coloured by the era it was built.
The Matterhorn in 3D. 62 cloud-optimized GeoTIFFs of swisstopo 2 m lidar mosaicked into one VRT, with the climbing routes from OSM.
New York From Orbit. Sentinel-2 scenes read by reference from the AWS open-data archive, nothing downloaded.

Start where you work

CI replays every "Try live" card against the live demo on every change and once a week; the runs are public.

The gallery is built by a script, so it needs JavaScript; the same table in the README lists every example with a link to run it.

Run your own

The demo these examples read is not yours. One command starts an instance that is, with Docker Compose; open http://localhost:8080, then point any example at it by changing the one constant at its top.

curl -fsSL https://getgeolens.com/install.sh | sh

Install guide · GeoLens on GitHub