From 1d9976296a320c50d6dbe90838d959c593715401 Mon Sep 17 00:00:00 2001 From: Markus Tremmel <75912142+mactrem@users.noreply.github.com> Date: Thu, 10 Jul 2025 16:46:56 +0200 Subject: [PATCH 1/5] Fix geometry description of addresses theme --- docs/guides/addresses.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/addresses.mdx b/docs/guides/addresses.mdx index 03c356240..98bff2a39 100644 --- a/docs/guides/addresses.mdx +++ b/docs/guides/addresses.mdx @@ -93,7 +93,7 @@ An `address` is a feature type that represents a physical place through a series | column | type | description | | --- | --- | --- | | id | string | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry. MUST be a Point as defined by GeoJSON schema. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | country | string | ISO 3166-1 alpha-2 country code of the country or country-like entity, that this address represents or belongs to. | | postcode | string | The postcode for the address. | From f08e0acc32893cc4da697a5984f3f2139fba0167 Mon Sep 17 00:00:00 2001 From: Stephen Epps Date: Thu, 10 Jul 2025 11:43:04 -0700 Subject: [PATCH 2/5] update geometry definitions for base and buildings --- docs/guides/base.mdx | 12 ++++++------ docs/guides/buildings.mdx | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/guides/base.mdx b/docs/guides/base.mdx index c0b64f663..445ef5289 100644 --- a/docs/guides/base.mdx +++ b/docs/guides/base.mdx @@ -29,7 +29,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Polygon or MultiPolygon. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -45,7 +45,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | varchar | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Point, Polygon, MultiPolygon, or LineString. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -67,7 +67,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Point, Polygon, MultiPolygon, or LineString. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -89,7 +89,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Polygon or MultiPolygon. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -105,7 +105,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Point, Polygon, MultiPolygon, or LineString. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -127,7 +127,7 @@ The Overture Maps base theme provides the land, water, infrastructure, and bathy | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A WKB representation of the entity's geometry - a Point, Polygon, MultiPolygon, or LineString. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | diff --git a/docs/guides/buildings.mdx b/docs/guides/buildings.mdx index 024d33b7b..84bd8ac6c 100644 --- a/docs/guides/buildings.mdx +++ b/docs/guides/buildings.mdx @@ -94,7 +94,7 @@ Currently, the Overture buildings dataset is a combination of the following open | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). It MUST be a Polygon or MultiPolygon as defined by the GeoJSON schema. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | @@ -127,7 +127,7 @@ Currently, the Overture buildings dataset is a combination of the following open | column | type | description | | --- | --- | --- | | id | string | A feature ID that may be associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. | -| geometry | binary | A building's geometry is defined as its footprint or roofprint (if traced from aerial/satellite imagery). MUST be a Polygon as defined by GeoJSON schema. | +| geometry | binary | The geometry of a single building part. It MUST be a Polygon or MultiPolygon as defined by the GeoJSON schema. | | bbox | struct | Area defined by two longitudes and two latitudes: latitude is a decimal number between -90.0 and 90.0; longitude is a decimal number between -180.0 and 180.0. | | version | integer | Version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed. | | sources | struct | The array of source information for the properties of a given feature. Each source object lists the property in JSON Pointer notation and the dataset from which that specific value originated. | From dc3f65f2a0d1cc2a8cb50bfb40d81ef301bd5217 Mon Sep 17 00:00:00 2001 From: Stephen Epps Date: Thu, 10 Jul 2025 11:44:13 -0700 Subject: [PATCH 3/5] precision values formatting --- docs/guides/buildings.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/buildings.mdx b/docs/guides/buildings.mdx index 84bd8ac6c..73194fa29 100644 --- a/docs/guides/buildings.mdx +++ b/docs/guides/buildings.mdx @@ -78,9 +78,9 @@ Currently, the Overture buildings dataset is a combination of the following open | [Esri Community Maps](https://communitymaps.arcgis.com/home) | Community-contributed | 2 | ~11 Million | | [Instituto Geográfico Nacional (España)](https://www.ign.es/) | National dataset | 3 | ~11.7 Million | | [City of Vancouver, Canada](https://opendata.vancouver.ca/) | Municipal dataset | 4 | ~14 Thousand | -| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (>90% precision) | 5 | ~350 Million | +| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (/<90% precision) | 5 | ~350 Million | | [Microsoft](https://github.com/microsoft/GlobalMLBuildingFootprints) | ML-derived roofprints | 6 | ~723 Million | -| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (<90% precision) | 7 | ~650 Million | +| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (/<90% precision) | 7 | ~650 Million | | [Buildings in East Asian Countries](https://zenodo.org/records/8174931) | ML-derived roofprints | 8 | ~213 Million | ## Understanding the parquet files From 727c517c0d0ad1606594f608fd9b51e688fd13dd Mon Sep 17 00:00:00 2001 From: Stephen Epps Date: Thu, 10 Jul 2025 11:52:21 -0700 Subject: [PATCH 4/5] corrected markdown formatting --- docs/guides/buildings.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/buildings.mdx b/docs/guides/buildings.mdx index 73194fa29..6a6421c75 100644 --- a/docs/guides/buildings.mdx +++ b/docs/guides/buildings.mdx @@ -78,9 +78,9 @@ Currently, the Overture buildings dataset is a combination of the following open | [Esri Community Maps](https://communitymaps.arcgis.com/home) | Community-contributed | 2 | ~11 Million | | [Instituto Geográfico Nacional (España)](https://www.ign.es/) | National dataset | 3 | ~11.7 Million | | [City of Vancouver, Canada](https://opendata.vancouver.ca/) | Municipal dataset | 4 | ~14 Thousand | -| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (/<90% precision) | 5 | ~350 Million | +| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (\<90% precision) | 5 | ~350 Million | | [Microsoft](https://github.com/microsoft/GlobalMLBuildingFootprints) | ML-derived roofprints | 6 | ~723 Million | -| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (/<90% precision) | 7 | ~650 Million | +| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (\<90% precision) | 7 | ~650 Million | | [Buildings in East Asian Countries](https://zenodo.org/records/8174931) | ML-derived roofprints | 8 | ~213 Million | ## Understanding the parquet files From cc3c9f1242b0b7909690d880aa60b38109e56883 Mon Sep 17 00:00:00 2001 From: Stephen Epps Date: Thu, 10 Jul 2025 12:02:59 -0700 Subject: [PATCH 5/5] fix google precision note --- docs/guides/buildings.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/buildings.mdx b/docs/guides/buildings.mdx index 6a6421c75..d6334b616 100644 --- a/docs/guides/buildings.mdx +++ b/docs/guides/buildings.mdx @@ -78,7 +78,7 @@ Currently, the Overture buildings dataset is a combination of the following open | [Esri Community Maps](https://communitymaps.arcgis.com/home) | Community-contributed | 2 | ~11 Million | | [Instituto Geográfico Nacional (España)](https://www.ign.es/) | National dataset | 3 | ~11.7 Million | | [City of Vancouver, Canada](https://opendata.vancouver.ca/) | Municipal dataset | 4 | ~14 Thousand | -| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (\<90% precision) | 5 | ~350 Million | +| [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (>90% precision) | 5 | ~350 Million | | [Microsoft](https://github.com/microsoft/GlobalMLBuildingFootprints) | ML-derived roofprints | 6 | ~723 Million | | [Google Open Buildings](https://sites.research.google/open-buildings/) | ML-derived roofprints (\<90% precision) | 7 | ~650 Million | | [Buildings in East Asian Countries](https://zenodo.org/records/8174931) | ML-derived roofprints | 8 | ~213 Million |