Overturemaps

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

No changes.

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

No changes.

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. minor changes to the enumerated `class` values for the `infrastructure` feature type: remove duplicate `sub_station` and renamed `breakwaters` to `breakwater`. 325

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: GA)

🟢 *The transportation theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. add `is_indoor` road flag. 327



Full Changelog
**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.6.0...v1.7.0

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

No changes.

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

No changes.

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. Added additional subtypes and classes to the infrastructure type in the base theme. 321

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: GA)

🟢 *The transportation theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

- No schema changes



Full Changelog
**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.5.0...v1.6.0

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

No changes.

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

No changes.

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. The `depth` property in the `bathymetry` type must be a positive value. 309

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. Added `prominence` to the cartography field as an indication of a division's significance or importance. 308
- Possible values between 1 and 100.
- Used to help drive cartographic display of a place and is derived from various factors including, but not limited to: population, capital status, place tags, and type.
3. Add `is_land` and `is_territorial` attributes to describe the extent of the division. 303

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: GA)

🟢 *The transportation theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

- No schema changes



Full Changelog
**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.4.0...v1.5.0

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

1. Update `LICENSE` to reflect schema's CC-BY-4.0 licensing scheme.

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

No changes.

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. Added a new `bathymetry` feature type. (https://github.com/OvertureMaps/schema/pull/206)
- A `bathymetry` feature is a topographic representation of an underwater area, such as a part of the ocean floor. Use cases adding depth shading to water bodies in map visualizations.
- There is a known issue with the `bathymetry` feature type's `depth` property. It is meant to be positive but is negative. This issue will be corrected in the next release: https://github.com/OvertureMaps/schema/pull/309.
2. Added a new `class` values for `land`, `land_use`, and `water` feature types (https://github.com/OvertureMaps/schema/pull/295):
- `land`: `plateau`
- `land_use`: `fatbike`, `hike`, `nordic`
- `water`: `blowhole`

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

Added a top-level `class` property to the `division` feature type: https://github.com/OvertureMaps/schema/pull/301. Initially this `class` property will only have a value for `locality` feature types and will help data consumers understand the rough scale or importance of the locality, *e.g.* is it a hamlet, or is it a megacity?

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: GA)

🟢 *The transportation theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

- Theme status changed from 🏗 beta to 🟢 GA.
- No schema changes.

Full Changelog

**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.3.0...v1.4.0

New Contributors

- an-rose made her first contribution in https://github.com/OvertureMaps/schema/pull/300
- Azbesciak made his first contribution in https://github.com/OvertureMaps/schema/pull/304

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

N/A

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

Added a top-level `postal_city` property for cases where the postally-approved city/municipality/locality line of an address contains a different locality name than the locality that physically contains the address coordinates. https://github.com/OvertureMaps/schema/pull/291

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

1. Added a top-level, optional, `height` property to features of type `infrastructure`: https://github.com/OvertureMaps/schema/pull/276.
2. Added new members to the `class` enumeration for features of type `infrastructure`: https://github.com/OvertureMaps/schema/pull/276 (`apron`, `fountain`, `gasometer`, `goods`, `j-bar`, `launchpad`, `magic_carpet`, `motorcycle_parking`, `platter`, `reservoir_covered`, `rope_tow`, `stopway`, `subway_station`, `taxilane`, `zip_line`).
3. Added new members to the `class` enumeration for features of type `land_use`: https://github.com/OvertureMaps/schema/pull/276 (`connection`, `downhill`, `driving_school`, `ice_skate`, `kindergarten`, `military_hospital`, `military_school`, `music_school`, `resort`, `ski_jump`, `skitour`, `sled`, `sleigh`, `snow_park`).
4. Added new members to the `subtype` enumeration for features of type `land`: https://github.com/OvertureMaps/schema/commit/57eeed7e0f1c707b103d11c5e6ced63463285d31#diff-991c09b9f238daa6433fca5ca495d5cabdf718b21f99450c87ec9b2f0619b651R87 (`crater`, `meteor_crater`, `volcanic_caldera_rim`).

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

Added a `roof` member to the `class` enumeration: https://github.com/OvertureMaps/schema/pull/289.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

Added a new `macrohood` subtype to features of type `division` and `division_area`: https://github.com/OvertureMaps/schema/pull/290.

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: Beta)

🏗 *The transportation theme is in* ***beta*** *status. The transportation schema is nearing maturity, but backwardly-incompatible schema changes may occur from month to month until GA status is achieved. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

Removed the `lanes` property: https://github.com/OvertureMaps/schema/pull/286.

Full Changelog

**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.2.0...v1.3.0

What's Changed

Read the full release notes here: https://docs.overturemaps.org/release/latest/. Below is a list of changes to the schema since the last release.

Schema-Wide Changes

Fixed a minor validation bug in the `names` property schema: the `variant` property in name rules under `names.rules` is now required. (https://github.com/OvertureMaps/schema/pull/277) While technically a "breaking" change, we don't expect this to break anything in practice because all Overture-released data already provides the `variant` in name rules.

Theme-Specific Schema Changes

Addresses (Status: Alpha)

🏗 *The addresses theme is in* ***alpha*** *status. Schema changes with potential backward-incompatibility are likely from month to month until the addresses schema increases in maturity. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

Removed `value` as a required sub-property of items in the `address_level` array. (https://github.com/OvertureMaps/schema/pull/283) The motivation for this change is that we want to allow `{}` elements to be used as "placeholder values" within `address_level` so that the length of the `address_level` array can be consistent within geographic areas (*e.g.* United States).

Base (Status: GA)

🟢 *The base theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Buildings (Status: GA)

🟢 *The buildings theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Divisions (Status: GA)

🟢 *The divisions theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Places (Status: GA)

🟢 *The places theme is in* ***GA*** *status. We are striving to avoid backwardly-incompatible schema changes and to deliver adequate notice should they occur.*

No changes.

Transportation (Status: Beta)

🏗 *The transportation theme is in* ***beta*** *status. The transportation schema is nearing maturity, but backwardly-incompatible schema changes may occur from month to month until GA status is achieved. When these changes occur, we will try to provide some notice and a "bridge" period where the old schema is also supported.*

Dropped the deprecated `connector_ids` top-level property/column from transportation segments. (https://github.com/OvertureMaps/schema/pull/284) The deprecation schedule for this property was announced in August in the [What to expect in Overture’s August release](https://docs.overturemaps.org/blog/2024/08/15/preview-august-release/) blog, and this change merely completes the announced change. Data enjoyers should consume the `connectors` property going forward.

Full Changelog

**Full Changelog**: https://github.com/OvertureMaps/schema/compare/v1.1.0...v1.2.0