Awesome GERS

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

• Awesome GERS
  • Contents
  • Official Documentation
  • Data
  • Tools and Libraries
  • Platform Integrations
  • Tutorials and Guides
  • Talks and Podcasts
  • Articles and Blog Posts
  • Case Studies
  • Standards and Governance
  • Contributing

---

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.

• Overture on AWS Open Data: 64M+ places, 2.6B+ buildings, 447M+ addresses, 321M+ road segments: all carrying GERS UUIDs.

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

• GERS Workshop Module: Official hands-on lab: querying GERS IDs, joining bridge files, querying the changelog, and enriching external datasets: all in DuckDB. Runnable in GitHub Codespaces.
• Conflating Overture Places with DuckDB, Ollama, and Embeddings: Detailed walkthrough matching a restaurant inspection dataset to Overture Places using DuckDB spatial joins, string similarity, and LLM embeddings. Referenced in official Overture GERS docs.
• Mapping GERS IDs to US Census FIPS Codes: DuckDB spatial join enriching GERS buildings with Census FIPS codes; canonical example of GERS as a cross-dataset join key.
• Enhance Your Data with GERS IDs (Fused): Spatially join any dataset to Overture buildings via a public Fused UDF endpoint; no backend required.
• GERSifying Overture Places (CARTO): End-to-end GERSification workflow in CARTO using an earthquake risk analysis as the use case.
• GERS in Wherobots: Step-by-step Wherobots notebook linking records across datasets using GERS IDs on Spark.

Talks and Podcasts

• SE Radio 694: Jennings Anderson & Amy Rose on Overture Maps: In-depth interview on GERS, stable IDs, dataset scale (4.2B features), and interoperability. November 2025.
• FOSS4G NA 2024: Overture Map Data: What, Why, & How: Recorded session by Steven Pousty and Jennings Anderson; GERS coverage starts around the data model section.
• FOSS4G 2024: Jennings Anderson (Overture/GERS): Belem talk on GERS enabling cross-dataset entity reference across organizations.
• Overture GA + Beyond AMA: Panel with Amy Rose, Jennings Anderson, Pascal Clarysse, and Marc Prioleau; GERS design rationale discussed at length. August 2024.
• Eliminating the Data Onboarding Tax (CARTO SDSC): Drew Breunig presents GERS as the solution to the recurring cost of geospatial data integration. December 2025.

Articles and Blog Posts

• Towards Standardizing Place: Drew Breunig's influential argument that GERS has a real shot at making "place" a stable data primitive.
• Eliminating the Conflation Tax (GeoBuiz 2025 recap): Framing piece from Overture on the problem GERS solves.
• Understanding Overture's Global Entity Reference System: Deep-dive on GERS components (reference map, changelogs, registry, bridge files) written at GA launch.
• The Battle for the Map: Long-form analysis of OSM community concerns around the OGC GERS standardization effort.
• SimonPoole's Diary: Persisting Your IDs: OSM community perspective on persistent IDs and the tradeoffs in the GERS approach.

Case Studies

• Addresscloud: Geospatial Risk Analysis at Scale: Insurance risk scoring of 300M building footprints using GERS; in production since March 2024.
• Precisely: Accelerating Data Integration: Pre-linked GERS IDs across Places, Addresses, and Buildings; turns months of conflation into instant ID joins.
• Regrid: Connecting Parcels and POIs: Nationwide US parcel-to-GERS bridge enabling enriched site selection analytics.

Standards and Governance

• opengeospatial/Overture-Maps-GERS: OGC Standards Working Group charter and draft GERS community standard documentation; 40+ supporting organizations.
• OGC Public Comment: GERS as an OGC Community Standard: RFC from February 2026 seeking adoption of GERS as a formal OGC standard.
• OvertureMaps/schema: Schema working group repo governing GERS ID format and Overture data schema design.

---

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.