REST Resource: dataLayers

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

object (Date)

Kapan gambar sumber (yang menjadi sumber semua data lainnya) di wilayah ini diambil. Hal ini harus agak mendekati, karena gambar mungkin diambil lebih dari satu hari.

object (Date)

Saat pemrosesan selesai pada gambar ini.

string

URL untuk gambar DSM (Digital Surface Model) wilayah. Nilainya dalam meter di atas geoid EGM96 (yaitu, permukaan laut). Lokasi yang tidak valid (yang tidak kami miliki datanya) disimpan sebagai -9999.

string

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

string

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

string

URL untuk peta fluks tahunan (sinar matahari tahunan di atap) suatu wilayah. Nilainya adalah kWh/kW/tahun. Ini adalah fluks yang tidak disamarkan: fluks dihitung untuk setiap lokasi, bukan hanya membangun atap. Lokasi yang tidak valid disimpan sebagai -9999: lokasi di luar area cakupan kami tidak akan valid, dan beberapa lokasi di dalam area cakupan yang tidak dapat kami hitung fluks juga akan menjadi tidak valid.

string

URL untuk peta fluks bulanan (sinar matahari di atap, dikelompokkan menurut bulan) untuk wilayah tersebut. Nilainya adalah kWh/kW/tahun. GeoTIFF yang ditunjuk oleh URL ini akan berisi dua belas pita, yang terkait dengan bulan Januari...Desember, secara berurutan.

string

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

Mungkin ada contoh yang berguna. Jika Anda ingin tahu apakah suatu titik (pada lokasi piksel (x, y)) melihat matahari pada pukul 4 sore pada tanggal 22 Juni, Anda akan:

1. mengambil URL keenam dalam daftar ini (sesuai dengan bulan Juni).
2. cari saluran ke-17 (sesuai dengan jam 4 sore).
3. baca nilai 32-bit pada (x, y).
4. baca bit 21 dari nilai (sesuai dengan tanggal 22 dari bulan tersebut).
5. jika bit itu adalah 1, maka tempat itu melihat matahari pada pukul 4 sore tanggal 22 Juni.

Lebih formal: Mengingat month (1-12), day (maksimum 1...bulan; 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] merujuk pada pengambilan URL month - 1 (pengindeksan dari nol), [hour] mengindeks ke saluran, dan hasil akhir yang bukan nol berarti "cerah". Tidak ada hari kabisat, dan DST tidak ada (semua hari berdurasi 24 jam; siang selalu "waktu standar" siang hari).

enum (ImageryQuality)

Kualitas gambar hasil.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

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.