Endpoint dataLayers menampilkan data yang dienkode sebagai file GeoTIFF, yang dapat digunakan di aplikasi sistem informasi geografis (GIS) untuk mendesain sistem tata surya.
Setiap string dalam respons dataLayers berisi URL yang dapat Anda gunakan untuk mengambil GeoTIFF yang sesuai. URL berlaku hingga satu jam setelah dibuat dari permintaan lapisan data asli. File GeoTIFF dapat disimpan hingga 30 hari.
Dengan pengecualian lapisan RGB, file GeoTIFF tidak ditampilkan dengan benar pada penampil gambar, karena konten merupakan data yang dienkode, bukan gambar RGB. File GeoTIFF juga tidak dapat digunakan secara 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 ketinggian yang mewakili topografi permukaan bumi, termasuk fitur alam dan bangunan. Nilai dalam meter di atas permukaan laut. Lokasi yang tidak valid, atau area yang tidak memiliki data, 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 gambar GeoTIFF berisi tiga band yang sesuai dengan nilai merah, hijau, dan biru agar 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. |
| Perubahan tahunan | Float 32-bit | 0,1 m/piksel | Peta fluks tahunan, atau sinar matahari tahunan di atap, untuk wilayah tersebut.
Nilainya adalah kWh/kW/tahun. Flux dihitung untuk setiap lokasi, bukan hanya membangun atap. Lokasi yang tidak valid, atau area yang tidak dapat kami hitung fluksnya, disimpan sebagai -9999. Lokasi di luar area cakupan kami tidak valid. Catatan: Ini adalah fluks yang tidak disamarkan. |
| Perubahan bulanan | Float 32-bit | 0,5 m/piksel | Peta fluks bulanan (sinar matahari di atap, yang diperinci berdasarkan bulan) untuk wilayah. Nilainya adalah kWh/kW/tahun. File gambar GeoTIFF berisi 12 pita secara berurutan yang terkait dengan Januari — Desember. |
| Bayangan per jam | Bilangan bulat 32-bit | 1 m/piksel | 12 URL untuk peta bayangan per jam yang sesuai dengan bulan Januari — Desember, secara berurutan. Setiap file GeoTIFF berisi 24 pita, yang berarti 24 jam dalam sehari. Setiap piksel adalah bilangan bulat 32 bit, yang menunjukkan (hingga) 31 hari pada bulan tersebut. 1 bit berarti lokasi yang sesuai dapat melihat matahari pada hari itu, pada jam itu, pada bulan itu. Lokasi yang tidak valid disimpan sebagai -9999 dan memiliki bit 31 yang ditetapkan, karena sesuai dengan tanggal 32 setiap bulan sehingga menjadi tidak valid. |
Dekode raster bayangan per jam
Data bayangan per jam dienkode dalam raster multiband. Untuk mempelajari dasar-dasar raster lebih lanjut, lihat Konsep Solar API.
Saat membuat permintaan data bayangan per jam, Anda dapat menerima hingga 12 raster, satu untuk setiap bulan dalam tahun kalender (Januari hingga Desember). Setiap raster terdiri dari 24 lapisan, atau tali, yang sesuai dengan 24 jam dalam sehari.
Setiap pita diwakili oleh matriks sel, atau piksel. Setiap piksel memiliki kedalaman 32 bit, yang setara dengan (maksimum) 31 hari dalam sebulan. Oleh karena itu, mendekode data hari, waktu, dan bulan bayangan memerlukan pemahaman 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 bagi semua lapisan untuk lokasi (x, y).
- Karena bulan Juni adalah bulan keenam dalam setahun, ambil URL
keenam dalam daftar
hourlyShadeUrls. - Pita per jam diberikan dalam waktu 24 jam. Untuk mendapatkan data pukul 16.00 (16.00), cari saluran ke-17.
- Indeks bit (hari) dari 0. Guna mendapatkan data untuk hari ke-22 di bulan Juni, baca bit 21.
- Bit menyediakan data biner yang menunjukkan apakah lokasi tersebut melihat matahari pada tanggal dan waktu tertentu. Jika bitnya adalah 1, lokasinya melihat matahari. Jika bit adalah 0, lokasi gergaji dan bayangan.
Kode berikut meringkas langkah-langkah di atas:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))