您可以使用資料集,將本機檔案或 Google Cloud Storage 中的地理空間資料上傳至 Google 地圖平台。這樣就能在 Cloud 控制台中,將資料集與一或多個地圖樣式建立關聯。將資料集與地圖樣式建立關聯後,請使用資料導向樣式 API,動態設定地圖應用程式樣式。
您也可以使用 REST API,將地理空間資料上傳至資料集。如需更多資訊 請參閱 Maps Datasets API
設定角色
如要在 Google Cloud 專案中建立及管理資料集,您必須具有專案的「擁有者」或「編輯者」IAM 角色。
或者,您也可以將下列 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 格式的高度座標。
資料準備最佳做法
如果您的來源資料複雜或較大,例如密集點、長線串或多邊形 (通常超過 50 MB 的來源檔案屬於這個類別),請考慮簡化資料 ,以在視覺化地圖上取得最佳成效。
以下是準備資料的最佳做法:
- 盡量減少特徵屬性。只保留需要設定樣式的地圖項目屬性 您的地圖,例如「id」和「類別」您可以將其他資源加入用戶端中的地圖項目 應用程式。舉例來說,請參閱 透過資料導向樣式即時查看資料。
- 盡可能在屬性物件 (例如整數) 中使用簡易資料類型, ,將地圖方塊最小化,並改善地圖效能。
- 在上傳檔案前簡化複雜的幾何圖形。做法是在 自選的地理空間工具,例如開放原始碼工具 Mapshaper.org 公用程式,或在 BigQuery 中使用 ST_Simplify 跨越複雜的多邊形幾何圖形
- 先分群非常密集的資料點,再上傳檔案。做法是在 自選的地理空間工具,例如開放原始碼工具 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 的規定如下:
- 所有網址都必須是檔案的本機 (或相對) 網址。
- 支援點、線和多邊幾何圖形。
- 所有資料屬性都視為字串。
- 檔案中未定義的圖示或
<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
標頭下會使用不同的座標系統。如果使用的單位有誤,則即使成功匯入資料集,算繪後的資料也可能會在非預期的位置顯示資料集點。
建立資料集
如要建立資料集,請按照下列步驟操作:
- 在 Google Cloud 控制台中,前往「Datasets」(資料集) 頁面。
- 按一下「Create Dataset」(建立資料集)。
- 輸入資料集名稱。所有資料集的名稱皆不得重複。
- 視需要輸入資料集說明。
- 按一下「Continue」(繼續)。「Import data」(匯入資料) 頁面隨即顯示。
- 如果要用來填入資料集的資料是系統中的本機檔案,請在「Upload source」(上傳來源) 下拉式選單中選取「Desktop」(電腦),或您也可以選擇「Google Cloud Storage bucket」(Google Cloud Storage 值區)。
- 如果選取「Desktop」(電腦),請按一下「Browse」(瀏覽),使用檔案選擇器選取需要的檔案。
- 如果選取「Google Cloud Storage bucket」(Google Cloud Storage 值區),請按一下「Browse」(瀏覽),選取包含資料的值區和檔案。
- 選取「File format」(檔案格式)。
- 按一下「Continue」(繼續) 檢查設定。
按一下「Create」(建立)。「Datasets」(資料集) 頁面隨即顯示且列出新的資料集,狀態應為「Processing」(處理中)。
如果資料上傳成功:
- 資料集的狀態會設為「已完成」。
- 這樣一來,資料集就會變成「有效」版本,代表應用程式使用的版本。
如果上傳作業發生錯誤:
- 新資料集版本的狀態已設為 已完成:
查看或修改資料集
建立資料集之後,您可以檢視或修改資料集:
- 在 Google Cloud 控制台中,前往「Datasets」(資料集) 頁面。
- 按一下資料集名稱。「Dataset details」(資料集詳細資料) 頁面隨即顯示。
- 按一下「Details」(詳細資料) 分頁標籤,查看資料集相關資訊。在這個分頁也可以編輯資料集名稱和說明。
- 按一下 [Preview] (預覽) 分頁標籤,在地圖上查看資料集 (具有 已完成或 REVERTED 的狀態)。
- 按一下「Table Data」(資料表資料) 分頁標籤,查看資料集的所有屬性 (資料集) 狀態為 COMPLETED 或 REVERTED)。這些 可用來設定地圖資料集樣式的屬性。
- 點選「Download」(下載) 按鈕,將資料下載到本機檔案中。
- 按一下「Delete」(刪除) 按鈕,刪除資料集。
按一下「Import Data File」按鈕,將新資料上傳至資料集。
將新資料上傳至資料集時,系統會建立一個新的資料集版本。如果新的資料 成功上傳:
- 資料集的新版本狀態會設為 已完成。
- 新版本會顯示為「有效」版本,代表應用程式使用的版本。
如果上傳作業發生錯誤:
- 新資料集版本的狀態已設為 已完成:舉例來說,如果目前有版本, 資料集的狀態會設為 REVERTED。
- 先前的「有效」資料集版本維持在「使用中」狀態第一種是 目前使用的版本