建立及管理資料集

選取平台： Android iOS JavaScript

您可以使用資料集，將本機檔案或 Google Cloud Storage 中的地理空間資料上傳至 Google 地圖平台。這樣就能在 Cloud 控制台中，將資料集與一或多個地圖樣式建立關聯。將資料集與地圖樣式建立關聯後，請使用資料導向樣式 API，動態設定地圖應用程式樣式。

您也可以使用 REST API，將地理空間資料上傳至資料集。如需更多資訊 請參閱 Maps Datasets API

設定角色

如要在 Google Cloud 專案中建立及管理資料集，您必須具有專案的「擁有者」或「編輯者」IAM 角色。

注意：只要是建立專案的使用者，就會有專案「擁有者」角色。 Google Cloud 控制台的「身分與存取權管理」頁面會顯示專案擁有者和編輯者。

或者，您也可以將下列 IAM 角色指派給用於管理資料集的使用者帳戶或服務帳戶：

• Maps Platform Datasets Admin 角色能讓使用者或服務帳戶讀取/寫入專案資料集；此角色使用者可對資料集執行所有作業。
• Maps Platform Datasets Viewer 角色授予專案資料集的唯讀存取權；此角色使用者可列出、取得或下載資料集。

詳情請參閱「使用 Google Cloud 控制台授予 IAM 角色」一文。

資料集的資料來源

建立資料集後，請將 Google Cloud Storage 或本機檔案中的資料上傳至資料集。

• 上傳 Cloud Storage 中的資料時，請指定 Cloud Storage 資料所屬資源的檔案路徑。這個路徑的格式為 gs://GCS_BUCKET/FILE。

  提出要求的使用者需要具備 Storage 物件檢視者角色，或是任何包含 storage.objects.get 權限的其他角色。如要進一步瞭解如何管理 Cloud Storage 存取權，請參閱「存取權控管總覽」一文。

• 上傳本機檔案中的資料時，請指定內含待上傳資料的 GeoJSON、KML 或 CSV 檔案路徑。

必備條件

建立資料集時：

• 顯示名稱不得與 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 SDK for Android 支援 GeoJSON 規格： 也支援包含下列任一物件類型的 GeoJSON 檔案：

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

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

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

KML 相關規定

Maps SDK for Android 的規定如下：

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

不支援下列 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 標頭下會使用不同的座標系統。如果使用的單位有誤，則即使成功匯入資料集，算繪後的資料也可能會在非預期的位置顯示資料集點。

建立資料集

如要建立資料集，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Datasets」(資料集) 頁面。
2. 按一下「Create Dataset」(建立資料集)。
3. 輸入資料集名稱。所有資料集的名稱皆不得重複。
4. 視需要輸入資料集說明。
5. 按一下「Continue」(繼續)。「Import data」(匯入資料) 頁面隨即顯示。
6. 如果要用來填入資料集的資料是系統中的本機檔案，請在「Upload source」(上傳來源) 下拉式選單中選取「Desktop」(電腦)，或您也可以選擇「Google Cloud Storage bucket」(Google Cloud Storage 值區)。
   • 如果選取「Desktop」(電腦)，請按一下「Browse」(瀏覽)，使用檔案選擇器選取需要的檔案。
   • 如果選取「Google Cloud Storage bucket」(Google Cloud Storage 值區)，請按一下「Browse」(瀏覽)，選取包含資料的值區和檔案。
7. 選取「File format」(檔案格式)。
8. 按一下「Continue」(繼續) 檢查設定。

9. 按一下「Create」(建立)。「Datasets」(資料集) 頁面隨即顯示且列出新的資料集，狀態應為「Processing」(處理中)。

   如果資料上傳成功：

   • 資料集的狀態會設為「已完成」。
   • 這樣一來，資料集就會變成「有效」版本，代表應用程式使用的版本。

   如果上傳作業發生錯誤：

   • 新資料集版本的狀態已設為 已完成：

查看或修改資料集

建立資料集之後，您可以檢視或修改資料集：

1. 在 Google Cloud 控制台中，前往「Datasets」(資料集) 頁面。
2. 按一下資料集名稱。「Dataset details」(資料集詳細資料) 頁面隨即顯示。
   1. 按一下「Details」(詳細資料) 分頁標籤，查看資料集相關資訊。在這個分頁也可以編輯資料集名稱和說明。
   2. 按一下 [Preview] (預覽) 分頁標籤，在地圖上查看資料集 (具有 已完成或 REVERTED 的狀態)。
   3. 按一下「Table Data」(資料表資料) 分頁標籤，查看資料集的所有屬性 (資料集) 狀態為 COMPLETED 或 REVERTED)。這些 可用來設定地圖資料集樣式的屬性。
   4. 點選「Download」(下載) 按鈕，將資料下載到本機檔案中。
   5. 按一下「Delete」(刪除) 按鈕，刪除資料集。

   6. 按一下「Import Data File」按鈕，將新資料上傳至資料集。

      將新資料上傳至資料集時，系統會建立一個新的資料集版本。如果新的資料 成功上傳：

      • 資料集的新版本狀態會設為 已完成。
      • 新版本會顯示為「有效」版本，代表應用程式使用的版本。

      如果上傳作業發生錯誤：

      • 新資料集版本的狀態已設為 已完成：舉例來說，如果目前有版本， 資料集的狀態會設為 REVERTED。
      • 先前的「有效」資料集版本維持在「使用中」狀態第一種是 目前使用的版本