Method: projects.table.import

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

HTTP-запрос

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

ТаблицаМанифест

Описывает, как служба 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 ))

Вместо этого используйте columnsDataTypeOverrides.

Объект, содержащий список пар "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

Поле произвольной формы для хранения заметок пользователя. Не используется при приеме внутрь.

ТаблицаИсточник

Табличный файл.

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, края в проекции прямые. Если это правда, края изогнуты, чтобы следовать кратчайшему пути на поверхности Земли. Если это поле пусто, по умолчанию используется значение false, если «crs» — это система координат проекции. Только для источников CSV/TFRecord.

primaryGeometryColumn

string

Столбец геометрии, который будет использоваться в качестве основной геометрии строки, если имеется более одного столбца геометрии.

Если оставить пустым и существует более одного столбца геометрии, используется первый встреченный столбец геометрии. Только для источников CSV/TFRecord.

xColumn

string

Имя столбца числовых координат X для определения геометрии точки. Если также указан yColumn и оба столбца содержат числовые значения, то столбец геометрии точки будет построен со значениями x, y в системе координат, заданной в «crs». Если оставить пустым и в поле «crs» не указана система координат проекции, по умолчанию используется «долгота». Если оставить пустым и «crs» указывает систему координат проекции, по умолчанию используется значение «», и точечная геометрия не создается.

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

yColumn

string

Имя столбца числовых координат Y для определения геометрии точки. Если также указан xColumn и оба столбца содержат числовые значения, то столбец геометрии точки будет построен со значениями x,y в системе координат, заданной в 'crs'. Если оставить пустым и в поле «crs» не указана система координат проекции, по умолчанию используется «широта». Если оставить пустым и «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" <== пробелы удаляются

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