Method: projects.image.import

导入图片。

HTTP 请求

POST https://earthengine.googleapis.com/v1/{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

介绍 EarthEngine 服务应如何根据一组文件合成图片。

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，则该图层的像素是图块集（在 ImageManifest.tilesets 中）索引 1 处（ID 为 tilesetId）的图层的像素。
missingData

object (MissingData)

表示该频段中没有数据的值。如果设置 MissingData 时没有 values，则系统会忽略与此 TilesetBand 对应的文件中存在的任何 nodata 值。
pyramidingPolicy

enum (PyramidingPolicy)

“金字塔式”结构政策。

TilesetMaskBand

表示来自图块集的单个掩码带。

JSON 表示法 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
字段
tilesetId

string

与掩码带对应的图块集的 ID。图块集的最后一个带总是用作遮罩带。
bandIds[]

string

遮盖频段适用的频段的 ID。如果为空，则掩码带会应用于素材资源中的所有带。每个频段只能有一个对应的掩码频段。如果其中任何频段都有内部掩码，系统会忽略内部掩码，而采用此掩码频段。

PixelFootprint

图片中所有有效像素的足迹。

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

object (GridPoint)

用于构成简单多边形外部的圆环，必须包含图片的所有有效像素的中心。这必须是一个线性环：最后一个点必须等于第一个点。坐标采用 bandId 指定的波段的投影。

注意：请使用非整数坐标（例如每个像素的中心），因为只有当像素（1x1 矩形）与占位空间相交时，占位空间才会被视为包含该像素。为避免意外选择相邻像素，请勿使用整数值坐标，因为它们是像素之间的边界。沿像素中心绘制足迹可防止包含意外像素，因为当预期像素与地图边界（例如反经线或极点）相邻时，可能会导致错误。

例如，对于所有 4 个像素均有效的 2x2 图片，以下是可能的圆环之一：[{"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

相应 CRS 用于定义足迹坐标的波段的 ID。如果为空，则使用第一个频段。

GridPoint

二维点或矢量。

JSON 表示法 
{
  "x": number,
  "y": number
}
字段
x

number

x 坐标值。
y

number

y 坐标值。