事前準備

本文件將說明必要條件、最佳做法和常見錯誤 處理資料集的輸入要求

必要條件

建立資料集時：

• 顯示名稱不得與 Google Cloud 專案內的其他名稱重複。
• 顯示名稱必須少於 64 個位元組 (因為這些字元是以 UTF-8 表示；部分語言的個別字元可用多個位元組表示)。
• 說明不得超過 1000 個位元組。

上傳資料時：

• 支援的檔案類型為 CSV、GeoJSON 和 KML。
• 支援的檔案大小上限為 500 MB。
• 屬性欄名稱的開頭不得為「?_」。
• 系統不支援 3D 幾何圖形，包括 WKT 格式的「Z」字尾，以及 GeoJSON 格式的高度座標。

，瞭解如何調查及移除這項存取權。

注意： 視資料檔案大小而定，上傳作業 可能需要幾分鐘、甚至數小時才能完成如果上傳時發生錯誤，您會收到錯誤訊息。除非資料集傳回回應，否則請勿嘗試刪除資料集。 再檢查一次

注意： 使用 Maps Datasets API 可能會在較低縮放等級下，捨棄或簡化密集或複雜的資料。舉例來說 使用者縮小到某個州或國家/地區 (例如縮放等級 5-12)，圖塊的資料可能會 而不是放大至城市或社區時 (例如縮放等級為 13-18)。發生這種情況 為了讓資訊方塊與地圖轉譯器搭配使用，讓資訊方塊保持精簡且效能良好。

提示： 如果資料檔案較大且在 您不必設定樣式，但想提升算繪效能，只需編輯 檔案來移除不需要的屬性。減少 屬性可縮小地圖圖塊的大小，進而提升算繪效能。

資料準備最佳做法

如果您的來源資料複雜或較大，例如密集點、長線串或多邊形 (通常超過 50 MB 的來源檔案屬於這個類別)，請考慮簡化資料 ，以在視覺化地圖上取得最佳成效。

以下是準備資料的最佳做法：

1. 盡量減少特徵屬性。只保留需要設定樣式的地圖項目屬性 您的地圖，例如「id」和「類別」您可以將其他資源加入用戶端中的地圖項目 應用程式。舉例來說，請參閱 透過資料導向樣式即時查看資料。
2. 盡可能在屬性物件 (例如整數) 中使用簡易資料類型， ，將地圖方塊最小化，並改善地圖效能。
3. 在上傳檔案前簡化複雜的幾何圖形。做法是在 自選的地理空間工具，例如開放原始碼工具 Mapshaper.org 公用程式，或在 BigQuery 中使用 ST_Simplify 跨越複雜的多邊形幾何圖形
4. 先分群非常密集的資料點，再上傳檔案。做法是在 自選的地理空間工具，例如開放原始碼工具 turf.js 叢集函式，或在 BigQuery 中 使用 ST_CLUSTERDBSCAN 基準點。

如需資料集最佳做法的其他指引，請參閱： 使用資料集和 BigQuery 以視覺化方式呈現資料。

GeoJSON 相關規定

Maps Datasets API 支援最新版 GeoJSON 規格： 也支援包含下列任一物件類型的 GeoJSON 檔案：

• 幾何圖形物件：這種空間形狀是由一組點、線及含有自選孔洞的多邊形所組成。
• 地圖項目物件：包含幾何圖形，以及額外的名稱/值組 (依個別應用程式而不同)。
• 地圖項目集合：一組地圖項目物件。

Maps Datasets API 不支援含有座標參考系統資料的 GeoJSON 檔案 (CRS) WGS84。

如要進一步瞭解 GeoJSON，請參閱「符合 RFC 7946 規範」一文。

KML 相關規定

Maps Datasets API 的規定如下：

• 所有網址都必須是檔案的本機 (或相對) 網址。
• 支援點、線和多邊幾何圖形。
• 所有資料屬性都視為字串。

不支援下列 KML 功能：

• 檔案中未定義的圖示或 <styleUrl>。
• 網路連結，例如 <NetworkLink>
• 區域疊加層，例如 <GroundOverlay>
• 3D 幾何圖形或所有高度相關標記，例如 <altitudeMode>
• 相機規格，例如 <LookAt>
• KML 檔案中定義的樣式。

CSV 相關規定

在 CSV 檔案中，支援的資料欄名稱會按照以下優先順序排列：

• latitude、longitude
• lat、long
• x、y
• wkt (Well-Known Text)
• address、city、state、zip
• address
• 單一資料欄，內含所有地址資訊 (例如 1600 Amphitheatre Parkway Mountain View, CA 94043)

舉例來說，您的檔案含有名為 x、y 和 wkt 的資料欄。 由於 x 和 y 的優先順序較高 (請見上方清單中的支援資料欄名稱順序)，因此系統會使用 x 和 y 資料欄中的值，並略過 wkt 資料欄。

此外：

• 每個資料欄名稱都必須屬於單一資料欄。也就是說，如果資料欄名為 xy 且內含 X 和 Y 座標資料，則不得使用。X 和 Y 座標必須分別位於不同的資料欄中。
• 資料欄名稱不區分大小寫。
• 資料欄名稱的順序沒有任何影響。舉例來說，如果您的 CSV 檔案包含 lat 和 long 資料欄，這兩欄可以按照任何順序排列。

處理資料上傳錯誤

將資料上傳至資料集時，可能會遇到本節所述的常見錯誤。

GeoJSON 錯誤

常見的 GeoJSON 錯誤包括：

• 缺少 type 欄位，或者 type 不是字串。在上傳的 GeoJSON 資料檔案中，每個地圖項目物件和幾何圖形物件定義都必須包含名為 type 的字串欄位。

KML 錯誤

常見的 KML 錯誤包括：

• 資料檔案不得含有上述任何不支援的 KML 功能，否則資料匯入作業可能會失敗。

CSV 錯誤

常見的 CSV 錯誤包括：

• 部分資料列缺少幾何圖形資料欄的值。在 CSV 檔案中，幾何圖形資料欄的每一列都必須包含非空值。幾何圖形資料欄包括：
  • latitude、longitude
  • lat、long
  • x、y
  • wkt
  • address、city、state、zip
  • address
  • 單一資料欄，內含所有地址資訊 (例如 1600 Amphitheatre Parkway Mountain View, CA 94043)
  注意：這個錯誤通常會以訊息來描述，像是「無法將 ' ' 轉換為雙精度浮點值」或「無法剖析地理位置輸入內容：缺少地理位置值」。
• 如果 x 和 y 是幾何圖形資料欄，請確認單位為經緯度。部分公開資料集在 x 和 y 標頭下會使用不同的座標系統。如果使用的單位有誤，則即使成功匯入資料集，算繪後的資料也可能會在非預期的位置顯示資料集點。