REST Resource: dataLayers

Kaynak: DataKatmanlar

Bir bölgenin güneş enerjisi potansiyeli hakkında bilgiler. Gerçek veriler, istenen bölgeyi kapsayan bir dizi GeoTIFF dosyasında yer alır ve bu dosya için URL'ler bulunur: DataLayers mesajındaki her dize, karşılık gelen GeoTIFF'in getirilebileceği bir URL içerir. Bu URL'ler, oluşturulduktan sonra birkaç saat geçerlidir. Çoğu GeoTIFF dosyası 0,1 m/piksel çözünürlüktedir, ancak aylık akış dosyası 0,5 m/piksel boyutundadır ve saatlik gölge dosyaları 1 m/piksel boyutundadır. GetDataLayersRequest içinde bir pixelSizeMeters değeri belirtilmişse GeoTIFF dosyalarındaki minimum çözünürlük bu değer olur.

JSON gösterimi 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Alanlar
imageryDate

object (Date)

Bu bölgedeki kaynak görüntülerin (diğer tüm verilerin elde edildiği) çekildiği zaman. Resimler bir günden uzun süre önce çekilmiş olabileceği için bu sayı yaklaşıktır.
imageryProcessedDate

object (Date)

Bu görüntülerin işlenmesinin tamamlandığı tarih.
dsmUrl

string

Bölgeye ait DSM (Dijital Yüzey Modeli) görüntüsünün URL'si. Değerler, EGM96 coğrafi kimliğinin (yani, deniz seviyesi) üzerindeki metre cinsinden belirtilir. Geçersiz konumlar (verimizin olmadığı) -9999 olarak depolanır.
rgbUrl

string

Bölgenin RGB verilerine (havadan fotoğraf) ait görüntünün URL'si.
maskUrl

string

Bina maskesi resminin URL'si: Piksel başına bir bit olup bu pikselin çatının parçası olarak kabul edilip edilmediğini belirten bir işarettir.
annualFluxUrl

string

Bölgeye ait yıllık akı haritasının (çatılarda yıllık güneş ışığı) URL'si. Değerler kWh/kW/yıl olarak belirlenmiştir. Bu maskelenmemiş akıştır: Akı, yalnızca çatı katı inşaatları değil, her şube için hesaplanır. Geçersiz konumlar -9999 olarak saklanır: Kapsama alanımızın dışındaki konumlar geçersiz olur ve akıyı hesaplayamadığımız kapsama alanı içindeki birkaç konum da geçersiz olur.
monthlyFluxUrl

string

Bölgeye ait aylık akı haritasının (çatılardaki güneş ışığı, aya göre dökümü) URL'si. Değerler kWh/kW/yıl olarak belirlenmiştir. Bu URL'nin işaret ettiği GeoTIFF, sırayla Ocak...Aralık'a karşılık gelen on iki bant içerir.
hourlyShadeUrls[]

string

Ocak...Aralık'a karşılık gelen saatlik gölge için sıralı on iki URL. Her GeoTIFF, günün 24 saatine karşılık gelen 24 şerit 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 ayın ilgili gününde, o saatte ve güneşi görebileceği anlamına gelir. Geçersiz konumlar -9999 olarak saklanır (bu negatif olduğu için bit 31 olarak ayarlanmıştır ve geçerli hiçbir değer, ayın 32. gününe karşılık gelecek şekilde bit 31'i belirleyemez).

Bir örnek faydalı olabilir. Bir noktanın (piksel konumunda (x, y)) 22 Haziran günü saat 16:00'da güneşi görüp görmediğini öğrenmek için şunları yapabilirsiniz:

  1. bu listedeki altıncı URL'yi getir (Haziran ayına karşılık).
  2. 17. kanalı (16:00'ya karşılık gelir) arayın.
  3. (x, y) konumundaki 32 bit değerini okuyun.
  4. değerin 21. bitini okur (ayın 22'sine karşılık gelir).
  5. o nokta 1 ise, o nokta 22 Haziran günü saat 16:00'da güneşi görüyordu.

Daha resmi olarak: month (1-12), day (en fazla 1...ay; Şubat ayının 28 günü) ve hour (0-23) dikkate alındığında, (x, y) konumundaki ilgili ay/gün/saat için gölge/güneş ışığı bittir

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

Burada (x, y) mekansal dizine ekleme, [month - 1] month - 1. URL'nin (sıfırdan dizin) getirilmesini, [hour] ise kanallara dizine eklenmesi ve sıfır olmayan bir nihai sonuç "güneşli" anlamına gelir. Artık gün yok ve YS yoktur (tüm günler 24 saat sürer; öğlen her zaman "standart saat" öğlendir).
imageryQuality

enum (ImageryQuality)

Sonuçtaki görüntülerin kalitesi.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.
month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

ImageryQuality

Bazı API sonuçlarının hesaplanmasında kullanılan görüntülerin kalitesi.

Not: Görüntü kalitesi seviyesinden bağımsız olarak DSM çıkışlarının çözünürlüğü her zaman 0, 1 m/piksel, aylık akı çıkışlarının çözünürlüğü her zaman 0, 5 m/piksel ve saatlik gölge çıkışlarının çözünürlüğü her zaman 1 m/piksel olur.

Sıralamalar
IMAGERY_QUALITY_UNSPECIFIED Kalite bilinmiyor.
HIGH Alttaki görüntüler ve DSM verileri 0,1 m/piksel hızında işlendi.
MEDIUM Alttaki görüntüler ve DSM verileri 0,25 m/piksel hızında işlendi.
LOW Alttaki görüntüler ve DSM verileri 0,5 m/piksel hızında işlenmiştir.

Yöntemler

get

 Bir konumun etrafındaki bölge için güneş enerjisi bilgilerini alır.