Tentang file GeoTIFF

Endpoint dataLayers menampilkan data yang dienkode sebagai file GeoTIFF, yang dapat digunakan dalam aplikasi sistem informasi geografis (GIS) apa pun untuk mendesain sistem tenaga 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 kontennya dienkodekan data, 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 menunjukkan topografi permukaan bumi, termasuk fitur alam dan buatan. Nilainya 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 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 rooftop.
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 dihitung untuk setiap lokasi, bukan hanya membangun atap. Lokasi yang tidak valid, atau area yang tidak dapat kami hitung fluks, disimpan sebagai -9999. Lokasi di luar area cakupan kami tidak valid. Catatan: Ini adalah fluks yang tersembunyi.
Fluks bulanan	Float 32-bit	0,5 m/piksel	Peta fluks bulanan (sinar matahari di atap, dikelompokkan menurut bulan) untuk wilayah tersebut. Nilainya adalah kWh/kW/tahun. File citra GeoTIFF berisi 12 band yang mewakili 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, 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 pada bulan itu. 1 bit berarti lokasi yang terkait dapat melihat matahari pada hari itu, jam itu, dan bulan itu. Lokasi yang tidak valid disimpan sebagai -9999 dan memiliki bit 31 yang ditetapkan, karena sesuai dengan hari ke-32 dalam bulan tersebut, 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 (maksimum) 31 hari dalam sebulan. Oleh karena itu, mendekode hari, waktu, dan bulan data 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 tindakan berikut:

1. Membuat permintaan lapisan data untuk semua lapisan lokasi (x, y).
2. Karena bulan Juni adalah bulan keenam setiap tahun, ambil URL keenam dalam daftar hourlyShadeUrls.
3. Pita per jam diberikan dalam waktu 24 jam. Untuk mendapatkan data pada pukul 16.00 (16.00), cari saluran ke-17.
4. Indeks bit (hari) dari 0. Untuk mendapatkan data hari 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 tersebut melihat matahari. Jika bitnya adalah 0, lokasi itu melihat bayangan.

Kode berikut merangkum langkah-langkah di atas:

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