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 bulunur ve bu dosya için bu mesaj URL'leri içerir: 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 süreyle 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 şeklindedir. GetDataLayersRequest içinde bir pixelSizeMeters değeri belirtilmişse GeoTIFF dosyalarında minimum çözünürlük bu değer olacaktır.

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) alınma zamanı. Görüntüler bir günden daha uzun süre çekilmiş olabileceğinden, bu mutlaka bir miktar yaklaşıktır.

imageryProcessedDate

object (Date)

Bu görüntülerin işlenmesi tamamlandığındaki görüntüler.

dsmUrl

string

Bölgenin DSM (Dijital Yüzey Modeli) görüntüsünün URL'si. Değerler, EGM96 jeoidin üzerindeki (deniz seviyesi) metre cinsindendir. Geçersiz konumlar (verilerimizin olmadığı) -9999 olarak depolanır.

rgbUrl

string

Bölgeye ait RGB verileri (havadan fotoğraf) resminin URL'si.

maskUrl

string

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

annualFluxUrl

string

Bölgenin yıllık akı haritasının (çatılarda yıllık güneş ışığı) URL'si. Değerler kWh/kW/yıl şeklindedir. Bu maskesiz akıdır: Akı sadece çatı inşaatları için değil, her konum için hesaplanır. Geçersiz konumlar -9999 olarak saklanır: Kapsam alanımızın dışındaki konumlar geçersiz olur ve kapsama alanı içinde akı hesaplayamadığımız bazı konumlar da geçersiz olur.

monthlyFluxUrl

string

Bölgenin aylık akı haritasının (çatılardaki güneş ışığı, aya göre ayrılmış) URL'si. Değerler kWh/kW/yıl şeklindedir. Bu URL'nin işaret ettiği GeoTIFF, sırayla Ocak...Aralık'a karşılık gelen on iki şerit içerir.

hourlyShadeUrls[]

string

Sırasıyla Ocak...Aralık'a karşılık gelen saatlik gölge için on iki URL. Her GeoTIFF, günün 24 saatine karşılık gelen 24 şerit içerir. Her piksel, o ayın 31. gününe karşılık gelen 32 bitlik bir tam sayıdır. 1 bit ise ilgili konumun, o ayın o gün, o saatte güneşi görebildiği anlamına gelir. Geçersiz konumlar -9999 olarak depolanır (bu negatif olduğundan, bit 31 kümesi vardır ve geçerli hiçbir değer ayın 32. gününe karşılık gelecek şekilde bit 31 ayarlanmamış olabilir).

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

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

Daha resmi olarak: month (1-12), day (maks. 1 ay; Şubat için 28 gün) ve hour (0-23) değerleri kullanılırsa (x, y) konumundaki söz konusu ay/gün/saat için gölge/gün

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

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

imageryQuality

enum (ImageryQuality)

Sonucun görüntüsünün kalitesi.

Tarih

Takvim tarihinin tamamını veya bir kısmını (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görecelidir. Aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Sıfır yıllı bir ay ve gün (örneğin, 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 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 olup yıl ve ay için geçerli olmalıdır veya tek başına yıl ya da günün önemli olmadığı yıl ve ay belirtmek için 0 olmalıdır.

ImageryQuality

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

Not: Görüntü kalitesi seviyesinden 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üğe sahiptir.

Sıralamalar
IMAGERY_QUALITY_UNSPECIFIED Bilinen bir kalite yok.
HIGH Temeldeki görüntüler ve DSM verileri 0,1 m/piksel olarak işlenmiştir.
MEDIUM Temeldeki görüntüler ve DSM verileri 0,25 m/piksel olarak işlendi.
LOW Temeldeki görüntüler ve DSM verileri 0,5 m/piksel olarak işlenmiştir.

Yöntemler

get

Bir konumu çevreleyen bölge için güneş enerjisi bilgilerini alır.