REST Resource: dataLayers

Resource: DataLayers

Informasi tentang potensi tenaga surya di suatu wilayah. Data sebenarnya terdapat dalam sejumlah file GeoTIFF yang mencakup wilayah yang diminta, yang URL-nya terdapat dalam pesan ini: Setiap string dalam pesan DataLayers berisi URL yang dapat digunakan untuk mengambil GeoTIFF yang sesuai. URL ini valid selama beberapa jam setelah dibuat. Sebagian besar file GeoTIFF memiliki resolusi 0,1 m/piksel, tetapi file fluks bulanan memiliki resolusi 0,5 m/piksel, dan file naungan per jam memiliki resolusi 1 m/piksel. Jika nilai pixelSizeMeters ditentukan dalam GetDataLayersRequest, resolusi minimum dalam file GeoTIFF akan menjadi nilai tersebut.

Representasi JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Kolom
imageryDate

object (Date)

Waktu pengambilan gambar sumber (yang menjadi dasar semua data lainnya) di wilayah ini. Gambar tersebut tentu saja agak mendekati, karena gambar mungkin diambil selama lebih dari satu hari.
imageryProcessedDate

object (Date)

Saat pemrosesan selesai pada gambar ini.
dsmUrl

string

URL untuk gambar DSM (Digital Surface Model) wilayah. Nilai dalam meter di atas geoid EGM96 (yaitu, permukaan laut). Lokasi yang tidak valid (tempat kami tidak memiliki data) disimpan sebagai -9999.
rgbUrl

string

URL untuk gambar data RGB (foto udara) wilayah.
maskUrl

string

URL untuk gambar mask bangunan: satu bit per piksel yang menyatakan apakah piksel tersebut dianggap sebagai bagian dari atap atau tidak.
annualFluxUrl

string

URL untuk peta fluks tahunan (cahaya matahari tahunan di atap) wilayah tersebut. Nilainya adalah kWh/kW/tahun. Ini adalah fluks yang tidak tertutup: fluks dihitung untuk setiap lokasi, bukan hanya atap bangunan. Lokasi yang tidak valid disimpan sebagai -9999: lokasi di luar area cakupan kami akan tidak valid, dan beberapa lokasi di dalam area cakupan, tempat kami tidak dapat menghitung fluks, juga akan tidak valid.
monthlyFluxUrl

string

URL untuk peta fluks bulanan (cahaya matahari di atap, yang dikelompokkan menurut bulan) di wilayah tersebut. Nilainya adalah kWh/kW/tahun. GeoTIFF yang ditunjukkan oleh URL ini akan berisi dua belas band, yang sesuai dengan Januari...Desember, secara berurutan.
hourlyShadeUrls[]

string

Dua belas URL untuk naungan per jam, sesuai dengan Januari...Desember, secara berurutan. Setiap GeoTIFF akan berisi 24 band, yang sesuai dengan 24 jam dalam sehari. Setiap piksel adalah bilangan bulat 32 bit, yang sesuai dengan (hingga) 31 hari dalam bulan tersebut; 1 bit berarti lokasi yang sesuai dapat melihat matahari pada hari itu, pada jam itu, dalam bulan tersebut. Lokasi yang tidak valid disimpan sebagai -9999 (karena negatif, bit 31 ditetapkan, dan tidak ada nilai valid yang dapat menetapkan bit 31 karena akan sesuai dengan hari ke-32 dalam sebulan).

Contoh berikut mungkin akan membantu. Jika Anda ingin mengetahui apakah suatu titik (di lokasi piksel (x, y)) melihat matahari pada pukul 16.00 tanggal 22 Juni, Anda harus:

  1. mengambil URL keenam dalam daftar ini (sesuai dengan bulan Juni).
  2. cari channel ke-17 (sesuai dengan pukul 16.00).
  3. membaca nilai 32-bit pada (x, y).
  4. membaca bit ke-21 dari nilai (sesuai dengan tanggal 22 dalam sebulan).
  5. Jika bit tersebut adalah 1, maka tempat tersebut melihat matahari pada pukul 16.00 tanggal 22 Juni.

Secara lebih formal: Dengan month (1-12), day (1...maksimum bulan; Februari memiliki 28 hari) dan hour (0-23), naungan/sinar matahari untuk bulan/hari/jam tersebut pada posisi (x, y) adalah bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

dengan (x, y) adalah pengindeksan spasial, [month - 1] mengacu pada pengambilan URL ke-month - 1 (pengindeksan dari nol), [hour] adalah pengindeksan ke dalam saluran, dan hasil akhir non-nol berarti "cerah". Tidak ada hari kabisat, dan DST tidak ada (semua hari berdurasi 24 jam; siang selalu "waktu standar" siang).
imageryQuality

enum (ImageryQuality)

Kualitas gambar hasil.

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

ImageryQuality

Kualitas gambar yang digunakan untuk menghitung beberapa hasil API.

Catatan: Terlepas dari tingkat kualitas gambar, output DSM selalu memiliki resolusi 0,1 m/piksel, output fluks bulanan selalu memiliki resolusi 0,5 m/piksel, dan output naungan per jam selalu memiliki resolusi 1 m/piksel.

Enum
IMAGERY_QUALITY_UNSPECIFIED Kualitas tidak diketahui.
HIGH Data surya berasal dari citra udara yang diambil di ketinggian rendah dan diproses pada 0,1 m/piksel.
MEDIUM Data surya berasal dari citra udara yang ditingkatkan yang diambil di ketinggian tinggi dan diproses pada 0,25 m/piksel.
BASE Data surya berasal dari citra satelit yang ditingkatkan dan diproses pada 0,25 m/piksel.

Metode

get

 Mendapatkan informasi tenaga surya untuk wilayah di sekitar suatu lokasi.