Method: projects.map.export

Инициирует пакетный процесс, который вычисляет мозаичную карту и записывает результат в Google Cloud Storage.

HTTP-запрос

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

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

Параметры
project

string

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

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

  • earthengine.exports.create

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Поля
expression

object ( Expression )

Выражение, которое возвращает изображение для вычисления и экспорта. Границы изображения будут использоваться для определения набора фрагментов карты для рендеринга. Чтобы контролировать экспортируемую область, вырежьте изображение перед экспортом.

description

string

Удобочитаемое имя задачи.

tileOptions

object ( TileOptions )

Параметры, описывающие генерируемые фрагменты карты.

tileExportOptions

object ( ImageFileExportOptions )

Варианты, куда и в каком виде экспортировать фрагменты карты. Cloud Storage в настоящее время является единственным поддерживаемым местом для экспорта карт.

requestId

string

Уникальная строка, используемая для обнаружения повторяющихся запросов. Если один и тот же пользователь выполняет более одного запроса с одним и тем же непустым requestId , только один из этих запросов может успешно запустить длительную операцию. requestId может содержать символы a..z, A..Z, 0–9 или «-». requestId может иметь длину не более 60 символов.

workloadTag

string

Предоставленная пользователем метка для отслеживания этого вычисления.

priority

integer

Необязательный. Приоритет экспортной задачи в рамках проекта. Задачи с более высоким приоритетом планируются раньше. Должно быть целым числом от 0 до 9999. По умолчанию — 100, если не установлено.

Тело ответа

В случае успеха тело ответа содержит экземпляр Operation .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

Для получения дополнительной информации см.OAuth 2.0 Overview .

Параметры плитки

Параметры, описывающие фрагменты изображения или видеокарты для экспорта.

JSON-представление
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
Поля
startZoom

integer

Уровень масштабирования, позволяющий начать создание фрагментов карты для экспорта. По умолчанию равно нулю.

skipEmpty

boolean

Если это правда, пропустите запись пустых (т.е. полностью прозрачных) фрагментов карты.

mapsApiKey

string

Дополнительный ключ API платформы Google Maps для просмотра созданных фрагментов карты.

dimensions

object ( GridDimensions )

Ширина и высота выходных фрагментов видео, используются только для экспорта мозаичных пирамидальных видео (ExportVideoMap).

stride

integer

Шаг строки и столбца плитки. (ExportVideoMap) Установите значение 4 для редких фрагментов (только для WebGL) или 1 (по умолчанию) для максимальной совместимости.

zoomSubset

object ( ZoomSubset )

Подмножество уровней масштабирования, для которых создаются плитки. Может быть указано только при вызове ExportVideoMap .

Поле объединения end_zoom_or_scale . Уровень масштабирования или масштаб, при котором прекращается создание фрагментов карты. Необходимо указать тот или иной из них. end_zoom_or_scale может быть только одним из следующих:
endZoom

integer

Уровень масштабирования, для которого прекращается создание фрагментов карты.

scale

number

Максимальное разрешение изображения в метрах на пиксель. Масштаб будет преобразован в наиболее подходящий максимальный уровень масштабирования на экваторе.

ZoomПодмножество

Подмножество уровней масштабирования, для которого создаются фрагменты (ExportVideoMap). Начальное и конечное подмножества представляют собой значения двойной точности, что позволяет отображать уровень или уровни масштабирования постепенно. Чтобы визуализировать всю пирамиду с начальным масштабом 12: startZoom=0, endZoom=12, не устанавливайте это сообщение. Для рендеринга уровней 0-11 и первых 10% уровня 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Для рендеринга следующих 10% уровня 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Для рендеринга оставшихся 80% уровня 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Также обратите внимание, что все сегменты экспорта должны иметь одинаковый (полный) размер пирамиды в start/endZoom.

JSON-представление
{
  "start": number,
  "end": number
}
Поля
start

number

Начальное подмножество уровней масштабирования, для которого создаются фрагменты (ExportVideoMap). Здесь подмножество представляет собой значение двойной точности, позволяющее отображать уровень масштабирования постепенно, поэтому, например, 12,1 — это первые 10 % фрагментов при масштабировании 12 в каком-то неопределенном, но детерминированном порядке.

end

number

Конечное подмножество уровней масштабирования, для которого создаются фрагменты (ExportVideoMap), позволяющее отображать уровень масштабирования постепенно, вплоть до максимального подмножества (если оно предусмотрено), но не включая его, в каком-то неопределенном, но детерминированном порядке.