Endpoint dataLayers mengembalikan data yang dikodekan sebagai file GeoTIFF, yang dapat digunakan di lokasi aplikasi sistem informasi (GIS) untuk merancang sistem tenaga surya.
Setiap string dalam respons dataLayers berisi URL, yang bisa Anda gunakan untuk mengambil GeoTIFF yang sesuai. URL berlaku hingga satu jam setelah permintaan itu dibuat dari permintaan lapisan data asli. File GeoTIFF dapat disimpan hingga 30 hari.
Dengan pengecualian pada lapisan RGB, {i>file<i} GeoTIFF tidak ditampilkan secara benar dengan penampil gambar, karena kontennya adalah data yang dikodekan, bukan gambar RGB. File GeoTIFF juga tidak dapat digunakan langsung sebagai gambar overlay dengan Maps JavaScript API.
Tabel berikut menjelaskan setiap lapisan secara mendetail.
| Lapisan | Kedalaman piksel | Resolusi | Deskripsi |
|---|---|---|---|
| Model Permukaan Digital (DSM) | Float 32-bit | 0,1 m/piksel | Data elevasi yang menggambarkan topografi permukaan bumi, termasuk fitur alami dan buatan. Nilainya dinyatakan dalam meter di atas permukaan laut. Lokasi yang tidak valid, atau area yang datanya tidak kami miliki, disimpan sebagai -9999. |
| RGB | 8-bit | 0,1 m/piksel 0,25 m/piksel 0,5 m/piksel 1 m/piksel |
Gambar udara wilayah tersebut. File citra GeoTIFF berisi
tiga pita yang sesuai dengan nilai merah, hijau, dan biru untuk membentuk
Nilai RGB 24-bit untuk setiap piksel. Secara default, resolusi piksel adalah 0,1 m/piksel. |
| Masker bangunan | 1 bit | 0,1 m/piksel | Satu bit per piksel yang menunjukkan apakah piksel tersebut dianggap sebagai bagian dari atap. |
| Fluks tahunan | Float 32-bit | 0,1 m/piksel | Peta fluks tahunan, atau sinar matahari tahunan di atap, di wilayah tersebut.
Nilainya adalah kWh/kW/tahun. Fluks dikomputasi untuk setiap lokasi, bukan sekadar membangun atap. Lokasi tidak valid, atau area yang tidak dapat kami menghitung fluks, disimpan sebagai -9999. Lokasi di luar area cakupan tidak valid. Catatan: Ini adalah fluks yang tidak disamarkan. |
| Fluks bulanan | Float 32-bit | 0,5 m/piksel | Peta fluks bulanan (sinar matahari di atap, diperinci menurut bulan) teritorial Anda. Nilainya adalah kWh/kW/tahun. File citra GeoTIFF berisi 12 band yang berkaitan dengan bulan Januari — Desember, secara berurutan. |
| Bayangan per jam | Bilangan bulat 32-bit | 1 m/piksel | 12 URL untuk peta bayangan per jam yang sesuai dengan bulan Januari — Desember, pada
pesanan. Setiap file GeoTIFF berisi 24 band, yang sesuai dengan 24 jam. Setiap piksel adalah bilangan bulat 32 bit, sesuai dengan (hingga) 31 hari pada bulan tersebut. 1 bit berarti bahwa kode mampu melihat matahari pada hari itu, jam itu, dalam bulan itu. Lokasi yang tidak valid disimpan sebagai -9999 dan memiliki bit 31 yang disetel, sebagai yang sesuai dengan tanggal 32 setiap bulan, dan karenanya tidak valid. |
Mendekode raster bayangan per jam
Data bayangan per jam dienkode dalam raster multiband. Untuk mempelajari raster lebih lanjut dasar-dasarnya, lihat Konsep Solar API.
Saat membuat permintaan untuk data bayangan per jam, Anda bisa menerima hingga 12 raster, satu untuk setiap bulan dalam tahun kalender (Januari hingga Desember). Setiap raster terdiri dari 24 lapisan, atau band, yang sesuai dengan durasi 24 jam mereka.
Setiap band diwakili oleh matriks sel, atau piksel. Setiap piksel memiliki kedalaman 32 bit, yang sesuai dengan (maksimum) 31 hari dalam sebulan. Oleh karena itu, mendekode hari, waktu, dan bulan data bayangan, memahami bit, band, dan raster yang Anda analisis.
Misalnya, untuk mengidentifikasi apakah lokasi tertentu pada koordinat (x, y) melihat matahari pada pukul 16.00 pada 22 Juni, lakukan hal berikut:
- Membuat permintaan lapisan data untuk semua lapisan lokasi (x, y).
- Karena bulan Juni adalah bulan keenam, ambil tanggal keenam
URL dalam daftar
hourlyShadeUrls. - Pita per jam diberikan dalam waktu 24 jam. Untuk mendapatkan data pukul 16.00, cari saluran ke-17.
- Indeks bit (hari) dari 0. Untuk mendapatkan data hari 22 Juni, baca bit 21.
- Bit memberikan data biner yang mengindikasikan apakah lokasi tersebut melihat matahari pada tanggal dan waktu tertentu. Jika bitnya 1, lokasi tersebut melihat matahari. Jika bitnya 0, lokasi itu melihat bayangan.
Kode berikut merangkum langkah-langkah di atas:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))