Method: dataLayers.get

Mendapatkan informasi tenaga surya untuk wilayah di sekitar suatu lokasi. Menampilkan error dengan kode NOT_FOUND jika lokasi berada di luar area cakupan.

Permintaan HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Bujur dan lintang untuk bagian tengah wilayah guna mendapatkan data.

radiusMeters

number

Wajib. Radius, dalam meter, yang menentukan wilayah di sekitar titik pusat yang datanya harus ditampilkan. Batasan pada nilai ini adalah:

  • Nilai apa pun hingga 100 m selalu dapat ditentukan.
  • Nilai di atas 100 m dapat ditentukan, asalkan radiusMeters <= pixelSizeMeters * 1000.
  • Namun, untuk nilai di atas 175 m, DataLayerView dalam permintaan tidak boleh menyertakan fluks bulanan atau naungan per jam.
view

enum (DataLayerView)

Opsional. Subset data yang diinginkan untuk ditampilkan.

requiredQuality

enum (ImageryQuality)

Opsional. Tingkat kualitas minimum yang diizinkan dalam hasil. Tidak ada hasil dengan kualitas yang lebih rendah dari ini yang akan ditampilkan. Tidak menentukannya sama dengan membatasi hanya pada kualitas TINGGI.

pixelSizeMeters

number

Opsional. Skala minimum, dalam meter per piksel, dari data yang akan ditampilkan. Nilai 0,1 (default, jika kolom ini tidak ditetapkan secara eksplisit), 0,25, 0,5, dan 1,0 didukung. Komponen gambar yang resolusi normalnya kurang dari pixelSizeMeters akan ditampilkan pada resolusi yang ditentukan oleh pixelSizeMeters; komponen gambar yang resolusi normalnya sama dengan atau lebih besar dari pixelSizeMeters akan ditampilkan pada resolusi normal tersebut.

exactQualityRequired

boolean

Opsional. Apakah akan mewajibkan kualitas gambar yang tepat. Jika disetel ke false, kolom requiredQuality ditafsirkan sebagai kualitas minimum yang diperlukan, sehingga gambar berkualitas TINGGI dapat ditampilkan saat requiredQuality disetel ke SEDANG. Jika disetel ke benar (true), requiredQuality ditafsirkan sebagai kualitas yang diperlukan dan hanya gambar berkualitas MEDIUM yang ditampilkan jika requiredQuality disetel ke MEDIUM.

experiments[]

enum (Experiment)

Opsional. Menentukan eksperimen pra-GA yang akan diaktifkan. Permintaan yang menggunakan kolom ini diklasifikasikan sebagai penawaran pra-GA berdasarkan Persyaratan Khusus Layanan Google Maps Platform. Lihat [deskripsi tahap peluncuran]( https://cloud.google.com/maps-platform/terms/launch-stages) untuk mengetahui detail selengkapnya.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance DataLayers.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

DataLayerView

Subset informasi surya yang akan ditampilkan.

Enum
DATA_LAYER_VIEW_UNSPECIFIED Setara dengan FULL.
DSM_LAYER Dapatkan DSM saja.
IMAGERY_LAYERS Dapatkan DSM, RGB, dan mask.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Dapatkan DSM, RGB, mask, dan fluks tahunan.
IMAGERY_AND_ALL_FLUX_LAYERS Dapatkan DSM, RGB, mask, fluks tahunan, dan fluks bulanan.
FULL_LAYERS Mendapatkan semua data.