dataLayers uç noktası, GeoTIFF dosyaları olarak kodlanmış veriler döndürür. Bu dosyalar, güneş sistemleri 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'yi getirmek için kullanabileceğiniz bir URL içerir. URL'ler, orijinal veri katmanları isteğinden oluşturulduktan sonra bir saat kadar geçerlidir. GeoTIFF dosyaları 30 güne kadar depolanabilir.
RGB katmanı hariç olmak üzere, içerikler RGB resimler yerine veri olarak kodlanmış olduğundan GeoTIFF dosyaları bir resim görüntüleyicide doğru şekilde görüntülenmez. GeoTIFF dosyaları, Maps JavaScript API ile doğrudan bir bindirme görüntüsü olarak da 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 nokta | 0,1 m/piksel | Doğal ve yerleşik özellikler dahil olmak üzere Dünya yüzeyinin topografisini temsil eden yükseklik verileri. Değerler, deniz seviyesinden metre cinsinden yüksekliktir. Geçersiz konumlar veya veri sahibi olmadığımız 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üntüsü. GeoTIFF görüntü dosyası, her bir piksel için 24 bit RGB değeri oluşturmak üzere kırmızı, yeşil ve mavi değerlerine karşılık gelen üç şerit içerir. Varsayılan olarak piksel çözünürlüğü 0,1 m/pikseldir. |
| Bina 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 bit. |
| Yıllık akış | 32 bit kayan nokta | 0,1 m/piksel | Bölgenin yıllık akış haritası (çatılardaki yıllık güneş ışığı)
Değerler kWh/kW/yıl şeklindedir. Flux yalnızca çatı inşaatı yapmak için değil, her konum için hesaplanır. Geçersiz konumlar veya akı hesaplayamadığımız alanlar -9999 olarak depolanır. Kapsam alanımızın dışındaki konumlar geçersizdir. Not: Bu, maskelenmemiş akıştır. |
| Aylık akış | 32 bit kayan nokta | 0,5 m/piksel | Bölgenin aylık akı haritası (çatılardaki güneş ışığı, aya göre ayrılmış). Değerler kWh/kW/yıl şeklindedir. GeoTIFF görüntü dosyası, sırayla Ocak-Aralık aylarına karşılık gelen 12 şerit içerir. |
| Saatlik gölge | 32 bit tam sayı | 1 m/piksel | Sırasıyla Ocak - Aralık dönemine karşılık gelen saatlik gölge haritaları için 12 URL. Her GeoTIFF dosyası, günün 24 saatine karşılık gelen 24 şerit 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 ilgili ay içinde o gün, o saatte, 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 geçersiz olan bit 31'e sahiptir. |
Saatlik gölge kafeslerinin kodunu çözme
Saatlik gölge verileri, çok bantlı kafeslerde kodlanır. Kafes ile ilgili temel bilgiler hakkında daha fazla bilgi edinmek için Solar API Concepts'e göz atın.
Saatlik gölge verileri isteğinde 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 katman, yani şeritlerden oluşur.
Her bant, bir hücre matrisi veya piksel ile temsil edilir. Her pikselin 32 bit derinliği vardır. Bu değer, ayın (maksimum) 31 gününe karşılık gelir. Bu nedenle, gölge verilerinin gün, saat ve ay kodunu çözmek, analiz ettiğiniz bit, bant ve kafes hakkında bilgi sahibi olmayı gerektirir.
Ö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:
- Tüm katmanlar konum (x, y) için veri katmanları isteğinde bulunun.
- Haziran ayı yılın altıncı ayı olduğundan
hourlyShadeUrlslistesindeki altıncı URL'yi getirin. - Saatlik aralıklar 24 saat biçiminde verilir. 16:00 (16:00) verilerini almak için 17. kanalı arayın.
- 0'dan itibaren bit (gün) dizini. Haziran'ın 22. gününe ait verileri almak için bit 21'i okuyun.
- Bitler, söz konusu konumun güneşi belirtilen tarih ve saatte görüp görmediğini belirten ikili veriler sağlar. Bit 1 ise güneşi gören konumdur. Bit 0 ise testere yerinin gölgesi.
Aşağıdaki kod, yukarıdaki adımları özetlemektedir:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))