Method: projects.map.export

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

HTTP-запрос

POST https://earthengine.googleapis.com/v1/{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 ) Варианты выбора места и формата экспорта фрагментов карты. В настоящее время единственным поддерживаемым местом для экспорта карт является облачное хранилище.
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 .

TileOptions

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

JSON-представление
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (GridDimensions) }, "stride": integer, "zoomSubset": { object (ZoomSubset) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "endZoom": integer, "scale": number // End of mutually exclusive fields. }

Поля
startZoom	integer Уровень масштабирования, с которого начинается генерация фрагментов карты для экспорта. По умолчанию — ноль.
skipEmpty	boolean Если это так, пропустите запись пустых (т.е. полностью прозрачных) фрагментов карты.
mapsApiKey	string Необязательный ключ API платформы Google Maps для средства просмотра сгенерированных фрагментов карты.
dimensions	object ( GridDimensions ) Ширина и высота выходных видеоплиток, используемых только для экспорта видеопирамид, состоящих из отдельных плиток (ExportVideoMap).
stride	integer Шаг по строкам и столбцам тайлов. (ExportVideoMap) Установите значение 4 для разреженных тайлов (только WebGL) или 1 (по умолчанию) для максимальной совместимости.
zoomSubset	object ( ZoomSubset ) Подмножество уровней масштабирования, для которых следует создавать тайлы. Может быть указано только в вызове функции ExportVideoMap .
Уровень масштабирования, при котором следует прекратить генерацию фрагментов карты. Необходимо указать либо один, либо другой из этих параметров. Ниже приведен список взаимоисключающих полей. В ответе будет установлено не более одного из этих полей:
endZoom	integer Уровень масштабирования, при котором прекращается генерация фрагментов карты.
scale	number Максимальное разрешение изображения в метрах на пиксель. Масштаб будет преобразован в наиболее подходящий максимальный уровень масштабирования на экваторе.
Конец взаимоисключающих областей.

ZoomSubset

Подмножество уровней масштабирования, для которых генерируются тайлы (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 } Также обратите внимание, что все экспортируемые фрагменты должны иметь одинаковый (полный) размер пирамиды в startZoom/endZoom.

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

Поля
start	number Начальный подмножество уровней масштабирования, для которых будут генерироваться тайлы (ExportVideoMap). Здесь subset — это значение с двойной точностью, позволяющее отображать уровень масштабирования постепенно, так что, например, 12.1 — это первые 10% тайлов в масштабе 12 в некотором неопределенном, но детерминированном порядке.
end	number Завершающий подмножество уровней масштабирования, для которых следует генерировать тайлы (ExportVideoMap), позволяющий отображать уровень масштабирования постепенно, вплоть до максимального подмножества (если оно указано), но не включая его, в некотором неопределенном, но детерминированном порядке.