Method: dataLayers.get

Mendapatkan informasi 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 akan mendapatkan data.

radiusMeters

number

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

  • Nilai apa pun hingga 100 m selalu dapat ditentukan.
  • Nilai di atas 100 m dapat ditentukan, selama radiusMeters <= pixelSizeMeters * 1000.
  • Namun, untuk nilai di atas 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 dari ini yang akan ditampilkan. Jika tidak ditentukan, hal ini sama dengan membatasi kualitas ke TINGGI saja.

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 ditetapkan ke salah (false), kolom requiredQuality akan ditafsirkan sebagai kualitas minimum yang diperlukan, sehingga gambar berkualitas TINGGI dapat ditampilkan saat requiredQuality ditetapkan ke SEDANG. Jika ditetapkan ke benar (true), requiredQuality akan ditafsirkan sebagai kualitas yang diperlukan secara persis dan hanya gambar berkualitas MEDIUM yang ditampilkan jika requiredQuality ditetapkan ke MEDIUM.

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 Mendapatkan DSM saja.
IMAGERY_LAYERS Mendapatkan DSM, RGB, dan mask.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Mendapatkan DSM, RGB, mask, dan fluks tahunan.
IMAGERY_AND_ALL_FLUX_LAYERS Mendapatkan DSM, RGB, mask, fluks tahunan, dan fluks bulanan.
FULL_LAYERS Mendapatkan semua data.