Method: projects.map.export

Memulai proses batch yang menghitung peta berpetak dan menulis hasilnya ke Google Cloud Storage.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
project

string

ID project atau nomor project Google Cloud Platform yang harus diperlakukan sebagai konsumen layanan untuk permintaan ini. Format adalah projects/{project-id}.

Otorisasi memerlukan izin IAM berikut pada project resource yang ditentukan:

  • earthengine.exports.create

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Kolom
expression

object (Expression)

Ekspresi yang dievaluasi ke gambar yang akan dihitung dan diekspor. Batas gambar akan digunakan untuk menentukan kumpulan ubin peta yang akan dirender. Untuk mengontrol area yang diekspor, klip gambar sebelum diekspor.
description

string

Nama tugas yang dapat dibaca manusia.
tileOptions

object (TileOptions)

Opsi yang menjelaskan petak peta yang akan dibuat.
tileExportOptions

object (ImageFileExportOptions)

Opsi untuk mengekspor petak peta, baik lokasi maupun bentuknya. Saat ini, Cloud Storage adalah satu-satunya tujuan yang didukung untuk ekspor peta.
requestId

string

String unik yang digunakan untuk mendeteksi permintaan yang diduplikasikan. Jika lebih dari satu permintaan dibuat oleh pengguna yang sama dengan requestId yang sama dan tidak kosong, hanya salah satu permintaan tersebut yang dapat berhasil memulai operasi yang berjalan lama. requestId dapat berisi karakter a..z, A..Z, 0-9, atau '-'. Panjang requestId maksimal 60 karakter.
workloadTag

string

Label yang diberikan pengguna untuk melacak komputasi ini.
priority

integer

Opsional. Prioritas tugas ekspor dalam project. Tugas dengan prioritas lebih tinggi dijadwalkan lebih awal. Harus berupa bilangan bulat antara 0 dan 9999. Jika tidak ditetapkan, defaultnya adalah 100.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

TileOptions

Opsi yang menjelaskan ubin peta gambar atau video yang akan diekspor.

Representasi JSON 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    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,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Kolom
startZoom

integer

Tingkat zoom untuk mulai membuat ubin peta untuk diekspor. Nilai defaultnya adalah nol.
minZoom
(deprecated)

integer

Tingkat zoom untuk mulai membuat ubin peta untuk diekspor. Nilai defaultnya adalah nol.
skipEmpty

boolean

Jika benar, lewati penulisan petak peta kosong (yaitu sepenuhnya transparan).
skipEmptyTiles
(deprecated)

boolean

Jika benar, lewati penulisan petak peta kosong (yaitu sepenuhnya transparan).
mapsApiKey

string

Kunci API Google Maps Platform opsional untuk penampil petak peta yang dibuat.
dimensions

object (GridDimensions)

Lebar dan tinggi petak video output, hanya digunakan untuk mengekspor piramida video berpetak (ExportVideoMap).
tileDimensions
(deprecated)

object (GridDimensions)

Lebar dan tinggi petak video output, hanya digunakan untuk mengekspor piramida video berpetak (ExportVideoMap).
stride

integer

Langkah baris dan kolom petak. (ExportVideoMap) Setel ke 4 untuk petak jarang (khusus WebGL) atau 1 (default) untuk kompatibilitas maksimum.
zoomSubset

object (ZoomSubset)

Subkumpulan tingkat zoom untuk membuat petak. Hanya dapat ditentukan dalam panggilan ke ExportVideoMap.
Tingkat zoom atau skala untuk menghentikan pembuatan ubin peta. Salah satu dari keduanya harus ditentukan. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
endZoom

integer

Tingkat zoom untuk berhenti membuat ubin peta.
maxZoom
(deprecated)

integer

Tingkat zoom untuk berhenti membuat ubin peta.
scale

number

Resolusi gambar maksimum dalam meter per piksel. Skala akan dikonversi ke tingkat zoom maksimum yang paling sesuai di khatulistiwa.
Akhir kolom yang saling eksklusif.

ZoomSubset

Subkumpulan tingkat zoom untuk membuat petak (ExportVideoMap), Subkumpulan awal dan akhir adalah nilai presisi ganda, sehingga Anda dapat merender satu atau beberapa tingkat zoom secara inkremental. Untuk merender seluruh piramida dengan zoom awal 12: startZoom=0, endZoom=12, jangan tetapkan pesan ini. Untuk merender level 0-11 dan 10% pertama level 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Untuk merender 10% berikutnya dari level 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Untuk merender 80% sisanya dari level 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Perhatikan juga bahwa semua shard ekspor harus memiliki ukuran piramida yang sama (penuh) di start/endZoom.

Representasi JSON 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
Kolom
start

number

Subkumpulan tingkat zoom awal untuk membuat petak (ExportVideoMap) Di sini, subkumpulan adalah nilai presisi ganda, yang memungkinkan Anda merender tingkat zoom secara bertahap, jadi 12.1 misalnya adalah 10% pertama petak di zoom 12 dalam urutan yang tidak ditentukan tetapi deterministik.
end

number

Subkumpulan tingkat zoom akhir untuk membuat petak (ExportVideoMap), yang memungkinkan Anda merender tingkat zoom secara bertahap, hingga tetapi tidak termasuk subkumpulan maksimum (jika disediakan) dalam beberapa urutan yang tidak ditentukan tetapi deterministik.
min
(deprecated)

number

Subkumpulan tingkat zoom awal untuk membuat petak (ExportVideoMap) Di sini, subkumpulan adalah nilai presisi ganda, yang memungkinkan Anda merender tingkat zoom secara bertahap, jadi 12.1 misalnya adalah 10% pertama petak di zoom 12 dalam urutan yang tidak ditentukan tetapi deterministik.
max
(deprecated)

number

Subkumpulan tingkat zoom akhir untuk membuat petak (ExportVideoMap), yang memungkinkan Anda merender tingkat zoom secara bertahap, hingga tetapi tidak termasuk subkumpulan maksimum (jika disediakan) dalam beberapa urutan yang tidak ditentukan tetapi deterministik.