dataLayers uç noktası, güneş sistemlerini tasarlamak için herhangi bir coğrafi bilgi sistemi (CBS) uygulamasında kullanılabilen GeoTIFF dosyaları olarak kodlanmış veriler döndürür.
dataLayers yanıtındaki her dize, ilgili GeoTIFF'i almak için kullanabileceğiniz bir URL içerir. URL'ler, orijinal veri katmanları isteğinden oluşturulduktan sonra bir saat boyunca geçerlidir. GeoTIFF dosyaları 30 güne kadar saklanabilir.
RGB katmanı hariç olmak üzere GeoTIFF dosyaları, içerik RGB resimler yerine kodlanmış veriler olduğundan resim görüntüleyicilerde doğru şekilde görüntülenmez. GeoTIFF dosyaları da Maps JavaScript API ile doğrudan yer paylaşımı resmi olarak kullanılamaz.
Aşağıdaki tabloda her katman ayrıntılı olarak açıklanmıştır.
| Katman | Piksel derinliği | Çözünürlük | Açıklama |
|---|---|---|---|
| Dijital Yüzey Modeli (DSM) | 32 bit kayan nokta | 0,1 m/piksel | Doğal ve yapay özellikler dahil olmak üzere Dünya'nın yüzey topografisini temsil eden rakım verileri. Değerler deniz seviyesinden metre cinsindendir. Geçersiz konumlar veya verilerimizin olmadığı alanlar -9999 olarak depolanır. |
| RGB | 8 bit | 0,1 m/piksel 0,25 m/piksel 0,5 m/piksel 1 m/piksel |
Bölgenin havadan görünümü. GeoTIFF görüntü dosyası, her piksel için 24 bit RGB değeri oluşturmak amacıyla kırmızı, yeşil ve mavi değerlere karşılık gelen üç bant içerir. Varsayılan olarak piksel çözünürlüğü 0,1 m/pikseldir. |
| Bina maskesi | 1 bit | 0,1 m/piksel | Bir piksel başına bir bit. Bu piksel, bir çatı parçası olarak kabul edilip edilmediğini belirtir. |
| Yıllık akış | 32 bit kayan nokta | 0,1 m/piksel | Bölgenin yıllık akış haritası veya çatılara gelen yıllık güneş ışığı.
Değerler kWh/kW/yıl cinsindendir. Flux, yalnızca bina çatılarının değil, her konum için hesaplanır. Geçersiz konumlar veya akış değerini hesaplayamadığımız alanlar -9999 olarak depolanır. Kapsama alanımızın dışındaki konumlar geçersizdir. Not: Bu, maskesiz akıştır. |
| Aylık akış | 32 bit kayan nokta | 0,5 m/piksel | Bölgenin aylık akış haritası (çatılara gelen güneş ışığı, aya göre ayrılmış). Değerler kWh/kW/yıl cinsindendir. GeoTIFF görüntü dosyası, sırasıyla Ocak-Aralık'a karşılık gelen 12 bant içerir. |
| Saatlik gölge | 32 bit tam sayı | 1 m/piksel | Ocak-Aralık ayına karşılık gelen saatlik gölge haritaları için 12 URL (sıralı olarak). Her GeoTIFF dosyası, günün 24 saatine karşılık gelen 24 bant içerir. Her piksel, ilgili ayın 31 gününe (en fazla) karşılık gelen 32 bitlik bir tam sayıdır. 1 bit, ilgili konumun o gün, o saat ve o ayda güneşi görebildiği anlamına gelir. Geçersiz konumlar -9999 olarak depolanır ve ayın 32. gününe karşılık geldiği için 31. bit ayarlanır. |
Saatlik gölge rasterlerinin kodunu çözme
Saatlik gölge verileri çok bantlı rasterlerde kodlanır. Rasterin temelleri hakkında daha fazla bilgi edinmek için Solar API Kavramları başlıklı makaleyi inceleyin.
Saatlik gölge verileri için istek yaptığınızda, takvim yılının her ayı (Ocak-Aralık) için bir tane olmak üzere en fazla 12 raster alabilirsiniz. Her raster, günün 24 saatine karşılık gelen 24 katmandan veya banttan oluşur.
Her bant, bir hücre matrisi veya piksel ile temsil edilir. Her pikselin 32 bit derinliği vardır. Bu derinlik, ayın (maksimum) 31 gününe karşılık gelir. Bu nedenle, gölge verilerinin gün, saat ve ay bilgilerinin kodunu çözmek için analiz ettiğiniz bit, bant ve rasteri anlamanız gerekir.
Örneğin, (x, y) koordinatlarında bulunan belirli bir konumun 22 Haziran'da saat 16:00'da güneşi görüp görmediğini belirlemek için aşağıdakileri yapın:
- Konum (x, y) için tüm katmanlar için veri katmanları isteği gönderin.
- Haziran ayı yılın altıncı ayı olduğu için
hourlyShadeUrlslistesindeki altıncı URL'yi getirin. - Saatlik bantlar 24 saatlik saat diliminde gösterilir. 16:00 için veri almak istiyorsanız 17. kanala bakın.
- 0'dan başlayarak bit (gün) dizini. Haziran ayının 22. günüyle ilgili verileri almak için 21. biti okuyun.
- Bitler, söz konusu konumda belirli tarih ve saatte güneş olup olmadığını belirten ikili veriler sağlar. Bit 1 ise konumda güneş görülmüştür. Bit 0 ise konum gölgededir.
Aşağıdaki kod, yukarıdaki adımları özetler:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))