Method: projects.image.import

匯入圖片。

HTTP 要求

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
project

string

應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 projects/{project-id}。

授權需要指定資源 project 的下列 IAM 權限：

  • earthengine.imports.create

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
欄位
imageManifest

object (ImageManifest)

圖片資訊清單。
description

string

任務的使用者可讀名稱。
overwrite

boolean

是否允許覆寫現有資產。
requestId

string

用於偵測重複要求的不重複字串。如果同一位使用者使用相同的非空白 requestId 提出多個要求，只有其中一個要求才能成功啟動長時間執行作業。requestId 可包含 a..z、A..Z、0-9 或「-」字元。requestId 的長度上限為 60 個半形字元。

回應主體

如果成功，回應主體會包含 Operation 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

ImageManifest

說明 Earth Engine 服務如何從一組檔案合成圖片。

JSON 表示法 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
欄位
name

string

要建立的素材資源名稱。name 的格式為「projects/*/assets/**」(例如「projects/earthengine-legacy/assets/users//」)。所有使用者擁有的素材資源都屬於「earthengine-legacy」專案 (例如「projects/earthengine-legacy/assets/users/foo/bar」)。所有其他素材資源都屬於「earthengine-public」專案 (例如「projects/earthengine-public/assets/LANDSAT」)。
properties

object (Struct format)

資產的其他屬性。「system:time_start」和「system:time_end」屬性名稱已淘汰。請改用 startTime 和 endTime 欄。
uriPrefix

string

在這個資訊清單中定義的所有 uri 前方加上的選用前置字串。
tilesets[]

object (Tileset)

圖塊集。每個圖塊集都必須有專屬 ID。
bands[]

object (TilesetBand)

頻帶。素材資源的頻帶順序與 bands 的順序相同。
maskBands[]

object (TilesetMaskBand)

遮罩帶。
footprint

object (PixelFootprint)

以像素座標 (而非經緯度座標) 顯示足跡。如果空白，則預設會是整個圖片。如需更詳細的像素座標說明，請參閱 PixelGrid。
missingData

object (MissingData)

代表圖像所有波段中沒有資料的值。適用於所有未指定專屬 missingData 的頻帶。
pyramidingPolicy

enum (PyramidingPolicy)

金字塔式推銷政策。如未指定，系統會預設套用 MEAN 政策。適用於所有未指定專屬 pyramidingPolicy 的頻帶。
startTime

string (Timestamp format)

與素材資源相關聯的時間戳記 (如有)，例如衛星圖像拍攝時間。如果素材資源對應的時間間隔為一個月或一年的平均值，這個時間戳記就會對應到該時間間隔的開始時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

如果資產對應的時間間隔為一週或一年，則這個時間戳記對應的時間點為該時間間隔的結束時間 (不含)。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
skipMetadataRead

boolean

是否要使用 GDAL 略過讀取檔案中繼資料。如果這個欄位為 true，圖塊集應包含完整的 GDAL 中繼資料：資料類型、CRS、轉換、檔案大小和無資料值。
memo

string

自由格式欄位，用於儲存使用者附註。不會用於擷取。

TilesetBand

代表來自圖塊集的單一頻帶。

JSON 表示法 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
欄位
id

string

頻帶的 ID。
tilesetId

string

與頻帶相對應的圖塊集 ID。
tilesetBandIndex

integer

與該區塊相對應的圖塊集的區塊索引，從零開始。例如，如果為 1，則該區塊的像素是 ID 為 tilesetId 的圖塊集 (在 ImageManifest.tilesets 中) 索引 1 的區塊像素。
missingData

object (MissingData)

代表該頻帶中沒有資料的值。如果 MissingData 設定為沒有 values，系統就會忽略與此 TilesetBand 相對應的檔案中出現的任何 nodata 值。
pyramidingPolicy

enum (PyramidingPolicy)

金字塔式推銷政策。

TilesetMaskBand

代表來自圖塊集的單一遮罩帶。

JSON 表示法 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
欄位
tilesetId

string

與遮罩頻帶相對應的 Tileset ID。圖塊集的最後一個帶一律會用做遮罩帶。
bandIds[]

string

遮罩頻帶適用的頻帶 ID。如果留空，遮罩頻帶會套用至素材資源中的所有頻帶。每個頻帶只能有一個對應的遮罩頻帶。如果這些頻帶中有任何一個有內部遮罩，系統會忽略內部遮罩，改用這個遮罩頻帶。

PixelFootprint

圖片中所有有效像素的足跡。

JSON 表示法 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
欄位
points[]

object (GridPoint)

環形可形成簡單多邊形的外框，且必須包含圖片中所有有效像素的中心點。這必須是線性環：最後一個點必須與第一個點相同。座標會以 bandId 指定的頻帶投影。

注意：請使用非整數座標 (例如每個像素的中心)，因為如果像素 (1x1 矩形) 與足跡相交，系統會將該像素納入足跡。為避免誤選相鄰像素，請勿使用整數值座標，因為這些是像素之間的邊界。沿著像素中心繪製足跡，可避免納入非預期的像素，因為當指定的像素與地圖邊界 (例如反經線或極點) 相鄰時，可能會導致錯誤。

舉例來說，如果是 2x2 圖片，且所有 4 個像素皆有效，以下是可能的環形：[{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

頻帶 ID，其 CRS 定義了足跡的座標。如果留空，系統會使用第一個頻帶。

GridPoint

二維點或向量。

JSON 表示法 
{
  "x": number,
  "y": number
}
欄位
x

number

x 座標值。
y

number

y 座標值。