DOCSEARCHbyAlgolia
Submit Docs

Overture Maps Data Documentation

repository·main·Indexed 22 days ago

https://github.com/overturemaps/data

Access large-scale, cloud-native geospatial datasets in Parquet format via Amazon S3 and Microsoft Azure. Includes details on the Overture Data Schema enhancements—such as GERS identifiers, bbox structs, and WKB geometry—and guidance on discovering releases using the SpatioTemporal Asset Catalog (STAC).

Tokens
574
Snippets
2
Records
3
Agent score
28%

What's inside Overture Maps Data

  1. Understand the Overture Parquet schema enhancements

    main

    The Parquet files follow the Overture Data Schema but include three specific technical enhancements for efficient querying and spatial operations:

    1. id column: Contains unique identifiers in the Global Entity Reference System (GERS) format.
    2. bbox column: A struct containing xmin, xmax, ymin, and ymax. This is designed to enable more efficient spatial queries when running SQL against cloud storage.
    3. geometry column: Encoded as WKB (Well-Known Binary), making the files compatible with GeoParquet standards.

  2. Discover Overture data releases using STAC

    main

    For authoritative release discovery, use the Overture STAC (SpatioTemporal Asset Catalog).

    Note: Previous discovery methods such as overture_releases.yaml, releases.json, and registry-manifest.json are deprecated and no longer maintained. Use the STAC catalog instead.

    https://stac.overturemaps.org/catalog.json

  3. Access Overture Maps data via S3 or Azure

    main

    Overture Maps data is provided in cloud-native Parquet format and is partitioned by theme and type. There is no single file for the entire planet; instead, you should access the data via the following cloud storage locations. Replace __OVERTURE_RELEASE__ with the specific release identifier you wish to access.

    Available Themes:

    • addresses
    • base
    • buildings
    • divisions
    • places
    • transportation
    #### Amazon S3 
s3://overturemaps-us-west-2/release/__OVERTURE_RELEASE/
  |-- theme=addresses/
  |-- theme=base/
  |-- theme=buildings/
  |-- theme=divisions/
  |-- theme=places/
  |-- theme=transportation/

#### Microsft Azure
https://overturemapswestus2.blob.core.windows.net/release/__OVERTURE_RELEASE/
 |- theme=addresses
 |- theme=base
 |- theme=buildings
 |- theme=divisions
 |- theme=places
 |- theme=transportation