REST Resource: dataLayers

Kaynak: DataLayers

Bir bölgenin güneş enerjisi potansiyeli hakkında bilgi. Gerçek veriler, istenen bölgeyi kapsayan ve bu iletideki URL'leri içeren bir dizi GeoTIFF dosyasında bulunur: DataLayers mesajındaki her dize, ilgili GeoTIFF'in alınabileceği bir URL içerir. Bu URL'ler oluşturulduktan sonraki birkaç saat boyunca geçerlidir. GeoTIFF dosyalarının çoğu 0,1 m/piksel çözünürlüktedir ancak aylık akış dosyası 0,5 m/piksel, saatlik gölge dosyaları ise 1 m/piksel çözünürlüktedir. 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üler (diğer tüm verilerin türetildiği görüntüler) ne zaman çekildi? Resimler birden fazla günde çekilmiş olabileceğinden bu değer yaklaşıktır.
imageryProcessedDate

object (Date)

Bu görüntüler üzerinde işleme ne zaman tamamlandı?
dsmUrl

string

Bölgenin DSM (Dijital Yüzey Modeli) resminin URL'si. Değerler, EGM96 jeoidinin (yani deniz seviyesinin) üstündeki metre cinsindendir. Geçersiz konumlar (verilerimizin olmadığı konumlar) -9999 olarak depolanır.
rgbUrl

string

Bölgenin RGB veri resminin (havadan fotoğraf) URL'si.
maskUrl

string

Bina maskesi resminin URL'si: Bir piksel başına bir bit. Bu piksel, bir çatı parçası olarak kabul edilip edilmediğini belirtir.
annualFluxUrl

string

Bölgenin yıllık akış haritasının (çatılara gelen yıllık güneş ışığı) URL'si. Değerler kWh/kW/yıl cinsindendir. Bu, maskesiz akıştır: Akış yalnızca binaların çatıları için değil, her konum için hesaplanır. Geçersiz konumlar -9999 olarak depolanır: Kapsama alanımızın dışındaki konumlar geçersiz olur ve kapsama alanındaki, akış hesaplayamadığımız birkaç konum da geçersiz olur.
monthlyFluxUrl

string

Bölgenin aylık akış haritasının (çatılara gelen güneş ışığı, aya göre ayrılmış) URL'si. Değerler kWh/kW/yıl cinsindendir. Bu URL'nin gösterdiği GeoTIFF, sırasıyla Ocak-Aralık'a karşılık gelen on iki bant içerir.
hourlyShadeUrls[]

string

Saatlik gölge için sırasıyla Ocak-Aralık'a karşılık gelen on iki URL. Her GeoTIFF, 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 ilgili ayın, ilgili günün, ilgili saatinde güneşi görebildiği anlamına gelir. Geçersiz konumlar -9999 olarak saklanır (negatif olduğu için 31. bit ayarlanmıştır ve ayın 32. gününe karşılık geldiği için hiçbir geçerli değer 31. bit ayarlayamaz).

Bir örnek faydalı olabilir. Bir noktanın (piksel konumu (x, y)) 22 Haziran'da saat 16:00'da güneş görüp görmediğini öğrenmek istiyorsanız:

  1. Bu listedeki altıncı URL'yi (Haziran'a karşılık gelir) getirir.
  2. 17. kanalı (16:00'a karşılık gelir) bulun.
  3. (x, y) noktasındaki 32 bitlik değeri okur.
  4. değerin 21. bitini (ayın 22. gününe karşılık gelir) okur.
  5. Bu bit 1 ise söz konusu nokta 22 Haziran saat 16:00'da güneşi görmüştür.

Daha resmi bir şekilde: month (1-12), day (1...ay maks.; Şubat 28 gündür) ve hour (0-23) değerleri verildiğinde, (x, y) konumundaki ilgili ay/gün/saat için gölge/güneş biti

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

Burada (x, y), mekansal dizine ekleme, [month - 1] month - 1. URL'yi getirmeyi (sıfırdan dizine ekleme), [hour] kanallara dizine eklemeyi, sıfır olmayan nihai sonuç ise "güneşli" anlamına gelir. Artık gün yoktur ve yaz saati uygulaması yoktur (tüm günler 24 saattir; öğle zamanı her zaman "standart saat" öğle zamanıdır).
imageryQuality

enum (ImageryQuality)

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

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. kredi kartının 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 olmadan tarih belirtmek için 0 olmalıdır.
month

integer

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

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

ImageryQuality

Bazı API sonuçlarını hesaplamak için kullanılan görüntülerin kalitesi.

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

Sıralamalar
IMAGERY_QUALITY_UNSPECIFIED Kalite bilinmiyor.
HIGH Güneş verileri, düşük rakımda çekilen ve 0,1 m/piksel çözünürlükte işlenen havadan görüntülerden elde edilir.
MEDIUM Güneş enerjisi verileri, yüksek rakımda çekilen ve 0,25 m/piksel çözünürlükte işlenen gelişmiş havadan görüntülerden elde edilir.
LOW Güneş enerjisi verileri, 0,25 m/piksel çözünürlükte işlenen gelişmiş uydu görüntülerinden elde edilir.

Yöntemler

get

 Bir konumun çevresindeki bölgenin güneş enerjisi bilgilerini alır.