Releases: OvertureMaps/schema
Release list
v1.17.0
What's Changed
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.
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.
Changed operating_status to an optional field to allow for null values when signals are not present. #513
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 changes.
New Contributors
- John McCall (@lowlydba) made their first contribution in #454
Full Changelog: v1.16.0...v1.17.0
Contributors
Assets 2
v1.16.0
What's Changed
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.
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 admin_level field. It provides the division’s position in its country’s hierarchy. #419
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 changes.
Full Changelog: v1.15.0...v1.16.0
v1.15.0
What's Changed
Read the full release notes here: https://docs.overturemaps.org/blog/2025/12/17/release-notes/. 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.
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.
Added places type taxonomy column. It provides the primary classification, full hierarchy path, and alternate categories. #420
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 changes.
Full Changelog
Full Changelog: v1.14.0...v1.15.0
v1.14.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.
- Add the type
roller_coasterto infrastructure theme types enumeration. (#410)
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 changes.
Full Changelog
Full Changelog: v1.13.0...v1.14.0
v1.13.0
What's Changed
Read the full release notes here: https://docs.overturemaps.org/blog/. 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.
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)
- Add 'basic_level_category' for places #399
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 changes.
Full Changelog
Full Changelog: v1.12.0...v1.13.0
v1.12.0
What's Changed
Read the full release notes here: https://docs.overturemaps.org/blog/2025/07/23/release-notes/. Below is a list of changes to the schema since the last release.
Schema-Wide Changes
Add 'license' field to 'sources' column #387
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.
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)
- Added 'operating_status' field #354
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 changes.
Full Changelog
Full Changelog: v1.11.0...v1.12.0
v1.11.0
What's Changed
Read the full release notes here: https://docs.overturemaps.org/blog/2025/07/23/release-notes/. 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.
- Add new subclass for
infrastructurefeature type:quay. #357 - Add new classes for
infrastructurefeature type:artwork,quay. #357 - Add new class for
land_usefeature type:railway. #357
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 changes.
Full Changelog
Full Changelog: v1.10.0...v1.11.0
v1.10.0
What's Changed
Read the full release notes here: https://docs.overturemaps.org/blog/2025/06/25/release-notes/. Below is a list of changes to the schema since the last release.
Schema-Wide Changes
- Support disputed naming with perspectives in names property
- Allow sources to be linearly referenced
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.
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.
- Ensured some places attribute list fields cannot be empty
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.
- Introduced classes for railway segments, classes include funicular, monorail, subway, etc.
Full Changelog
Full Changelog: v1.9.0...v1.10.0
v1.9.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.
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.
The building_part type now includes a names attribute #341
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 the
country(ISO-3166-1 alpha-2 country code) andregion(ISO-3166-2 principal subdivision code) properties todivision_boundaryfeature type. #331
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.
- Fix errors and inconsistencies in the reference categories CSV (#343).
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 changes.
Full Changelog
Full Changelog: v1.8.0...v1.9.0
v1.8.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.
- Explicitly specified the type of the
classproperty forwaterfeatures asstring. (This very minor change is just ensuring codifying the existing status explicitly.) #336
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 the
country(ISO-3166-1 alpha-2 country code) andregion(ISO-3166-2 principal subdivision code) properties todivision_boundaryfeature type. #331
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 changes.
Full Changelog
Full Changelog: v1.7.0...v1.8.0