dataLayers uç noktası, GeoTIFF dosyaları olarak kodlanmış verileri döndürür. Bu dosyalar, güneş sistemlerini tasarlamak için herhangi bir coğrafi bilgi sistemi (GIS) uygulamasında kullanılabilir.
dataLayer yanıtındaki her dize, karşılık gelen GeoTIFF öğesini getirmek için kullanabileceğiniz bir URL içerir. URL'ler, orijinal veri katmanı isteğiyle oluşturulduktan sonra bir saate kadar geçerlidir. GeoTIFF dosyaları 30 güne kadar saklanabilir.
İçerik, RGB resimler yerine veriler olarak kodlanmış olduğundan, RGB katmanı haricinde, GeoTIFF dosyaları resim görüntüleyicide doğru bir şekilde görüntülenmez. Ayrıca GeoTIFF dosyaları, Maps JavaScript API'de doğrudan bir bindirme görüntüsü olarak kullanılamaz.
Aşağıdaki tabloda her bir katman ayrıntılı olarak açıklanmaktadır.
| Katman | Piksel derinliği | Çözünürlük | Açıklama |
|---|---|---|---|
| Dijital Yüzey Modeli (DSM) | 32 bit kayan | 0,1 m/piksel | Doğal özellikler ve yerleşik özellikler de dahil olmak üzere Dünya yüzeyinin topoğrafyasını temsil eden yükseklik verileri. Değerler, deniz seviyesinden yüksekliği metre cinsinden belirtir. Geçersiz konumlar veya veri bulundurmadığımız alanlar -9999 olarak saklanır. |
| RGB | 8 bit | 0,1 m/piksel 0,25 m/piksel 0,5 m/piksel 1 m/piksel |
Bölgenin havadan görüntüsü. 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/piksel'dir. |
| İnşaat maskesi | 1 Bit | 0,1 m/piksel | Piksel başına, bu pikselin bir çatının parçası olarak kabul edilip edilmediğini belirten bir bittir. |
| Yıllık değişim | 32 bit kayan | 0,1 m/piksel | Bölgenin yıllık akı haritası veya çatılardaki yıllık güneş ışığı.
Değerler kWh/kW/yıl olarak belirlenmiştir. Flux, yalnızca bina çatıları için değil, her konum için hesaplanır. Geçersiz konumlar veya akışı hesaplayamadığımız alanlar -9999 olarak depolanır. Kapsama alanımızın dışındaki konumlar geçersizdir. Not: Bu, maskelenmemiş akıştır. |
| Aylık değişim | 32 bit kayan | 0,5 m/piksel | Bölgenin aylık akı haritası (çatılardaki güneş ışığı, aya göre döküm). Değerler kWh/kW/yıl olarak belirlenmiştir. GeoTIFF görüntü dosyası, sırayla Ocak-Aralık aralığına 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 sırasıyla 12 URL. Her GeoTIFF dosyası, günün 24 saatine karşılık gelen 24 bant içerir. Her piksel, bir ayın (en fazla) 31 gününe karşılık gelen 32 bitlik bir tam sayıdır. 1 bit, ilgili konumun ilgili ayda, o saatte ve o ayda güneşi görebileceği anlamına gelir. Geçersiz konumlar -9999 olarak depolanır ve ayın 32. gününe karşılık gelen bit 31 olarak ayarlanmıştır ve bu nedenle geçersizdir. |
Saatlik gölge çatlaklarının kodunu çözme
Saatlik gölge verileri, çok bantlı kafeslerde kodlanır. Kafes temelleri hakkında daha fazla bilgi edinmek için Solar API Kavramları bölümüne bakın.
Saatlik gölge verileri için istekte bulunduğunuzda, takvim yılının her ayı (Ocak-Aralık) için bir tane olmak üzere en fazla 12 kafes alabilirsiniz. Her kafes, günün 24 saatine karşılık gelen 24 katmandan veya bantlardan oluşur.
Her bant, bir hücre matrisi (piksel) ile temsil edilir. Her pikselin 32 bit derinliği vardır. Bu, ayın (maksimum) 31 gününe karşılık gelir. Bu nedenle, gölge verilerinin gün, saat ve ay kodunu çözmek için analiz ettiğiniz bit, bant ve kafes öğesinin anlaşılması gerekir.
Örneğin, (x, y) koordinatlarındaki belirli bir konumun 22 Haziran günü 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 bir veri katmanı isteğinde bulunun.
- Haziran ayı yılın altıncı ayı olduğundan
hourlyShadeUrlslistesindeki altıncı URL'yi getirin. - Saatlik bantlar, 24 saat biçiminde verilir. 16:00 (16:00) verilerini almak için 17. kanalı arayın.
- 0'dan sonraki bit (gün) dizini. Haziran ayının 22'sine ait verileri almak için bit 21'i okuyun.
- Bitler, belirtilen tarih ve saatte söz konusu konumun güneşi görüp görmediğini belirten ikili veriler sağlar. Bit 1 ise, güneşin görüldüğü konum. Bit 0 ise, gösterilen yerde gölge bulunur.
Aşağıdaki kod, yukarıdaki adımları özetlemektedir:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))