A Python web application for querying and browsing WhereOnEarth (WOE) geographic data. WOEplanet is a searchable and linkable index of every single WOEID published, derived from the Creative Commons licensed Yahoo! GeoPlanet data dumps.
WOEplanet is Where On Earth (AKA WOE, also AKA GeoPlanet) data, smushed up with coordinate and boundary data from Flickr Shapes, Quattroshapes and Natural Earth Data (that's fancy talk for polygons) as well as concordances and other metadata rescued from woe.spum.org before it died and went offline.
The WOEplanet Spelunker is a Starlette based web app, hosted at woeplanet.org for visualising, poking into and searching the WOEplanet data.
This Spelunker is a spiritual successor to woedb by Aaron Straup Cope, and draws inspiration from the Who's On First Spelunker.
Download the WOEplanet SQLite databases (main database and geometry database) from the WOEplanet data releases; these are provided as per place type SQLite databases and SpatiaLite databases for the geometries.
Copy [.env.template](./.env.template) to .env` (it should work as is).
Put the downloaded, still compressed, databases in $WOEPLANET_DOWNLOADS_DIR.
Use the helper script in the woeplanet-build repo to combine the per place type databases into a single places database and a single geometries database and put these in $WOEPLANET_STORAGE_DIR.
Use the provided docker-compose.yml file, adjusting it to your needs and setup.
docker compose up -dThat's it. Point your web browser at http://localhost:8080 and happy spelunking.