此页面由 Cloud Translation API 翻译。

Method: projects.table.import

导入表。

HTTP 请求

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:import

网址采用 gRPC 转码语法。

路径参数

参数

参数
`project`	`string` 应被视为此请求的服务使用方的 Google Cloud Platform 项目的项目 ID 或项目编号。格式为 `projects/{project-id}`。必须对指定的资源 `project` 具有以下 IAM 权限才能进行授权： `earthengine.assets.create`

project

string

应被视为此请求的服务使用方的 Google Cloud Platform 项目的项目 ID 或项目编号。格式为 projects/{project-id}。

必须对指定的资源 project 具有以下 IAM 权限才能进行授权：

earthengine.assets.create

请求正文

请求正文中包含结构如下的数据：

JSON 表示法
{ "tableManifest": { object (`TableManifest`) }, "description": string, "overwrite": boolean, "requestId": string }

字段
`tableManifest`	`object (TableManifest)` 表清单。
`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。

TableManifest

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

JSON 表示法

JSON 表示法
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object (`TableSource`) } ], "startTime": string, "endTime": string, "csvColumnDataTypeOverrides": { string: enum (`CsvColumnDataType`), ... }, "columnDataTypeOverrides": { string: enum (`ColumnDataType`), ... }, "memo": string }

{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "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` 前面附加的可选前缀。
`sources[]`	`object (TableSource)` 构成此表的来源。
`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"`。
`csvColumnDataTypeOverrides (deprecated)`	`map (key: string, value: enum (CsvColumnDataType))` 此项已弃用！请改用 columnDataTypeOverrides。包含一系列 `"key": value` 对的对象。示例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`columnDataTypeOverrides`	`map (key: string, value: enum (ColumnDataType))` 将列名称映射到要为该列使用的类型的映射。系统会推断此处未指定的列的类型，例如数字列会变为数字，WKT 列会变为几何图形等。包含一系列 `"key": value` 对的对象。示例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。
`memo`	`string` 用于存储用户备注的自定义字段。在提取过程中不使用。

TableSource

表文件。

JSON 表示法
{ "uris": [ string ], "charset": string, "maxErrorMeters": number, "maxVertices": integer, "crs": string, "geodesic": boolean, "primaryGeometryColumn": string, "xColumn": string, "yColumn": string, "dateFormat": string, "csvDelimiter": string, "csvQualifier": string }

JSON 表示法

{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}

字段
`uris[]`	`string` 要导入的数据的 URI。目前，仅支持 Google Cloud Storage URI。每个 URI 都必须采用以下格式：“gs://bucket-id/object-id”。主对象应是列表中的第一项，系统会根据主对象的文件路径推断出附加文件。目前仅支持一个 URI。如果指定多个 URI，系统会返回 `INALID_ARGUMENT` 错误。
`charset`	`string` 用于解码字符串的默认字符集的名称。如果为空，则默认使用字符集“utf-8”。
`maxErrorMeters`	`number` 在坐标系之间转换几何图形时允许的最大误差（以米为单位）。如果为空，则默认最大误差为 1 米。
`maxVertices`	`integer` 顶点的数量上限。如果不为零，则几何图形将被细分为空间上不相交的部分，每个部分都低于此限制。
`crs`	`string` 默认的 CRS 代码或 WKT 字符串，用于指定未指定坐标参考系统的任何几何图形的坐标参考系统。如果留空，则默认值为 EPSG:4326：https://epsg.io/4326。仅适用于 CSV/TFRecord 来源。
`geodesic`	`boolean` 用于解读未另行指定边的几何图形的默认策略。如果为 false，投影中的边缘是直线。如果为 true，边缘会弯曲以沿地球表面上的最短路径延伸。如果为空，则默认为 false（如果“crs”是投影坐标系）。仅适用于 CSV/TFRecord 来源。
`primaryGeometryColumn`	`string` 当存在多个几何图形列时，要用作行的主要几何图形的列。如果留空且存在多个几何图形列，则使用遇到的第一个几何图形列。仅适用于 CSV/TFRecord 来源。
`xColumn`	`string` 用于推断点几何图形的数值 x 坐标列的名称。如果还指定了 yColumn，并且这两个列都包含数值，则系统会使用“crs”中给定坐标系中的 x,y 值构建点几何图形列。如果留空且“crs”未指定投影坐标系，则默认为“经度”。如果留空，且“crs”指定了投影坐标系，则默认为“”，并且不会生成点几何图形。生成的点几何图形列将命名为 {xColumn}_{yColumn}_N，其中 N 是附加的数字，以便在已存在名为 {xColumn}_{yColumn} 的列的情况下，{xColumn}_{yColumn}_N 是唯一的。仅适用于 CSV/TFRecord 来源。
`yColumn`	`string` 用于推断点几何图形的数值 y 坐标列的名称。如果还指定了 xColumn，并且这两个列都包含数值，则系统会使用“crs”中给定坐标系中的 x,y 值构建点几何图形列。如果留空且“crs”未指定投影坐标系，则默认为“纬度”。如果留空，且“crs”指定了投影坐标系，则默认为“”，并且不会生成点几何图形。生成的点几何图形列将命名为 {xColumn}_{yColumn}_N，其中 N 是附加的数字，以便在已存在名为 {xColumn}_{yColumn} 的列的情况下，{xColumn}_{yColumn}_N 是唯一的。仅适用于 CSV/TFRecord 来源。
`dateFormat`	`string` 用于解析编码日期的字段的格式。格式模式必须符合 http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html 中的说明。如果留空，日期将作为字符串导入。仅适用于 CSV/TFRecord 来源。
`csvDelimiter`	`string` 提取 CSV 文件时，用于在一行中的列值之间作为分隔符的单个字符。如果留空，则默认为“,”。仅适用于 CSV 来源。
`csvQualifier`	`string` 在提取 CSV 文件时，用于括起列值的字符（也称为“引号字符”）。如果留空，则默认为“”。仅适用于 CSV 来源。如果列值未用限定符括起来，系统会截去前导和尾随空格。例如：..., test,... <== 此值不符合条件，将变为字符串值：“test”<== 空格已被移除 where: ...," test",... <== this value IS qualified with quotes becomes the string value: " test" <== whitespace remains!