REST Resource: dataLayers

Resource: DataLayers

Informasi tentang potensi tenaga surya di suatu wilayah. Data sebenarnya dimuat dalam sejumlah file GeoTIFF yang mencakup region yang diminta, yang untuknya pesan ini berisi URL: Setiap string di pesan DataLayers berisi URL tempat GeoTIFF yang sesuai dapat diambil. URL ini berlaku selama beberapa jam setelah dibuat. Sebagian besar file GeoTIFF memiliki resolusi 0,1m/pixel, tetapi file flux bulanannya hanya 0,5m/pixel, dan bayangan file per jamnya 1m/pixel. Jika nilai pixelSizeMeters ditentukan dalam GetDataLayersRequest, maka 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)

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.
imageryProcessedDate

object (Date)

Saat pemrosesan selesai pada gambar ini.
dsmUrl

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.
rgbUrl

string

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

string

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

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.
monthlyFluxUrl

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.
hourlyShadeUrls[]

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).
imageryQuality

enum (ImageryQuality)

Kualitas gambar hasil.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID 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 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 bayangan per jam selalu memiliki resolusi 1 m/piksel.

Enum
IMAGERY_QUALITY_UNSPECIFIED Tidak ada kualitas yang diketahui.
HIGH Gambar yang mendasari dan data DSM diproses pada kecepatan 0,1 m/piksel.
MEDIUM Gambar yang mendasari dan data DSM diproses pada kecepatan 0,25 m/piksel.
LOW Gambar yang mendasari dan data DSM diproses pada kecepatan 0,5 m/piksel.

Metode

get

 Mendapatkan informasi tenaga surya untuk wilayah di sekitar lokasi.