Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 2 additions & 21 deletions .github/workflows/build-manifests.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
name: Build and publish releases artifacts
name: Publish redirect page

on:
push:
branches: main
schedule:
- cron: "0 1 * * *"

# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
Expand All @@ -18,7 +16,7 @@ concurrency:

jobs:
deploy:
name: Build and Deploy
name: Deploy
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
Expand All @@ -33,27 +31,10 @@ jobs:
with:
persist-credentials: false

- name: Set up Python 3.12
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version: "3.12"
pip-version: "26.2.2"

- name: Install dependencies
run: |
cd utils
pip install -r requirements.txt

- name: Build latest.ddb
run: |
cd utils
python3 fetch_releases_from_stac.py

- name: Copy output to publish directory
run: |
mkdir publish
cp 404.html publish/
cp utils/latest.ddb publish/

- name: Setup Pages
uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
Expand Down
39 changes: 0 additions & 39 deletions .github/workflows/test.yml

This file was deleted.

3 changes: 0 additions & 3 deletions .gitignore

This file was deleted.

3 changes: 2 additions & 1 deletion 404.html
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,8 @@ <h1>This resource has moved</h1>
The file you requested is no longer published here. Release discovery is
now handled by the
<a href="https://stac.overturemaps.org/catalog.json">Overture STAC catalog</a>
(SpatioTemporal Asset Catalog). For upcoming release dates, see the
(SpatioTemporal Asset Catalog), which also serves
<a href="https://stac.overturemaps.org/latest.ddb">latest.ddb</a>. For upcoming release dates, see the
<a href="https://docs.overturemaps.org/release-calendar.json">release calendar</a>.
</p>
<p>
Expand Down
3 changes: 0 additions & 3 deletions CODEOWNERS
Original file line number Diff line number Diff line change
@@ -1,5 +1,2 @@
# Default owners for everything in the repo
* @overturemaps/omf-public-reviewers

# Devops
/.github @lowlydba @overturemaps/omf-public-reviewers
82 changes: 50 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,42 @@
# Welcome to the Overture Maps Data Repo <!-- omit in toc -->
<p align="center">
<a href="https://overturemaps.org">
<img src="assets/overture-maps-foundation.png" alt="Overture Maps Foundation" width="450">
</a>
</p>

