GERS 更新日誌

每次資料發布時，Overture 生成一個 GERS 更新日誌，以捕獲與每個功能的唯一 ID 相關的資料變化。此訊息可用於指導資料匹配決策，更好地理解資料穩定性並幫助檢測資料錯誤。

GERS 更新日誌可作為 Parquet 檔案提供——按主題、類型和變更類型分區——位於以下位置：

供應商	位置
Amazon S3	`s3://overturemaps-us-west-2/changelog/`
Microsoft Azure	`wasbs://changelog@overturemapswestus2.blob.core.windows.net/`

變更類型

更新日誌中的變更類型包括：

added：當前版本中此 ID 的功能是新的，之前版本中不存在
removed：當前版本中此 ID 的功能不存在，但在之前版本中存在
data_changed：當前版本中此 ID 的功能的幾何或屬性相較於之前版本中的 ID 發生了更改
unchanged：當前版本中此 ID 的功能的幾何和屬性與之前版本中 ID 的功能相匹配

查詢 GERS 更新日誌

使用 DuckDB 查詢更新日誌，以快速查看從上次發布到當前發布的資料變更。在此範例中，我們獲取了埃塞俄比亞阿姆哈拉州幾個城鎮的建築物的 ID、功能類型和變更類型。

LOAD spatial;
LOAD httpfs;
SET s3_region='us-west-2';

SELECT id, type, change_type 
FROM read_parquet('s3://overturemaps-us-west-2/changelog/2024-06-13-beta.0/theme=buildings/type=*/change_type=*/*', filename=true, hive_partitioning=1) 
WHERE 
        bbox.xmin > 37.165914
        AND bbox.xmax < 37.902271
        AND bbox.ymin > 10.221917
        AND bbox.ymax < 10.751245;

還可以獲取感興趣的區域中按變更類型分類的建築功能數量。

LOAD spatial;
LOAD httpfs;
SET s3_region='us-west-2';

SELECT count(*), change_type 
FROM read_parquet('s3://overturemaps-us-west-2/changelog/2024-06-13-beta.0/theme=buildings/type=*/change_type=*/*', filename=true, hive_partitioning=1) 
WHERE 
        bbox.xmin > 37.165914
        AND bbox.xmax < 37.902271
        AND bbox.ymin > 10.221917
        AND bbox.ymax < 10.751245
GROUP BY change_type;

進一步以 Athena 執行查詢，我們可以通過 Overture ID 連接更新日誌和資料，以關聯變更類型與功能的幾何和屬性。

SELECT release.id, release.names.primary AS primary_name, release.sources[1].dataset AS primary_source, change_type, ST_GeomFromBinary(geometry) AS geometry
FROM v2024_06_13_beta_0 AS release
        INNER JOIN changelog_v2024_06_13_beta_0 AS changelog ON release.id = changelog.id
WHERE release.theme = 'buildings'
 AND release.bbox.xmin > 37.165914
        AND release.bbox.xmax < 37.902271
        AND release.bbox.ymin > 10.221917
        AND release.bbox.ymax < 10.751245;

最後，我們可以使用查詢結果按變更類型視覺化建築功能，並檢查每個功能的屬性。以下範例使用 kepler.gl 創建，顯示了埃塞俄比亞阿姆哈拉州城市 Finote Selam 的建築。資料來自 Overture 的 2024-06-13-beta.0 版本，我們增加了 1 億棟新建築，其中許多是由微軟從衛星圖像中衍生的。

按變更類型分類的建築

變更類型​

查詢 GERS 更新日誌​

變更類型

查詢 GERS 更新日誌