REST Resource: dataLayers

Resource: DataLayers

Informasi tentang potensi tenaga surya di suatu wilayah. Data aktual dimuat dalam sejumlah file GeoTIFF yang mencakup wilayah yang diminta, yang pesannya berisi URL: Setiap string dalam 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,1 m/pixel, tetapi file fluks bulanan berada pada 0,5 m/pixel, dan file bayangan per jam berada pada 1 m/pixel. Jika nilai pixelSizeMeters ditentukan dalam GetDataLayersRequest, resolusi minimum dalam file GeoTIFF adalah 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)

Saat gambar sumber (tempat semua data lainnya diperoleh) di wilayah ini diambil. Hasil ini tentunya merupakan perkiraan, karena gambar mungkin telah diambil lebih dari satu hari.
imageryProcessedDate

object (Date)

Ketika pemrosesan selesai pada citra ini.
dsmUrl

string

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

string

URL untuk gambar data RGB (foto udara) pada 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 (sinar matahari tahunan di atap) di wilayah tersebut. Nilainya adalah kWh/kW/tahun. Ini adalah fluks tanpa topeng: fluks dihitung untuk setiap lokasi, bukan hanya membangun atap. Lokasi yang tidak valid disimpan sebagai -9999: lokasi di luar area cakupan kami akan menjadi tidak valid, dan beberapa lokasi di dalam area cakupan, yang fluksnya tidak dapat kami hitung, juga tidak akan valid.
monthlyFluxUrl

string

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

string

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

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

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

Secara lebih formal: Dengan mempertimbangkan month (1-12), day (maks 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 ke-month - 1 (pengindeksan dari nol), [hour] mengindeks ke dalam saluran, dan hasil akhir bukan nol berarti "cerah". Tidak ada hari kabisat, dan DST tidak ada (semua hari berlangsung selama 24 jam; siang hari selalu merupakan "waktu standar").
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 tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu hal berikut:

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

Jenis terkait:

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

integer

Tahun dari 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 sampai 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 Citra dan data DSM yang mendasarinya diproses pada 0,1 m/piksel.
MEDIUM Citra dan data DSM yang mendasarinya diproses pada 0,25 m/piksel.
LOW Citra dan data DSM yang mendasarinya diproses pada 0,5 m/piksel.

Metode

get

 Mendapatkan informasi tenaga surya untuk wilayah di sekitar lokasi.