Tentang file GeoTIFF

Endpoint dataLayers menampilkan data yang dienkode sebagai file GeoTIFF, yang dapat digunakan di aplikasi sistem informasi geografis (GIS) apa pun untuk mendesain sistem surya.

Setiap string dalam respons dataLayers berisi URL, yang dapat Anda gunakan untuk mengambil GeoTIFF yang sesuai. URL valid 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 dengan penampil gambar, karena kontennya adalah data yang dienkode, 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 mewakili topografi permukaan Bumi, termasuk fitur alami dan buatan. Nilainya dinyatakan dalam meter di atas permukaan laut. Lokasi yang tidak valid, atau area tempat kami 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 untuk membentuk nilai RGB 24-bit untuk setiap piksel. Secara default, resolusi piksel adalah 0,1 m/piksel.
Membuat mask	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, dari wilayah tersebut. Nilainya adalah kWh/kW/tahun. Flux dihitung untuk setiap lokasi, bukan hanya atap bangunan. Lokasi yang tidak valid, atau area tempat kami tidak dapat menghitung fluks, disimpan sebagai -9999. Lokasi di luar area cakupan kami 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, yang diperinci menurut bulan) dari wilayah. Nilainya adalah kWh/kW/tahun. File citra GeoTIFF berisi 12 band yang sesuai 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 Januari — Desember, secara berurutan. Setiap file GeoTIFF berisi 24 band, yang sesuai dengan 24 jam dalam sehari. Setiap piksel adalah bilangan bulat 32 bit, yang sesuai dengan (hingga) 31 hari dalam sebulan tersebut. 1 bit berarti lokasi yang sesuai dapat melihat matahari pada hari tersebut, pada jam tersebut, dalam bulan tersebut. Lokasi yang tidak valid disimpan sebagai -9999 dan memiliki bit 31 yang ditetapkan, karena sesuai dengan hari ke-32 dalam sebulan sehingga tidak valid.

Mendekode 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 untuk 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 band, yang sesuai dengan 24 jam dalam sehari.

Setiap band diwakili oleh matriks sel, atau piksel. Setiap piksel memiliki kedalaman 32 bit, yang sesuai dengan 31 hari (maksimum) dalam sebulan. Oleh karena itu, mendekode data bayangan hari, waktu, dan bulan memerlukan pemahaman tentang 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:

1. Buat permintaan lapisan data untuk semua lapisan untuk lokasi (x, y).
2. Karena bulan Juni adalah bulan keenam dalam setahun, ambil URL keenam dalam daftar hourlyShadeUrls.
3. Rentang per jam diberikan dalam waktu 24 jam. Untuk mendapatkan data pukul 16.00, cari saluran ke-17.
4. Indeks bit (hari) dari 0. Untuk mendapatkan data tanggal 22 Juni, baca bit 21.
5. Bit memberikan data biner yang menunjukkan apakah lokasi tersebut melihat matahari pada tanggal dan waktu tertentu. Jika bitnya 1, lokasi melihat matahari. Jika bitnya 0, lokasi akan melihat bayangan.

Kode berikut merangkum langkah-langkah di atas:

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))