Method: dataLayers.get

Mendapatkan informasi tenaga surya untuk wilayah di sekitar 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 menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Bujur dan lintang untuk bagian tengah wilayah yang datanya akan diperoleh.

radiusMeters

number

Wajib. Radius, dalam meter, menentukan wilayah di sekitar titik pusat tersebut tempat data harus ditampilkan. Batasan untuk nilai ini adalah:

  • Nilai apa pun hingga 100 juta selalu dapat ditentukan.
  • Nilai yang lebih dari 100 m dapat ditentukan, selama radiusMeters <= pixelSizeMeters * 1000.
  • Namun, untuk nilai yang lebih dari 175 m, DataLayerView dalam permintaan tidak boleh menyertakan fluks bulanan atau bayangan 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 daripada yang akan ditampilkan. Tidak menentukan ini sama dengan membatasi ke kualitas TINGGI saja.

pixelSizeMeters

number

Opsional. Skala minimum data yang akan ditampilkan, dalam meter per piksel. 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 memerlukan kualitas gambar yang tepat. Jika disetel ke salah (false), kolom requiredQuality akan ditafsirkan sebagai kualitas minimum yang diperlukan, sehingga gambar berkualitas TINGGI dapat ditampilkan saat requiredQuality disetel ke SEDANG. Jika ditetapkan ke benar (true), requiredQuality akan ditafsirkan sebagai kualitas yang sama persis dengan yang diperlukan dan hanya gambar berkualitas MEDIUM yang akan ditampilkan jika requiredQuality disetel ke MEDIUM.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance DataLayers.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

DataLayerView

Bagian informasi surya yang akan ditampilkan.

Enum
DATA_LAYER_VIEW_UNSPECIFIED Setara dengan FULL.
DSM_LAYER Dapatkan DSM saja.
IMAGERY_LAYERS Mendapatkan 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 Dapatkan semua data.