Method: projects.table.import

Импортирует таблицу.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
project

string

Идентификатор проекта или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для данного запроса. Формат: projects/{project-id} .

Для авторизации требуются следующие разрешения IAM для указанного project ресурсов:

  • 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-представление
{
  "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
}
Поля
uris[]

string

URI данных для импорта. В настоящее время поддерживаются только URI Google Cloud Storage. Каждый 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, и оба столбца содержат числовые значения, то будет создан столбец геометрии точки со значениями x,y в системе координат, указанной в 'crs'. Если оставить поле пустым и 'crs' не указывает проекционную систему координат, по умолчанию используется "longitude". Если оставить поле пустым и 'crs' указывает проекционную систему координат, по умолчанию используется "", и геометрия точки не будет сгенерирована.

Созданный столбец с геометрией точек будет называться {xColumn}_{yColumn}_N, где N добавляется таким образом, что {xColumn}_{yColumn}_N является уникальным, если столбец с именем {xColumn}_{yColumn} уже существует. Только для источников CSV/TFRecord.

yColumn

string

Название столбца с числовыми координатами y для определения геометрии точки. Если также указан столбец xColumn, и оба столбца содержат числовые значения, то будет создан столбец геометрии точки со значениями x,y в системе координат, заданной в 'crs'. Если оставить поле пустым и 'crs' не указывает проекционную систему координат, по умолчанию используется "latitude". Если оставить поле пустым и 'crs' указывает проекционную систему координат, по умолчанию используется "", и геометрия точки не будет сгенерирована.

Созданный столбец с геометрией точек будет называться {xColumn}_{yColumn}_N, где N добавляется таким образом, что {xColumn}_{yColumn}_N является уникальным, если столбец с именем {xColumn}_{yColumn} уже существует. Только для источников 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" <== пробелы удаляются

где: ...," тест",... <== это значение, заключенное в кавычки, становится строковым значением: " тест" <== пробел остается!