REST Resource: dataLayers

Kaynak: DataLayers

Bir bölgenin güneş enerjisi potansiyeli hakkında bilgiler. Gerçek veriler, istenen bölgeyi kapsayan bir dizi GeoTIFF dosyasında bulunur. Bu mesajda, bu dosyaların URL'leri yer alır: DataLayers mesajındaki her dize, ilgili GeoTIFF'in getirilebileceği bir URL içerir. Bu URL'ler, oluşturulduktan sonra birkaç saat boyunca geçerlidir. GeoTIFF dosyalarının çoğu 0,1 m/piksel çözünürlüğe sahiptir ancak aylık akış dosyası 0,5 m/piksel, saatlik gölge dosyaları ise 1 m/piksel çözünürlüğe sahiptir. 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 türetildiği) çekildiği zaman. Görüntüler birden fazla günde çekilmiş olabileceğinden bu değerin yaklaşık olması gerekir.
imageryProcessedDate

object (Date)

Bu görüntülerin işlenmesi tamamlandığında.
dsmUrl

string

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

string

Bölgenin RGB verilerinin (hava fotoğrafı) görüntüsünün URL'si.
maskUrl

string

Bina maskesi resminin URL'si: Pikselin çatıya ait olup olmadığını belirten, piksel başına bir bit.
annualFluxUrl

string

Bölgenin yıllık akı haritasının (çatılardaki yıllık güneş ışığı) URL'si. Değerler kWh/kW/yıl şeklindedir. Bu, maskelenmemiş akıdır: Akı, yalnızca bina ç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çersizdir. Kapsama alanı içindeki akıyı hesaplayamadığımız birkaç konum da geçersizdir.
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ırasıyla Ocak-Aralık aylarına karşılık gelen on iki bant içerir.
hourlyShadeUrls[]

string

Ocak-Aralık aylarına karşılık gelen, saatlik gölge için on iki URL. Her GeoTIFF, günün 24 saatine karşılık gelen 24 bant içerir. Her piksel, o ayın (en fazla) 31 gününe karşılık gelen 32 bitlik bir tam sayıdır. 1 bit, ilgili konumun o ayın o gününde o saatte güneşi görebildiği anlamına gelir. Geçersiz konumlar -9999 olarak saklanır (bu değer negatif olduğundan 31. bit ayarlanmıştır ve geçerli bir değerde 31. bit ayarlanamaz. Aksi takdirde bu, ayın 32. gününe karşılık gelir).

Örnekler 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 ayına karşılık gelen) getirin.
  2. 17. kanalı (saat 16:00'ya karşılık gelir) arayın.
  3. (x, y) konumundaki 32 bitlik değeri okur.
  4. Değerin 21. bitini (ayın 22. gününe karşılık gelir) okuyun.
  5. Bu bit 1 ise söz konusu nokta 22 Haziran saat 16:00'da güneş görmüştür.

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

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

Burada (x, y), uzamsal dizine ekleme, [month - 1], month - 1st URL'yi getirme (sıfırdan dizine ekleme), [hour], kanallara dizine ekleme anlamına gelir ve sıfır olmayan son sonuç "güneşli" demektir. Artık günler yoktur ve yaz saati uygulaması yapılmaz (tüm günler 24 saat sürer; öğlen her zaman "standart saat" öğlenidir).
imageryQuality

enum (ImageryQuality)

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

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Ay ve gün, sıfır yılıyla (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Bir yıl ve ay, sıfır günle (örneğin, 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 olmalı 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 olmalı veya ay ve gün içermeyen 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. Yalnızca bir yılı veya günün önemli olmadığı bir 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 çözünürlüğe, aylık akı çıkışları her zaman 0,5 m/piksel çözünürlüğe ve saatlik gölge çıkışları her zaman 1 m/piksel çözünürlüğe sahiptir.

Sıralamalar
IMAGERY_QUALITY_UNSPECIFIED Kalite bilinmiyor.
HIGH Güneş enerjisi verileri, düşük irtifada çekilen ve 0,1 m/piksel çözünürlükte işlenen hava görüntülerinden elde edilir.
MEDIUM Güneş enerjisi verileri, yüksek irtifada çekilen ve 0,25 m/piksel çözünürlükte işlenen gelişmiş hava görüntülerinden elde edilir.
BASE 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 etrafındaki bölge için güneş enerjisi bilgilerini alır.