Method: projects.maps.create

Membuat ID yang dapat digunakan untuk merender ubin peta yang menampilkan hasil komputasi. ID yang dihasilkan harus digunakan sebagai bagian dari permintaan GetTile.

Ini digunakan bersama dengan GetTile. Panggilan ke maps.create memberikan ekspresi dan beberapa opsi output. Hasil maps.create adalah ID peta yang mewakili gambar yang merupakan hasil dari mengevaluasi ekspresi tersebut dan menerapkan opsi tersebut. Selanjutnya, panggilan ke GetTile dapat dilakukan untuk mendapatkan data gambar untuk ubin gambar yang dihasilkan, di lokasi dan zoom yang diinginkan. ID peta akan valid selama jangka waktu sedang (beberapa jam).

Kasus penggunaan yang paling umum untuk pasangan endpoint ini adalah mengisi area pandang peta dengan visualisasi output dari beberapa komputasi. Agar hal itu dapat dilakukan, output komputasi harus memenuhi beberapa persyaratan yang wajar untuk format gambar yang diminta. Secara khusus, format JPEG atau PNG mengharuskan adanya satu atau tiga band output, dan memotong nilai yang berada di luar rentang 0-255.

Permintaan HTTP

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/maps

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Induk koleksi peta (misalnya, "projects/*").

Otorisasi memerlukan izin IAM berikut pada resource parent yang ditentukan:

  • earthengine.maps.create

Parameter kueri

Parameter
workloadTag

string

Tag yang diberikan pengguna untuk melacak komputasi ini.

Isi permintaan

Isi permintaan memuat instance EarthEngineMap.

Isi respons

Jika berhasil, isi respons memuat instance EarthEngineMap yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.