diff --git a/release-blog/2023-alpha/2023-07-26-alpha.0.mdx b/blog/2023-alpha/2023-07-26-alpha.0.mdx similarity index 99% rename from release-blog/2023-alpha/2023-07-26-alpha.0.mdx rename to blog/2023-alpha/2023-07-26-alpha.0.mdx index d419347bf..94b83deb2 100644 --- a/release-blog/2023-alpha/2023-07-26-alpha.0.mdx +++ b/blog/2023-alpha/2023-07-26-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2023-07-26-alpha.0 ### Highlights Overture `2023-07-26-alpha.0` is a first release version of open map data, establishing a baseline for future releases by the Overture Maps Foundation. The data is available for use under the designated licenses for each theme. Users should note that while Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not been established yet. + + We would like feedback on the data, its usefulness and how it could be improved. Please use this Github repo for discussions and feedback related to this data release. Overture `2023-07-26-alpha.0` is formatted in the Overture Maps schema described here. It is available in cloud-native Parquet and stored on AWS and Azure. diff --git a/release-blog/2023-alpha/2023-10-19-alpha.0.mdx b/blog/2023-alpha/2023-10-19-alpha.0.mdx similarity index 99% rename from release-blog/2023-alpha/2023-10-19-alpha.0.mdx rename to blog/2023-alpha/2023-10-19-alpha.0.mdx index 678e5412b..6f9193f04 100644 --- a/release-blog/2023-alpha/2023-10-19-alpha.0.mdx +++ b/blog/2023-alpha/2023-10-19-alpha.0.mdx @@ -11,6 +11,8 @@ Overture `2023-10-19-alpha.0` is now available. This release includes several im More information about these additions is available in the relevant sections below. + + This data is formatted in the Overture Data Schema unless otherwise noted. This data is available for use under the designated licenses for each theme. While Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not yet been established. diff --git a/release-blog/2023-alpha/2023-11-14-alpha.0.mdx b/blog/2023-alpha/2023-11-14-alpha.0.mdx similarity index 99% rename from release-blog/2023-alpha/2023-11-14-alpha.0.mdx rename to blog/2023-alpha/2023-11-14-alpha.0.mdx index e96309df2..cfef1f401 100644 --- a/release-blog/2023-alpha/2023-11-14-alpha.0.mdx +++ b/blog/2023-alpha/2023-11-14-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2023-11-14-alpha.0 ### Highlights Overture `2023-11-14-alpha.0` is now available. This is an incremental release that includes several improvements to the data quality and coverage as well as updates for data currency. More information about these additions is available in the relevant sections below. + + This data is formatted in the Overture Data Schema unless otherwise noted. This data is available for use under the designated licenses for each theme. While Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not yet been established. diff --git a/release-blog/2023-alpha/2023-12-14-alpha.0.mdx b/blog/2023-alpha/2023-12-14-alpha.0.mdx similarity index 99% rename from release-blog/2023-alpha/2023-12-14-alpha.0.mdx rename to blog/2023-alpha/2023-12-14-alpha.0.mdx index c0cab20c8..6f7246ec3 100644 --- a/release-blog/2023-alpha/2023-12-14-alpha.0.mdx +++ b/blog/2023-alpha/2023-12-14-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2023-12-14-alpha.0 ### Highlights Overture `2023-12-14-alpha.0` is now available. This release includes several incremental improvements, the conflation of Google Open Buildings into the Building theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. + + This data is formatted in the Overture Data Schema unless otherwise noted. This data is available for use under the designated licenses for each theme. diff --git a/blog/2024-04-21-welcome.mdx b/blog/2024-04-21-welcome.mdx index 01caeea59..c700d766f 100644 --- a/blog/2024-04-21-welcome.mdx +++ b/blog/2024-04-21-welcome.mdx @@ -1,5 +1,5 @@ --- -title: Welcome! +title: Welcome to the Overture Maps engineering blog! --- Welcome to the Overture Maps engineering blog! We're excited to tell the technical stories behind this big, exciting, ambitious, intensely collaborative project we’ve been [working on for more than a year](https://overturemaps.org/looking-forward-to-2024/). The engineers building Overture Maps are eager to connect with our developer community. In the posts we publish in the coming months, you’ll hear from team members who work at Amazon, Meta, Microsoft, TomTom, Esri, Development Seed, Precisely, and more. And we’d like to hear from you: [feedback and contributions](https://github.com/OvertureMaps/data/discussions) from folks working with our data and schema are crucial to our success. Thanks for joining us on this journey. We’re glad you’re here. \ No newline at end of file diff --git a/blog/2024-04-22-beta-release.mdx b/blog/2024-04-22-beta-release.mdx index f10838d5b..966e8d488 100644 --- a/blog/2024-04-22-beta-release.mdx +++ b/blog/2024-04-22-beta-release.mdx @@ -1,12 +1,18 @@ --- title: Exploring our beta release description: Highlights from Overture Maps beta release +tags: + - releases + - developer-tools + - geoparquet --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; Last week Overture Maps [announced the beta release](https://overturemaps.org/overture-maps-foundation-releases-beta-of-its-first-open-map-dataset/) of our schema and data. After months of hard work and steady improvements, we are nearing production-level stability. In a series of posts over the next few weeks -- starting with this one -- we’ll unpack the highlights and improvements you'll see in this release and beyond. + + ## Making geospatial fast The first thing you'll notice is how much faster you can [pull Overture Maps data out of the cloud](https://docs.overturemaps.org/getting-data/locally/). We made this possible by working closely with open-source collaborators on the repartitioning and [spatial optimization](https://cloudnativegeo.org/blog/2024/03/coming-soon-geoparquet-1.1/) of our GeoParquet files. Meanwhile, our friends at DuckDB, one of our favorite SQL tools, [added a feature](https://github.com/duckdb/duckdb/pull/10314) that improves the performance of queries with bounding boxes. diff --git a/blog/2024-05-16-land-cover.mdx b/blog/2024-05-16-land-cover.mdx index ebaf1afc6..f1da3b102 100644 --- a/blog/2024-05-16-land-cover.mdx +++ b/blog/2024-05-16-land-cover.mdx @@ -1,5 +1,8 @@ --- title: Land cover is live +tags: + - releases + - base --- ![land cover gif](/img/blog/lc.gif) @@ -8,6 +11,8 @@ title: Land cover is live The [May release](https://docs.overturemaps.org/release/latest) of Overture Maps includes new high-resolution land cover data *and* new cartographic schema properties. + + Our `land_cover` layer is vectorized data derived from the [European Space Agency’s 2020 WorldCover (10m) rasters](https://esa-worldcover.org/en). It's similar to the land cover layer in the [Daylight](https://daylightmap.org/2023/10/11/landcover.html) map distribution, but Overture Maps added higher-resolution data (zoom level 15) with more detail and land cover classes. You'll find 10 subtypes in the new data: snow, forest, urban, grass, crop, barren, wetland, moss, mangrove, and shrub. Our May release also includes [schema properties](https://docs.overturemaps.org/schema/reference/base/land_cover/) that offer cartographic "hints" for optimal use of Overture Maps data in mapmaking. We added `min_zoom` and `max_zoom` to define the recommended zooms for each resolution of land cover, using the common “slippy maps” zoom level specification. This is a first step toward improving the user experience for mapmakers. We plan to expand these properties in future releases of Overture Maps data. diff --git a/blog/2024-07-24-explore-site.mdx b/blog/2024-07-24-explore-site.mdx index 937eda0c2..732c2ed37 100644 --- a/blog/2024-07-24-explore-site.mdx +++ b/blog/2024-07-24-explore-site.mdx @@ -1,5 +1,7 @@ --- title: Exploring Overture data, no SQL required +tags: + - developer-tools --- Overture has launched a new browser-based tool to give users a no-code option to interact with our data. The Explore website is now the quickest way to get started with Overture, no SQL required: [https://explore.overturemaps.org](https://explore.overturemaps.org/#13.01/39.95692/-75.15583) @@ -8,6 +10,8 @@ Overture has launched a new browser-based tool to give users a no-code option to |:--:| | *Checking out ["Lion Crushing a Serpent"](https://www.associationforpublicart.org/artwork/lion-crushing-a-serpent/) in Philadelphia’s Rittenhouse Park* | + + ## Not a map The Explore tool might look like a map, but we prefer to think of it as an x-ray data inspector. We’ve punted on making cartographic decisions in favor of displaying all of Overture’s themes, all at once: addresses, base, buildings, divisions, places, and transportation. Our users are coming at the data with different perspectives and goals, and we want to provide as much information as possible. We also want to stoke your curiosity and inspire you to ask new questions of Overture data. diff --git a/blog/2024-08-15-preview-august-release.mdx b/blog/2024-08-15-preview-august-release.mdx index edb6d8bd6..da78809ca 100644 --- a/blog/2024-08-15-preview-august-release.mdx +++ b/blog/2024-08-15-preview-august-release.mdx @@ -1,5 +1,13 @@ --- title: What to expect in Overture’s August release +tags: + - releases + - addresses + - base + - buildings + - divisions + - places + - transportation --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -9,6 +17,8 @@ base, buildings, divisions, and places. Our [addresses theme](https://docs.overt for 14 countries; we anticipate adding more address data each month, country by country, starting with Switzerland in the August release. + + The [transportation theme](https://docs.overturemaps.org/guides/transportation/) remains in beta and we expect to make significant changes over the next couple months. In this post, we'll give you a preview of three key improvements to the transportation schema in the August release, **which will be available next week**. diff --git a/blog/2024-10-21-preview-october-release.mdx b/blog/2024-10-21-preview-october-release.mdx index bbb570c89..7532caeec 100644 --- a/blog/2024-10-21-preview-october-release.mdx +++ b/blog/2024-10-21-preview-october-release.mdx @@ -1,6 +1,9 @@ --- title: What to expect in Overture’s October release -description: Overture Maps Data Blog +tags: + - releases + - addresses + - buildings --- This week Overture is [releasing](https://docs.overturemaps.org/release/latest/) datasets that include new diff --git a/blog/2024-12-18-transportation-to-ga.mdx b/blog/2024-12-18-transportation-to-ga.mdx index 2b36028ce..b3a6a4607 100644 --- a/blog/2024-12-18-transportation-to-ga.mdx +++ b/blog/2024-12-18-transportation-to-ga.mdx @@ -1,9 +1,14 @@ --- title: Transportation theme navigates to GA +tags: + - releases + - transportation --- Over the past several releases, Overture has been laying the groundwork to transition our transportation theme from beta to general availability (GA). This post provides a brief roadmap of the work we’ve done to reach that goal, along with a request for our community to continue testing the data and providing valuable feedback. + + First, let’s talk about what GA means for the transportation theme. We have a few guiding principles: 1. There are no "trust violations" in the schema and data. It needs to "just work" when a developer writes code based on our schema and documentation. diff --git a/release-blog/2024-alpha/2024-01-17-alpha.0.mdx b/blog/2024-alpha/2024-01-17-alpha.0.mdx similarity index 99% rename from release-blog/2024-alpha/2024-01-17-alpha.0.mdx rename to blog/2024-alpha/2024-01-17-alpha.0.mdx index b2e6c532f..8236660da 100644 --- a/release-blog/2024-alpha/2024-01-17-alpha.0.mdx +++ b/blog/2024-alpha/2024-01-17-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2024-01-17-alpha.0 ### Highlights Overture `2024-01-17-alpha.0` is now available. This release includes several incremental improvements, addition of geopolitical boundary information in the Admins Theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. + + This data is formatted in the Overture Data Schema unless otherwise noted. This data is available for use under the designated licenses for each theme. diff --git a/release-blog/2024-alpha/2024-02-15-alpha.0.mdx b/blog/2024-alpha/2024-02-15-alpha.0.mdx similarity index 99% rename from release-blog/2024-alpha/2024-02-15-alpha.0.mdx rename to blog/2024-alpha/2024-02-15-alpha.0.mdx index fafafcdec..b61b9ca72 100644 --- a/release-blog/2024-alpha/2024-02-15-alpha.0.mdx +++ b/blog/2024-alpha/2024-02-15-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2024-02-15-alpha.0 ### Highlights Overture `2024-02-15-alpha.0` is now available. This release includes several incremental improvements, addition of geopolitical boundary information in the Admins Theme and expansion of GERS IDs across several themes. More information about these additions is available in the relevant sections below. + + This data is formatted in the Overture Data Schema unless otherwise noted. This data is available for use under the designated licenses for each theme. diff --git a/release-blog/2024-alpha/2024-03-12-alpha.0.mdx b/blog/2024-alpha/2024-03-12-alpha.0.mdx similarity index 99% rename from release-blog/2024-alpha/2024-03-12-alpha.0.mdx rename to blog/2024-alpha/2024-03-12-alpha.0.mdx index 242eab4c0..49e4ba87d 100644 --- a/release-blog/2024-alpha/2024-03-12-alpha.0.mdx +++ b/blog/2024-alpha/2024-03-12-alpha.0.mdx @@ -6,6 +6,8 @@ slug: 2024-03-12-alpha.0 ### Highlights Here are the highlights of what's new and updated in Overture's `2024-03-12-alpha.0` release. This release includes a schema change from `camelCase` to `snake_case` for all property names and enumeration member names, an expansion of stable GERS IDs and incremental updates to the schema and datasets. + + ### Breaking changes We changed `camelCase` to `snake_case` in the schema for properties to be more compatible with some SQL engines. This may break existing code and queries: diff --git a/release-blog/2024-beta/2024-04-16-beta.0.mdx b/blog/2024-beta/2024-04-16-beta.0.mdx similarity index 99% rename from release-blog/2024-beta/2024-04-16-beta.0.mdx rename to blog/2024-beta/2024-04-16-beta.0.mdx index 359215977..6563c1e8b 100644 --- a/release-blog/2024-beta/2024-04-16-beta.0.mdx +++ b/blog/2024-beta/2024-04-16-beta.0.mdx @@ -10,6 +10,8 @@ Overture Maps `2024-04-16-beta.0` is available in GeoParquet and stored on AWS a We encourage developers wishing to adopt Overture Maps base layers to begin evaluating and providing [feedback on the data, schema, and GERS IDs](https://github.com/OvertureMaps/data/discussions). Depending on the feedback from this release and subsequent releases, we anticipate moving to a production release in the next few months. + + ### Breaking changes We renamed the `bbox` column fields to align with the upcoming [GeoParquet](https://geoparquet.org/) 1.1 spec. diff --git a/release-blog/2024-beta/2024-05-16-beta.0.mdx b/blog/2024-beta/2024-05-16-beta.0.mdx similarity index 99% rename from release-blog/2024-beta/2024-05-16-beta.0.mdx rename to blog/2024-beta/2024-05-16-beta.0.mdx index 0b056d4f1..e240b97ed 100644 --- a/release-blog/2024-beta/2024-05-16-beta.0.mdx +++ b/blog/2024-beta/2024-05-16-beta.0.mdx @@ -7,6 +7,8 @@ Here's what's new and updated in the Overture Maps `2024-05-16-beta.0` release. Overture Maps `2024-05-16-beta.0` is available in GeoParquet and stored on AWS and Azure. Users can select the data of interest and download it by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage developers wishing to adopt Overture Maps base layers to begin evaluating and providing [feedback on the data, schema, and GERS IDs](https://github.com/OvertureMaps/data/discussions). Depending on the feedback from this release and subsequent releases, we anticipate moving to a production release in the next few months. + + ### Breaking changes In the `buildings` theme, we promoted `class` to `subtype` and introduced new `class` values. This allows for more detail in a feature. Parking garages, for example, now have the attributes: `subtype=transportation` and `class=parking`. diff --git a/release-blog/2024-beta/2024-06-13-beta.0.mdx b/blog/2024-beta/2024-06-13-beta.0.mdx similarity index 99% rename from release-blog/2024-beta/2024-06-13-beta.0.mdx rename to blog/2024-beta/2024-06-13-beta.0.mdx index dcb8e933f..e32f407ca 100644 --- a/release-blog/2024-beta/2024-06-13-beta.0.mdx +++ b/blog/2024-beta/2024-06-13-beta.0.mdx @@ -22,7 +22,7 @@ AWS path: s3://overturemaps-us-west-2/release/2024-06-13-beta.1 ``` ::: - + Overture's `2024-06-13-beta.0` release is available in GeoParquet and stored on AWS and Azure. You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS via any publicly-available Overture Maps repository on GitHub: diff --git a/release-blog/2024/2024-07-22.0.mdx b/blog/2024/2024-07-22.0.mdx similarity index 98% rename from release-blog/2024/2024-07-22.0.mdx rename to blog/2024/2024-07-22.0.mdx index f3b3737f8..9e0ae3652 100644 --- a/release-blog/2024/2024-07-22.0.mdx +++ b/blog/2024/2024-07-22.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-07-22.0 +title: 2024-07-22.0 release notes slug: 2024-07-22.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-07-22.0 s3://overturemaps-us-west-2/release/2024-07-22.0 ``` + + You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: - [Schema](https://github.com/OvertureMaps/schema) diff --git a/release-blog/2024/2024-08-20.0.mdx b/blog/2024/2024-08-20.0.mdx similarity index 98% rename from release-blog/2024/2024-08-20.0.mdx rename to blog/2024/2024-08-20.0.mdx index 3564ff817..56affa9e6 100644 --- a/release-blog/2024/2024-08-20.0.mdx +++ b/blog/2024/2024-08-20.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-08-20.0 +title: 2024-08-20.0 release notes slug: 2024-08-20.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-08-20.0 s3://overturemaps-us-west-2/release/2024-08-20.0 ``` + + You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: - [Schema](https://github.com/OvertureMaps/schema) diff --git a/release-blog/2024/2024-09-18.0.mdx b/blog/2024/2024-09-18.0.mdx similarity index 98% rename from release-blog/2024/2024-09-18.0.mdx rename to blog/2024/2024-09-18.0.mdx index 6db8a6e6e..6927fc9fa 100644 --- a/release-blog/2024/2024-09-18.0.mdx +++ b/blog/2024/2024-09-18.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-09-18.0 +title: 2024-09-18.0 release notes slug: 2024-09-18.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -10,10 +12,6 @@ import QueryBuilder from '@site/src/components/queryBuilder'; **The `2024-09-18.0` release of Overture data is now available.** We are still on `v.1.1.0` of the Overture schema, as we did not cut a new schema version with this data release. The base, buildings, divisions, and places themes are stable, which means the only changes to these themes are data improvements and bug fixes. We added new road data from TomTom, mostly in Saudi Arabia, to the transportation theme (beta). To the addresses theme (alpha) we added new data for Finland and Chile, and we replaced NAD-sourced address features in New York City with addresses from NYC Open Data. -:::note -Overture's GeoParquet files are now released according to the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the `covering` metadata included. -::: - The datasets are available as GeoParquet files stored on both AWS and Azure. The release paths are: @@ -26,6 +24,11 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-09-18.0 ``` s3://overturemaps-us-west-2/release/2024-09-18.0 ``` + + +:::note +Overture's GeoParquet files are now released according to the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the `covering` metadata included. +::: You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: diff --git a/release-blog/2024/2024-10-23.0.mdx b/blog/2024/2024-10-23.0.mdx similarity index 98% rename from release-blog/2024/2024-10-23.0.mdx rename to blog/2024/2024-10-23.0.mdx index 1d7eeeeff..513441ca8 100644 --- a/release-blog/2024/2024-10-23.0.mdx +++ b/blog/2024/2024-10-23.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-10-23.0 +title: 2024-10-23.0 release notes slug: 2024-10-23.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-10-23.0 ``` s3://overturemaps-us-west-2/release/2024-10-23.0 ``` + + :::note We are now releasing Overture's GeoParquet files in accordance with the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the covering metadata included. ::: diff --git a/release-blog/2024/2024-11-13.0.mdx b/blog/2024/2024-11-13.0.mdx similarity index 98% rename from release-blog/2024/2024-11-13.0.mdx rename to blog/2024/2024-11-13.0.mdx index d23fbc055..32c1a5be6 100644 --- a/release-blog/2024/2024-11-13.0.mdx +++ b/blog/2024/2024-11-13.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-11-13.0 +title: 2024-11-13.0 release notes slug: 2024-11-13.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -21,6 +23,9 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-11-13.0 ``` s3://overturemaps-us-west-2/release/2024-11-13.0 ``` + + + :::note We are now releasing Overture's GeoParquet files in accordance with the [GeoParquet v1.1.0 specification](https://geoparquet.org/releases/v1.1.0/), with the covering metadata included. ::: diff --git a/release-blog/2024/2024-12-18.0.mdx b/blog/2024/2024-12-18.0.mdx similarity index 97% rename from release-blog/2024/2024-12-18.0.mdx rename to blog/2024/2024-12-18.0.mdx index 43ef5b5d4..7238daa08 100644 --- a/release-blog/2024/2024-12-18.0.mdx +++ b/blog/2024/2024-12-18.0.mdx @@ -1,6 +1,8 @@ --- -title: 2024-12-18.0 -slug: 2024-12-18.0 +title: 2024-12-18.0 release notes +slug: 2024-12-18.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -21,6 +23,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2024-12-18.0 ``` s3://overturemaps-us-west-2/release/2024-12-18.0 ``` + You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions, report bugs, and provide feedback via our [data](https://github.com/OvertureMaps/data) and [schema](https://github.com/OvertureMaps/schema) repositories on GitHub. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/release-blog/2025/2025-01-22.0.mdx b/blog/2025/2025-01-22.0.mdx similarity index 97% rename from release-blog/2025/2025-01-22.0.mdx rename to blog/2025/2025-01-22.0.mdx index 64fd38658..799f4f71d 100644 --- a/release-blog/2025/2025-01-22.0.mdx +++ b/blog/2025/2025-01-22.0.mdx @@ -1,6 +1,8 @@ --- -title: 2025-01-22.0 +title: 2025-01-22.0 release notes slug: 2025-01-22.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-01-22.0 s3://overturemaps-us-west-2/release/2025-01-22.0 ``` + + You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions, report bugs, and provide feedback via our [data](https://github.com/OvertureMaps/data) and [schema](https://github.com/OvertureMaps/schema) repositories on GitHub. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/release-blog/2025/2025-02-19.0.mdx b/blog/2025/2025-02-19.0.mdx similarity index 98% rename from release-blog/2025/2025-02-19.0.mdx rename to blog/2025/2025-02-19.0.mdx index d1f949fbe..b85a4f26c 100644 --- a/release-blog/2025/2025-02-19.0.mdx +++ b/blog/2025/2025-02-19.0.mdx @@ -1,6 +1,8 @@ --- -title: 2025-02-19.0 +title: 2025-02-19.0 release notes slug: 2025-02-19.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-02-19.0 s3://overturemaps-us-west-2/release/2025-02-19.0 ``` + + You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussions forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/release-blog/2025/2025-03-19.0.mdx b/blog/2025/2025-03-19.0.mdx similarity index 98% rename from release-blog/2025/2025-03-19.0.mdx rename to blog/2025/2025-03-19.0.mdx index 97fbe3abd..a3c735ba4 100644 --- a/release-blog/2025/2025-03-19.0.mdx +++ b/blog/2025/2025-03-19.0.mdx @@ -1,6 +1,8 @@ --- -title: 2025-03-19.1 +title: 2025-03-19.1 release notes slug: 2025-03-19.1 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -26,6 +28,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-03-19.1 ::: + + ## Overview **The `2025-03-19.0` release of Overture data and `v1.7.0` of the Overture schema are now available.** diff --git a/release-blog/2025/2025-04-23.0.mdx b/blog/2025/2025-04-23.0.mdx similarity index 92% rename from release-blog/2025/2025-04-23.0.mdx rename to blog/2025/2025-04-23.0.mdx index 1e6833a8f..3a3d58249 100644 --- a/release-blog/2025/2025-04-23.0.mdx +++ b/blog/2025/2025-04-23.0.mdx @@ -1,6 +1,8 @@ --- -title: 2025-04-23.0 +title: 2025-04-23.0 release notes slug: 2025-04-23.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -8,7 +10,7 @@ import QueryBuilder from '@site/src/components/queryBuilder'; ## Overview -**The `2025-04-23.0` release of Overture data and `v1.8.0` of the Overture schema are now available.** +**The `2025-04-23.0` release of Overture data and `v1.8.0` of the Overture schema are now available.** This month we fixed several data issues and made small schema changes, notably to the `divisions` theme, where we added `country` and `region` properties to the `division_boundary` feature type and populated the `local_type` property with set values. The datasets are available as GeoParquet files stored on both AWS and Azure. The release paths are: @@ -21,6 +23,7 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-04-23.0 ``` s3://overturemaps-us-west-2/release/2025-04-23.0 ``` + You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussions forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. diff --git a/release-blog/2025/2025-05-21.0.mdx b/blog/2025/2025-05-21.0.mdx similarity index 95% rename from release-blog/2025/2025-05-21.0.mdx rename to blog/2025/2025-05-21.0.mdx index e1e59e78c..6fcc80a15 100644 --- a/release-blog/2025/2025-05-21.0.mdx +++ b/blog/2025/2025-05-21.0.mdx @@ -1,6 +1,8 @@ --- -title: 2025-05-21.0 -slug: latest +title: 2025-05-21.0 release notes +slug: 2025-05-21.0 +tags: + - releases --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; @@ -8,7 +10,7 @@ import QueryBuilder from '@site/src/components/queryBuilder'; ## Overview -**The `2025-05-21.0` release of Overture data and `v1.9.0` of the Overture schema are now available.** +**The `2025-05-21.0` release of Overture data and `v1.9.0` of the Overture schema are now available.** This month we added [PinMeTo](/attribution/#places) as a new data provider for `places`, improved the taxonomy of the `categories` property, added new data sources for `addresses`, and fixed bugs. Also in this release, we're introducing bridge files and announcing a major change to how we generate GERS IDs starting with the June release. The datasets are available as GeoParquet files stored on both AWS and Azure. The release paths are: @@ -22,6 +24,8 @@ wasbs://release@overturemapswestus2.blob.core.windows.net/2025-05-21.0 s3://overturemaps-us-west-2/release/2025-05-21.0 ``` + + You can access the datasets by following the process outlined [here](/getting-data). We encourage you to ask questions and provide feedback on the Overture Maps [Discussion forum on GitHub](https://github.com/orgs/OvertureMaps/discussions). You can also file issues and report bugs in our [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repositories. If you have a suggestion for a new dataset or if you have data you'd like to contribute to Overture, you can email us at data@overturemaps.org. We’d love to hear from you. ## What's new? Bridge files! diff --git a/docs/guides/transportation.mdx b/docs/guides/transportation.mdx index 2c652f5ee..762acae12 100644 --- a/docs/guides/transportation.mdx +++ b/docs/guides/transportation.mdx @@ -18,7 +18,7 @@ import DocCardList from '@theme/DocCardList'; The Overture transportation theme is the collection of LineString and Point features that describe the infrastructure and conventions of how people and objects travel around the world. The dataset contains two features types: `connector` and `segment`. The three subtypes within `segment` -- `road`, `rail`, and `water` -- contain familiar categories of transportation data: highways, footways, cycleways, railways, ferry routes, and public transportation. -Most of the data in the transportation theme is sourced from OpenStreetMap. In the `2024-09-18.0` [release](/release), we began adding data from TomTom to improve coverage in key areas. +Most of the data in the transportation theme is sourced from OpenStreetMap. In the `2024-09-18.0` release, we began adding data from TomTom to improve coverage in key areas. You might use the Overture transportation data for: diff --git a/docs/introduction.mdx b/docs/introduction.mdx index 397d9c9b8..3f77f5a51 100644 --- a/docs/introduction.mdx +++ b/docs/introduction.mdx @@ -10,7 +10,7 @@ In this documentation, you'll find [instructions](getting-data) for accessing an ## Overture data -We [release](release) our data monthly as [cloud-native GeoParquet](https://guide.cloudnativegeo.org/geoparquet/) files, partitioned by theme and type. Each data theme contains one or more feature types, mapped in this way: +We release our data monthly as [cloud-native GeoParquet](https://guide.cloudnativegeo.org/geoparquet/) files, partitioned by theme and type. Each data theme contains one or more feature types, mapped in this way: ```json type_theme_map = { diff --git a/docs/release-calendar.mdx b/docs/release-calendar.mdx new file mode 100644 index 000000000..b32aa4a13 --- /dev/null +++ b/docs/release-calendar.mdx @@ -0,0 +1,47 @@ +--- +title: Release Calendar +--- + +## Versioning +Overture uses a three-component `..` version number, i.e. `v1.2.3`, that effectively follows the [semantic versioning specification](https://semver.org/spec/v2.0.0.html). In general, a “major” change is expected to have a larger impact on data consumers, while a “minor” change is expected to have a lesser impact. Our monthly data releases are tagged with the date of the release, in the format `yyyy-mm-dd.x`, with x indicating a patch or hotfix to the data. + +## Upcoming releases + +Our planned release schedule for the next few months is below. The release dates and schema versions are tentative. + +| Date | Data version | Schema version | +| ----- | ----- | ----- | +| 25 June 2025 | `2025-06.25.0` | `v1.10.0` | +| 23 July 2025 | `2025-07-23` | `v1.11.0` | +| 20 August 2025 | `2025-08.20.0` | `v1.12.0` | + + +## Past releases + +Overture has been releasing data monthly since October 2023. The data releases and their corresponding schema versions are listed below, with links to the release notes. + +| Date | Data version | Schema version | +| ----- | ----- | ----- | +| 21 May 2025 | `2025-05.21.0` | [`v.1.9.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.9.0) | +| 23 April 2025 | `2025-04-23.0` | [`v.1.8.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.8.0) | +| 20 March 2025 | `2025-03.19.1` | [`v.1.7.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.7.0) | +| 19 March 2025 | `2025-03.19.0` | [`v.1.7.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.7.0) | +| 19 February 2025 | `2025-02.19.0` | [`v.1.6.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.6.0) | +| 22 January 2025 | `2025-01-22.0` | [`v.1.5.0`](https://github.com/OvertureMaps/schema/releases/tag/v1.5.0) | +| 18 December 2024 | `2024-12.18.0` | `v.1.4.0` | +| 13 November 2024 | `2024-11.13.0` | `v.1.3.0` | +| 23 October 2024 | `2024-10-23.0` | `v.1.2.0` | +| 18 September 2024 | `2024-09.18.0` | `v.1.1.0` | +| 20 August 2024 | `2024-08.20.0` | `v.1.1.0` | +| 22 July 2024 | `2024-07-22.0` | `v1.0.0` | +| 24 June 2024 | `2024-06.13-beta.1` | `v0.12.0-beta` | +| 13 June 2024 | `2024-06-13-beta.0` | `v0.12.0-beta` | +| 16 May 2024 | `2024-05.16-beta.0` | `v0.11.0-beta` | +| 16 April 2024 | `2024-04-16-beta.0` | `v0.10.0-beta` | +| 12 March 2024 | `2024-03.12-alpha.0` | `v0.9.0` | +| 15 February 2024 | `2024-02.15-alpha.0` | `v0.8.0` | +| 17 January 2024 | `2024-01.17-alpha.0` | `v0.7.0` | +| 14 December 2023 | `2023-12.14-alpha.0` | `v0.7.0` | +| 14 November 2023 | `2023-11.14-alpha.0` | `v0.6.0` | +| 19 October 2023 | `2023-10.19-alpha.0` | `v0.5.0`| +| 26 July 2023 | `2023-07.26-alpha.0` | `v0.4.0` | diff --git a/docusaurus.config.js b/docusaurus.config.js index f68fbe0c2..882391b71 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -87,21 +87,6 @@ const config = { }; }, }), - [ - '@docusaurus/plugin-content-blog', - { - id: 'release-blog', - blogSidebarTitle: 'Releases', - blogTitle: "Overture Release Notes and Schema Changelog", - blogDescription: "Overture Maps Release Notes and Schema Changelog", - showReadingTime: false, - postsPerPage: 1, - onUntruncatedBlogPosts: 'ignore', - blogSidebarCount: 'ALL', - routeBasePath: 'release', - path: './release-blog', - }, - ], [ '@docusaurus/plugin-content-pages', { @@ -124,10 +109,10 @@ const config = { showLastUpdateTime: true, }, blog: { - blogTitle: 'Overture Maps Data Blog', - blogDescription: 'Data stories from the Overture Maps engineering team', - blogSidebarTitle: 'Overture Maps Data Blog', - blogSidebarCount: 'ALL', + blogTitle: 'Overture Maps Engineering Blog', + blogDescription: 'Building Overture Maps', + blogSidebarTitle: 'Posts from the Overture Maps engineering team', + blogSidebarCount: 20, }, theme: { customCss: require.resolve('./src/css/custom.css'), @@ -165,11 +150,6 @@ const config = { position: 'left', label: 'Schema Reference', }, - { - to: 'release/latest', - label: 'Releases', - position: 'left', - }, { to: 'blog', label: 'Blog', diff --git a/release-blog/template.mdx b/release-blog/template.mdx deleted file mode 100644 index ade8796a9..000000000 --- a/release-blog/template.mdx +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: TEMPLATE -draft: true ---- -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; -import QueryBuilder from '@site/src/components/queryBuilder'; - -## Overview - -**Overture's `2024-xx-xx.x` data release is now available.** - - - -The datasets are available as GeoParquet files stored on both AWS and Azure. The release paths are: - -#### Microsoft Azure: -``` -add release path here -``` - -#### Amazon S3: -``` -add release path here -``` - - - -You can access the datasets by following the process outlined [here](https://docs.overturemaps.org/getting-data/). We encourage users to report bugs and provide feedback on the data, schema, and GERS on one of our Overture GitHub repositories: - -- [Schema](https://github.com/OvertureMaps/schema) -- [Data](https://github.com/OvertureMaps/data) -- [Docs](https://github.com/OvertureMaps/docs) -- [Python command-line tool](https://github.com/OvertureMaps/overturemaps-py) -- [Explore site](https://github.com/OvertureMaps/io-site) - - - -## Breaking changes - - - -## Deprecations - - -## Theme-specific updates - -### Addresses - -### Base - -### Buildings - -### Divisions - -### Places - -### Transportation - - -## GERS Changelog - - -## Schema Changelog - - -## Attribution - -You'll find information about attribution and licensing [here](/attribution). diff --git a/sidebars.js b/sidebars.js index 206dc1c27..b57ee44e8 100644 --- a/sidebars.js +++ b/sidebars.js @@ -76,7 +76,8 @@ const sidebars = { 'gers/gers-tutorial' ] }, - 'attribution' + 'attribution', + 'release-calendar' ], schema:[ {