We welcome feedback about Overture Maps data in the [Discussions](https://github.com/OvertureMaps/data/discussions/new/choose). Feedback on the data *schema*, is best provided in the [Discussions in the *schema* repository](https://github.com/OvertureMaps/schema/discussions).
<h1 align="center">Overture Maps Data</h1>

## Overture Maps Data <!-- omit in toc -->
<p align="center">
Open map data in cloud-native Parquet, free to use under open licenses.
</p>

<p align="center">
<a href="https://docs.overturemaps.org">Docs</a> ·
<a href="https://docs.overturemaps.org/schema/">Schema</a> ·
<a href="https://stac.overturemaps.org/catalog.json">STAC</a> ·
<a href="https://docs.overturemaps.org/release-calendar.json">Release calendar</a> ·
<a href="https://github.com/OvertureMaps/data/discussions">Discussions</a>
</p>

A reference for where Overture Maps data lives, how it is laid out, and where to send feedback. For tutorials, guides, and examples, see [docs.overturemaps.org](https://docs.overturemaps.org).

## Contents <!-- omit in toc -->

- [Location](#location)
- [Amazon S3](#amazon-s3)
- [Microsoft Azure](#microsoft-azure)
- [Parquet Schema](#parquet-schema)
- [Release Discovery](#release-discovery)
- [Data Release Feedback](#data-release-feedback)
- [Feedback](#feedback)

### Location
## Location

Overture Maps data is available in cloud-native [Parquet](https://parquet.apache.org/docs/) format.
There is no single Overture "entire planet" file to download. Instead, the data is partitioned by both `theme` and `type` and made available on Amazon S3 and Microsoft Azure Blob Storage. Read more about Overture data and schema at [docs.overturemaps.org](https://docs.overturemaps.org).
Overture Maps data is available in cloud-native [Parquet](https://parquet.apache.org/docs/) format. There is no single "entire planet" file to download. The data is partitioned by `theme` and `type` and hosted on Amazon S3 and Microsoft Azure Blob Storage.

The latest data release is available at the following locations:
Replace `<release>` below with a release version from the [STAC](#release-discovery), for example `2026-10-21.0`.

#### Amazon S3
### Amazon S3

```text
s3://overturemaps-us-west-2/release/__OVERTURE_RELEASE/
s3://overturemaps-us-west-2/release/<release>/
|-- theme=addresses/
|-- theme=base/
|-- theme=buildings/
Expand All @@ -30,35 +45,38 @@ s3://overturemaps-us-west-2/release/__OVERTURE_RELEASE/
|-- theme=transportation/
```

#### Microsoft Azure
### Microsoft Azure

```text
https://overturemapswestus2.blob.core.windows.net/release/__OVERTURE_RELEASE/
|- theme=addresses
|- theme=base
|- theme=buildings
|- theme=divisions
|- theme=places
|- theme=transportation
https://overturemapswestus2.blob.core.windows.net/release/<release>/
|-- theme=addresses/
|-- theme=base/
|-- theme=buildings/
|-- theme=divisions/
|-- theme=places/
|-- theme=transportation/
```

### Parquet Schema
## Parquet Schema

The Parquet files match the [Overture Data Schema](https://docs.overturemaps.org/schema/)
for each theme with the following enhancements:
The Parquet files match the [Overture Data Schema](https://docs.overturemaps.org/schema/) for each theme, with these additions:

1. The `id` column contains unique identifiers in the [Global Entity Reference System (GERS)](https://docs.overturemaps.org/gers/) format.
2. The `bbox` column is a `struct` with the following attributes:
`xmin`, `xmax`, `ymin`, `ymax`. This column allows you to craft more
efficient spatial queries when running SQL against the cloud.
3. The `geometry` column is encoded as WKB (the files are geoparquet).
2. The `bbox` column is a `struct` with `xmin`, `xmax`, `ymin`, and `ymax`. Filter on it to make spatial queries against cloud storage more efficient.
3. The `geometry` column is WKB-encoded (the files are GeoParquet).

## Release Discovery

The [Overture STAC](https://stac.overturemaps.org/catalog.json) (SpatioTemporal Asset Catalog) is the authoritative source for discovering releases and determining which is the latest.

The STAC also serves [latest.ddb](https://stac.overturemaps.org/latest.ddb), a DuckDB file with one view per feature type over the latest release. It is linked from the root `catalog.json`. Run `LOAD spatial;` before querying it.

### Release Discovery
For upcoming release dates, see the [release calendar](https://docs.overturemaps.org/release-calendar.json) ([schema](https://docs.overturemaps.org/release-calendar.schema.json)).

Use the [Overture STAC](https://stac.overturemaps.org/catalog.json) (SpatioTemporal Asset Catalog) for authoritative release data discovery and to determine the "latest" data.
## Feedback

For upcoming release dates, see the [docs.overturemaps.org/release-calendar.json](https://docs.overturemaps.org/release-calendar.json) ([schema](https://docs.overturemaps.org/release-calendar.schema.json)).
Share feedback on Overture data in [Discussions](https://github.com/OvertureMaps/data/discussions/new/choose). Tag the post with the release and theme (for example Places or Transportation) and include as much detail as possible. The relevant task force reviews each submission.

### Data Release Feedback
Feedback on the data schema belongs in the [schema repository's Discussions](https://github.com/OvertureMaps/schema/discussions).

We are very interested in feedback on the Overture data. Please use the [Discussion](https://github.com/OvertureMaps/data/discussions) section of this repo to comment. Tagging it with the release and relevant theme name (Places, Transportation) will help direct your ideas. Please include as much detail as possible. The associated Task Force will carefully review each submission and offer feedback where required.
Use the issue templates to report a [data bug](https://github.com/OvertureMaps/data/issues/new?template=data_bug.yml) or propose a [new data source](https://github.com/OvertureMaps/data/issues/new?template=new_data_source_proposal.yml).
Binary file added assets/overture-maps-foundation.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
84 changes: 0 additions & 84 deletions utils/fetch_releases_from_stac.py

This file was deleted.

2 changes: 0 additions & 2 deletions utils/requirements-test.txt

This file was deleted.

1 change: 0 additions & 1 deletion utils/requirements.txt

This file was deleted.

Empty file removed utils/tests/__init__.py
Empty file.
Loading
Loading