Skip to content

OvertureMaps/awesome-gers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Awesome GERS

Awesome

A curated list of resources for the Global Entity Reference System (GERS), Overture Maps Foundation's open framework for assigning stable, persistent UUIDs to geographic entities.

GERS solves the "conflation tax": the recurring cost of re-matching your dataset to every new data release. Every feature in Overture carries a GERS UUID. Bridge files map those UUIDs to source IDs (OSM, Microsoft, Meta, etc.), so any dataset linked to GERS once stays linked across releases. Think of it as a persistent join key for the physical world.

Reached General Availability June 25, 2025. In OGC community standard process as of early 2026.


Contents


Official Documentation

  • GERS Overview: Product landing page covering what GERS is, the partner ecosystem, and entry points to technical docs.
  • What is GERS?: Core technical reference covering IDs, changelogs, the registry, and bridge files.
  • GERS Tutorial: Step-by-step guide to querying Overture via GERS IDs using DuckDB.
  • GERS Registry: Queryable Parquet index of all stable GERS IDs across every Overture release (S3/Azure).
  • Bridge Files: Per-release join tables mapping GERS UUIDs to source dataset IDs (OSM, Meta, Microsoft, Esri, and more).

Data

Overture Core Releases

All six themes are published monthly under open licenses and are fully GERS-tagged. Access via s3://overturemaps-us-west-2/release/ or Azure equivalent.

Bridge Files (open, shipped with each release)

Pre-built cross-walk tables at s3://overturemaps-us-west-2/bridgefiles/<release>/. Current coverage:

Source Theme(s)
OpenStreetMap Buildings, Places, Divisions, Transportation
Microsoft ML Building Footprints Buildings
Meta Places Places
Esri Community Maps Buildings, Divisions
PinMeTo Places
geoBoundaries Divisions
Instituto Geográfico Nacional (Spain) Buildings

Third-Party GERSified Datasets

  • Regrid Parcel × GERS Bridge: 11M+ Overture place IDs matched to 8M+ U.S. parcels; three-field join table (ll_uuid, gers_id, geoid). Available to Regrid bulk data customers.

Tools and Libraries

Official

  • overturemaps-py: Python CLI + library. Includes a gers <UUID> subcommand that queries the GERS Registry and returns a feature as GeoJSON or GeoParquet.
  • match-inspector: Local Flask/Folium web app for manually reviewing building conflation candidates before GERS ID assignment.
  • osm-pbf-parquet: Rust CLI converting OSM PBF → Parquet; feeds the OSM-to-GERS conflation pipeline.
  • overture-tiles: Generates PMTiles from Overture GeoParquet for map visualization and QA of GERS-identified features.

Community

  • overture-gers-tiles-example: Planetiler-based demo joining Overture Places (GERS) to Regrid parcel zoning data to produce enriched vector tiles; Dallas, TX case study. (Live map)
  • OvertureMapsDownloader: Python/DuckDB downloader with a browser app (DuckDB-WASM) for client-side queries against Overture Parquet including GERS columns.
  • overtureR: R package loading Overture datasets (with GERS ID columns) as dbplyr/sf data frames.
  • Fused GERS UDFs: Serverless UDFs exposing HTTPS endpoints to spatially join any polygon dataset to Overture building GERS IDs; exploits H3 encoding for efficient filtering.
  • overture-geocoder: Serverless geocoder on Cloudflare Workers backed by Overture Maps data; supports forward/reverse lookup and direct GERS ID resolution via edge-cached SQLite shards (Rust + Python).

Platform Integrations

  • CARTO + Databricks: Overture data (all six themes, GERS IDs included) published as Databricks Marketplace listings; enables direct SQL joins on GERS IDs without ETL.
  • Esri ArcGIS / Living Atlas: Workflow for enriching user data with GERS IDs inside ArcGIS Online and ArcGIS Pro using Living Atlas Overture layers.
  • Wherobots (Apache Sedona): Cloud-native access to Overture GeoParquet via Apache Sedona/Spark; native GERS support for large-scale spatial joins.
  • TomTom Global Entity Matcher (GEM): Commercial deep-learning conflation service that maps any client dataset to GERS IDs.
  • Precisely Data Link: Pre-built link tables connecting PreciselyID, D&B DUNS numbers, Regrid property IDs, and GeoX IDs to GERS Places, Addresses, and Buildings.

Tutorials and Guides

Talks and Podcasts

Articles and Blog Posts

Case Studies

Standards and Governance


Contributing

Contributions welcome. Please open a PR with a short description of what you're adding and why it belongs here. Links should be to specific resources (not homepages), publicly accessible, and meaningfully related to GERS: not just Overture in general.

About

🗺️ A curated list of awesome resources related to GERS (Global Entity Reference System) data, tools, and more!

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors