Pengumuman: Semua project nonkomersial yang terdaftar untuk menggunakan Earth Engine sebelum 15 April 2025 harus memverifikasi kelayakan nonkomersial untuk mempertahankan akses Earth Engine.

Halaman ini diterjemahkan oleh Cloud Translation API.

Method: projects.map.export

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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter

Parameter
`project`	`string` Project ID atau nomor project project Google Cloud Platform yang harus diperlakukan sebagai konsumen layanan untuk permintaan ini. Format adalah `projects/{project-id}`. Otorisasi memerlukan izin IAM berikut pada resource `project` yang ditentukan: `earthengine.exports.create`

project

string

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

Otorisasi memerlukan izin IAM berikut pada resource project yang ditentukan:

earthengine.exports.create

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON

Representasi 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,
  "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 wilayah yang diekspor, potong gambar sebelum diekspor.
`description`	`string` Nama tugas yang dapat dibaca manusia.
`tileOptions`	`object (TileOptions)` Opsi yang menjelaskan ubin peta yang akan dibuat.
`tileExportOptions`	`object (ImageFileExportOptions)` Opsi untuk tempat dan format ekspor ubin peta. Cloud Storage saat ini adalah satu-satunya tujuan yang didukung untuk ekspor peta.
`requestId`	`string` String unik yang digunakan untuk mendeteksi permintaan yang diduplikasi. Jika lebih dari satu permintaan dibuat oleh pengguna yang sama dengan `requestId` yang sama dan tidak kosong, hanya satu dari permintaan tersebut yang dapat berhasil memulai operasi yang berjalan lama. `requestId` dapat berisi karakter a..z, A..Z, 0-9, atau '-'. `requestId` dapat berisi 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 akan dijadwalkan lebih cepat. 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

Representasi 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,
  "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.
}

Kolom
`startZoom`	`integer` Tingkat zoom untuk mulai membuat ubin peta untuk diekspor. Nilai defaultnya adalah nol.
`skipEmpty`	`boolean` Jika benar, lewati penulisan ubin peta kosong (yaitu sepenuhnya transparan).
`mapsApiKey`	`string` Kunci API Google Maps Platform opsional untuk penampil ubin peta yang dihasilkan.
`dimensions`	`object (GridDimensions)` Lebar dan tinggi ubin video output, yang hanya digunakan untuk mengekspor piramida video bersusun (ExportVideoMap).
`stride`	`integer` Langkah baris dan kolom kartu. (ExportVideoMap) Tetapkan ke 4 untuk ubin jarang (khusus WebGL) atau 1 (default) untuk kompatibilitas maksimum.
`zoomSubset`	`object (ZoomSubset)` Subkumpulan tingkat zoom yang akan digunakan untuk membuat ubin. Hanya dapat ditentukan dalam panggilan ke `ExportVideoMap`.
Kolom union `end_zoom_or_scale`. Tingkat zoom atau skala yang digunakan untuk berhenti membuat ubin peta. Salah satu dari keduanya harus ditentukan. `end_zoom_or_scale` hanya dapat berupa salah satu dari berikut:
`endZoom`	`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 ekuator.

ZoomSubset

Subkumpulan tingkat zoom yang akan digunakan untuk membuat ubin (ExportVideoMap), Subkumpulan awal dan akhir adalah nilai presisi ganda, yang memungkinkan Anda merender tingkat zoom secara bertahap. 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 (penuh) yang sama di start/endZoom.

Representasi JSON
{ "start": number, "end": number }

Kolom

Kolom
`start`	`number` Memulai subset tingkat zoom yang akan digunakan untuk membuat ubin (ExportVideoMap) Di sini, subset adalah nilai presisi ganda, yang memungkinkan Anda merender tingkat zoom secara bertahap, sehingga 12,1 misalnya adalah 10% pertama ubin dalam zoom 12 dalam beberapa urutan yang tidak ditentukan tetapi deterministik.
`end`	`number` Subset tingkat zoom akhir yang akan digunakan untuk membuat ubin (ExportVideoMap), yang memungkinkan Anda merender tingkat zoom secara bertahap, hingga tetapi tidak termasuk subset maksimum (jika disediakan) dalam beberapa urutan yang tidak ditentukan tetapi deterministik.

start

number

Memulai subset tingkat zoom yang akan digunakan untuk membuat ubin (ExportVideoMap) Di sini, subset adalah nilai presisi ganda, yang memungkinkan Anda merender tingkat zoom secara bertahap, sehingga 12,1 misalnya adalah 10% pertama ubin dalam zoom 12 dalam beberapa urutan yang tidak ditentukan tetapi deterministik.

end