README.md

January 22, 2026 ยท View on GitHub

HOTOSM Logo

OpenAerialMap

OpenAerialMap is an open service to provide access to a commons of openly licensed imagery and map layer services.

Release Version

CI/CDDeploy
Tech StackReact Postgres Kubernetes Docker
Code StyleBackend Style Frontend Style pre-commit.ci status
CommunitySlack All Contributors
Other Infodocs license-code

A revamp of OpenAerialMap, originally developed back in the 2010's.

Components

Frontend Parts

The frontend prototype was developed as part of the revamp deliverables.

The idea has since morphed into stac-map. We should probably migrate to that and consolidate efforts within the community.

Main parts:

  • Main OpenAerialMap landing page, with links to different parts and docs / info.
  • Documentation site with tutorials etc.
  • The uploader site. This should be HOT themed, with shared auth and consistent look / style.
  • stac-browser for a catalog search from the backend STAC.
  • stac-map to display the global coverage pmtiles layer (giving indication of where imagery is currently present), plus map-based search of the STAC once the user zooms into their area of interest (+ filtering based on various criteria).

Contributing ๐Ÿ‘๐ŸŽ‰

We would really welcome contributions for:

  • Backend Python development
  • Frontend Typescript development
  • Documentation writers
  • UI / UX designers
  • Testers!

Please take a look at our Documentation and contributor guidance for more details!

Reach out to us if any questions!

Roadmap

StatusFeatureDescriptionVersionEffort (person-months)
โœ…New OAM backend based on STACCore backend using pgSTAC, FastAPI STAC endpoints, and TiTiler integration.v2.0-alpha1.5
โœ…Kubernetes-based deployment of eoAPI for OAM STACA scalable, open-source infrastructure to support the growing volume of imagery hosted and indexed in OAM.v2.0-alpha1.0
โœ…STAC extension for OAM and metadata ingested from old APISTAC is the industry standard to describe geospatial information - including imagery - so it can be more easily indexed, discovered, and worked with. This extension aligns legacy OAM metadata with STAC.v2.0-alpha1.5
โœ…Revamped global mosaicThe global tiled mosaic of OAM imagery (previously available from Kontur) has been redesigned to use a combined approach: visualize footprints at lower zoom levels, and dynamically switch to full-resolution imagery at higher zoom levels.v2.0-alpha0.5
โœ…Prototype frontend based on STACThis initial prototype lays the foundation for the new frontend, enabling rich interactions with available imagery, dynamic filtering, advanced search, and an overall modern user experience on the OAM platform.v2.0-alpha1.0
โœ…Documentation sitePublic docs with setup, endpoints, and usage guides for API, mosaic/TMS, and frontend.v2.0-alpha0.5
๐Ÿ”„New frontend feature parity with old frontendFeatures from the old Node.js frontend are being implemented in the new OAM Browser to ensure continuity in user experience and functionality.v2.02.0
๐Ÿ“…Improvements to the STAC catalog searchAllow users to search across the full STAC metadata, beyond the basic set of elements currently supported in OAM.v2.11.5
๐Ÿ“…Preset + advanced filteringImprove user experience and efficiency by creating preset filters (e.g. all imagery for the selected AOI collected in the last week) and advanced filtering to find specific imagery.v2.11.5
๐Ÿ“…Migrate frontend to stac-mapMove the UI to the community stac-map component (OAM theme) to reduce maintenance while keeping feature parity.v2.11.5
๐Ÿ“…Cross-catalog search and displayDevelop automations to harvest external STAC catalog metadata and cache previews, enabling faster, seamless display of available imagery in a unified OAM Browser interface.v2.21.0
๐Ÿ“…Better visualization of imageryImprove how imagery distribution and density are visualized in the OAM Browser, so users can quickly see what is available and what the imagery looks like before downloading.v2.20.5
๐Ÿ“…Dynamic tile creationProvide dynamic Tile Map Service (TMS) generated on the fly using TiTiler, so imagery can be easily used in JOSM/iD and other mapping software.v2.22.0
๐Ÿ“…New user management and APICreate a system for user accounts, allowing drone pilots and satellite providers to log in (via OSM OAuth and Google), manage the imagery they have uploaded (delete, rename, etc.), and see contribution statistics.v2.34.0
๐Ÿ“…New uploader API & UIDevelop an efficient web application that allows users to upload very large imagery files from their computer or from cloud services like Google Drive or Dropbox. This is critical to remove contribution barriers, since many imagery files are too big for the current uploader.v2.34.0
๐Ÿ“…Catalog expansionAdd additional STAC catalog ingestion workflows by engaging more providers, and create ingestion processes to โ€œmapโ€ publicly available STACs to the OAM metadata schema. This will significantly expand the amount of imagery available through OAMโ€™s unified discovery interface.v2.42.0
๐Ÿ“…Integration with ODMDevelop a plugin for OpenDroneMap to allow drone pilots to publish imagery directly to OAM (without having to download the GeoTIFF and manually upload it).v2.42.0
๐Ÿ“…Imagery and user statisticsProvide rich user and data statistics to foster the open imagery community and more clearly visualize growth and usage over time.v2.42.0
๐Ÿ“…Support for multispectral and non-optical imageryAllow users to upload more advanced imagery formats and non-optical data that can be rendered and visualized alongside common RGB imagery.v2.52.0
๐Ÿ“…Support for DEMsAdd capabilities to upload Digital Elevation Models (DEMs) and 3D point clouds - common byproducts of drone mapping - that can be used for risk modeling and humanitarian mapping (e.g. DTMs for flood modeling).v2.52.0