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 berisi pesan ini: Setiap string dalam pesan DataLayers berisi URL tempat GeoTIFF yang sesuai dapat diambil. 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 bayangan per jam memiliki resolusi 1 m/piksel. Jika nilai pixelSizeMeters ditentukan di 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 (tempat semua data lainnya berasal) di wilayah ini. Estimasi ini bersifat perkiraan, karena gambar mungkin diambil selama lebih dari satu hari.
imageryProcessedDate

object (Date)

Saat pemrosesan gambar ini selesai.
dsmUrl

string

URL untuk gambar DSM (Digital Surface Model) wilayah. Nilainya dinyatakan 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 menunjukkan apakah piksel tersebut dianggap sebagai bagian dari atap atau tidak.
annualFluxUrl

string

URL untuk peta fluks tahunan (sinar matahari tahunan di atap) wilayah tersebut. Nilainya adalah kWh/kW/tahun. Ini adalah fluks yang tidak disamarkan: 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 (sinar matahari di atap, yang diperinci menurut bulan) di wilayah tersebut. Nilainya adalah kWh/kW/tahun. GeoTIFF yang ditunjuk oleh URL ini akan berisi dua belas band, yang sesuai dengan Januari...Desember, secara berurutan.
hourlyShadeUrls[]

string

Dua belas URL untuk bayangan per jam, sesuai dengan urutan Januari...Desember. 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 sebulan tersebut; 1 bit berarti lokasi yang sesuai dapat melihat matahari pada hari, jam, dan 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 mungkin akan berguna. Jika ingin mengetahui apakah titik (di lokasi piksel (x, y)) melihat matahari pada pukul 16.00 pada 22 Juni, Anda harus:

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

Secara lebih formal: Dengan month (1-12), day (1...bulan maks.; Februari memiliki 28 hari) dan hour (0-23), bayangan/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 month - 1st (pengindeksan dari nol), [hour] adalah pengindeksan ke saluran, dan hasil akhir yang bukan nol berarti "cerah". Tidak ada hari kabisat, dan DST tidak ada (semua hari berdurasi 24 jam; tengah hari selalu pukul 12.00 "waktu standar").
imageryQuality

enum (ImageryQuality)

Kualitas gambar hasil.

Tanggal

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

  • 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 bulan. 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 bayangan per jam selalu memiliki resolusi 1 m/piksel.

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

Metode

get

 Mendapatkan informasi surya untuk wilayah di sekitar lokasi.