匯入資料表資料

上傳表格素材資源

您可以使用資產管理工具指令列介面 (CLI),上傳以 Shapefile 或 CSV 格式儲存的資料集。(如要進一步瞭解如何使用 Code Editor 或 CLI 匯入光柵,請參閱「匯入光柵資料」一文。)您上傳的素材資源一開始是私密的,但可以按照「共用素材資源」一節所述進行分享。

上傳 Shapefile

如要透過程式碼編輯器上傳 Shapefile,請按一下 按鈕,然後選取「Table Upload」部分下方的「Shape files」。系統會顯示類似圖 1 的上傳對話方塊。按一下「SELECT」按鈕,然後前往本機檔案系統中含有 Shapefile 或 ZIP 封存檔案的 Shapefile。選取 .shp 檔案時,請務必選取相關的 .dbf、.shx 和 .prj 檔案。如果未提供 .prj 檔案,Earth Engine 預設會使用 WGS84 (經度、緯度) 座標。如果您上傳的是 ZIP 封存檔,請確認其中只包含一個 Shapefile (一組 .shp、.dbf、.shx、.prj 等),且沒有重複的檔案名稱。請確認檔案名稱不含額外的半形句號或點。(副檔名會在副檔名前加上一個句號)。

在使用者資料夾中為表格指定適當的素材資源 ID (不含現有 ID)。按一下「上傳」開始上傳。

資產
圖 1. Asset Manager 形狀檔上傳對話方塊。請注意,您必須提供 .shp、.dbf 和 .shx 檔案。其他附加檔案則為選用檔案。如果未提供 .prj 檔案,系統會假設為 WGS84。

上傳 CSV 檔案

如要透過程式碼編輯器上傳 CSV,請啟用「Assets」分頁,然後按一下 按鈕,並選取「Table Upload」部分下方的「CSV file」。系統會顯示類似圖 2 的上傳對話方塊。按一下「SELECT」按鈕,然後前往本機檔案系統中的 .csv 檔案。為表格提供不重複且相關的素材資源 ID 名稱。 按一下「確定」開始上傳。

資產
圖 2. 素材資源管理工具 CSV 檔案上傳對話方塊。

CSV 檔案應包含每個特徵的資料列,以及特徵集合中屬性或變數的資料欄數量。如果地圖項目是地理空間,則必須具有由幾何圖形字串 (GeoJSON、WKT) 或 x 和 y 位置屬性定義的地理位置。如果 CSV 檔案是從 GDAL/OGR 等 GIS 或地理空間資料工具匯出的資料,則應已存在格式正確且命名為幾何圖形的資料欄。或者,您也可以在試算表應用程式中定義兩個代表 x 和 y 座標的資料欄,並將其與其他變數一併匯出為 CSV 格式。

進階選項

在上傳對話方塊的「進階選項」部分中,查看並變更預設設定。您可以分割具有大量頂點的幾何圖形,藉此改善 Earth Engine 的效能。Earth Engine 不允許超過 100 萬個頂點的要素。在表格上傳期間,Earth Engine 會自動分割超過 100 萬個頂點的幾何圖形。您可以指定較低的值,以改善向量算繪效能。

除非另有指定,否則 Earth Engine 會嘗試偵測主要幾何圖形資料欄,並假設資料投影為 WGS84。幾何圖形的測地線狀態取決於指定投影的預設邊緣解讀方式 (例如 WGS84 使用測地線幾何圖形),但這可在「進階設定」選單中覆寫。如果資料的幾何圖形是透過 x 和 y 欄定義的點,請務必將各資料欄命名為「經度」和「緯度」,或在「進階」設定下指定 x 和 y 欄名稱。

追蹤上傳進度

開始上傳資料表後,系統會在工作管理員中新增「資產攝入」工作,這項工作位於程式碼編輯器右側的「工作」分頁下方。按一下 ? 即可查看上傳狀態。將滑鼠游標懸停在工作上方時顯示的圖示。如要取消上傳作業,請按一下任務旁邊的旋轉圖示 。擷取完成後,工作單元格會變成藍色,素材資源會顯示在「Assets」分頁下方的使用者資料夾中,並帶有 圖示。

資料表上傳限制

上傳表格時,表格中的地圖項目數量上限為 10 億。地圖項目的屬性數量上限為 1,024 個。這些限制可確保產生的資產可有效查詢。此外,每個地圖項目都有一個頂點上限,請參閱上方的「進階選項」一節。

將資料表素材資源載入至指令碼

如要透過表格素材資源在指令碼中建立 FeatureCollection,請按照「管理素材資源」頁面所述匯入表格。