Импортирует таблицу.
HTTP-запрос
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:import
В URL-адресе используется синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
project | Идентификатор проекта или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для данного запроса. Формат: Для авторизации требуются следующие разрешения IAM для указанного
|
Текст запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"tableManifest": {
object ( |
| Поля | |
|---|---|
tableManifest | Таблица учета. |
description | Удобочитаемое название задачи. |
overwrite | Разрешить ли перезапись существующего актива. |
requestId | Уникальная строка, используемая для обнаружения дублирующихся запросов. Если один и тот же пользователь отправляет более одного запроса с одинаковым непустым |
Ответный текст
В случае успеха тело ответа содержит экземпляр 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 ( |
| Поля | |
|---|---|
name | Название создаваемого ресурса. |
properties | Дополнительные свойства ресурса. Названия свойств "system:time_start" и "system:time_end" устарели. Вместо них используйте поля |
uriPrefix | Необязательный префикс, добавляемый перед всеми |
sources[] | Источники, из которых составлена эта таблица. |
startTime | Временная метка, связанная с активом, если таковая имеется, например, время получения спутникового снимка. Для активов, соответствующих временному интервалу, например, средним значениям за месяц или год, эта временная метка соответствует началу этого интервала. Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
endTime | Для активов, соответствующих определенному временному интервалу, например, средним значениям за месяц или год, эта временная метка соответствует концу этого интервала (исключая его). Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
csvColumnDataTypeOverrides | Вместо этого используйте columnDataTypeOverrides. Объект, содержащий список пар |
columnDataTypeOverrides | Сопоставление имени столбца с типом данных, используемым для этого столбца. Для столбцов, не указанных здесь, тип будет определен автоматически: числовые столбцы станут числовыми, столбцы WKT — геометрическими и т. д. Объект, содержащий список пар |
memo | Поле произвольной формы для хранения заметок пользователя. Не используется при загрузке данных. |
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[] | URI данных для импорта. В настоящее время поддерживаются только URI Google Cloud Storage. Каждый URI должен быть указан в следующем формате: "gs://bucket-id/object-id". Основной объект должен быть первым элементом списка, файлы-контейнеры определяются по пути к основному объекту. В настоящее время поддерживается только один URI. Если указано более одного URI, возвращается ошибка |
charset | Название кодировки по умолчанию, используемой для декодирования строк. Если поле пустое, по умолчанию используется кодировка "utf-8". |
maxErrorMeters | Максимально допустимая погрешность в метрах при преобразовании геометрии между системами координат. Если поле пустое, по умолчанию максимальная погрешность составляет 1 метр. |
maxVertices | Максимальное количество вершин. Если оно не равно нулю, геометрия будет разделена на пространственно непересекающиеся части, каждая из которых не превышает этот предел. |
crs | Код CRS по умолчанию или строка WKT, указывающая систему координат для любой геометрии, для которой она не указана. Если оставить поле пустым, по умолчанию будет использоваться EPSG:4326: https://epsg.io/4326 . Только для источников CSV/TFRecord. |
geodesic | Стратегия по умолчанию для интерпретации ребер в геометрических объектах, для которых не указана иная стратегия. Если значение равно false, ребра прямые в проекции. Если значение равно true, ребра изогнуты, чтобы следовать кратчайшему пути по поверхности Земли. Если поле пустое, значение по умолчанию равно false, если 'crs' — это проекционная система координат. Только для источников CSV/TFRecord. |
primaryGeometryColumn | Столбец с геометрическими параметрами, используемый в качестве основного геометрического параметра строки, если таких столбцов несколько. Если поле оставить пустым и существует более одного столбца с геометрическими данными, будет использоваться первый найденный столбец с геометрическими данными. Только для источников CSV/TFRecord. |
xColumn | Название столбца с числовыми координатами x для определения геометрии точки. Если также указан столбец yColumn, и оба столбца содержат числовые значения, то будет создан столбец геометрии точки со значениями x,y в системе координат, указанной в 'crs'. Если оставить поле пустым и 'crs' не указывает проекционную систему координат, по умолчанию используется "longitude". Если оставить поле пустым и 'crs' указывает проекционную систему координат, по умолчанию используется "", и геометрия точки не будет сгенерирована. Созданный столбец с геометрией точек будет называться {xColumn}_{yColumn}_N, где N добавляется таким образом, что {xColumn}_{yColumn}_N является уникальным, если столбец с именем {xColumn}_{yColumn} уже существует. Только для источников CSV/TFRecord. |
yColumn | Название столбца с числовыми координатами y для определения геометрии точки. Если также указан столбец xColumn, и оба столбца содержат числовые значения, то будет создан столбец геометрии точки со значениями x,y в системе координат, заданной в 'crs'. Если оставить поле пустым и 'crs' не указывает проекционную систему координат, по умолчанию используется "latitude". Если оставить поле пустым и 'crs' указывает проекционную систему координат, по умолчанию используется "", и геометрия точки не будет сгенерирована. Созданный столбец с геометрией точек будет называться {xColumn}_{yColumn}_N, где N добавляется таким образом, что {xColumn}_{yColumn}_N является уникальным, если столбец с именем {xColumn}_{yColumn} уже существует. Только для источников CSV/TFRecord. |
dateFormat | Формат для анализа полей, кодирующих даты. Шаблон формата должен соответствовать описанию по адресу http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html . Если оставить поле пустым, даты будут импортированы как строки. Только для источников CSV/TFRecord. |
csvDelimiter | При импорте CSV-файлов в качестве разделителя между значениями столбцов в строке используется один символ. Если оставить поле пустым, по умолчанию используется запятая (','). Только для CSV-источников. |
csvQualifier | При импорте CSV-файлов используется символ, заключающий значения столбцов в кавычки. Если оставить поле пустым, по умолчанию используется "". Только для CSV-источников. Если значение столбца не окружено квалификаторами, начальные и конечные пробелы удаляются. Например: ..., test,... <== это значение не окружено квалификаторами, становится строковым значением: "test" <== пробелы удаляются где: ...," тест",... <== это значение, заключенное в кавычки, становится строковым значением: " тест" <== пробел остается! |