REST Resource: dataLayers

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

object (Date)

Data wykonania zdjęć źródłowych w tym regionie (z których pochodzą wszystkie pozostałe dane). Są to tylko przybliżone wartości, ponieważ zdjęcia mogły zostać zrobione w ciągu więcej niż jednego dnia.

object (Date)

Kiedy ten obraz został przetworzony.

string

Adres URL zdjęcia regionu DSM (Digital Surface Model). Wartości są podawane w metrach powyżej geoidy EGM96 (czyli poziomu morza). Nieprawidłowe lokalizacje (jeśli nie mamy danych) są przechowywane jako -9999.

string

Adres URL zdjęcia danych RGB (zdjęcia lotniczego) regionu.

string

Adres URL obrazu maski budynku: po 1 bitze na piksel informujący, czy piksel jest uważany za część dachu, czy nie.

string

Adres URL rocznej mapy natężenia światła słonecznego (rocznego światła słonecznego na dachach) regionu. Wartości to kWh/kW/rok. To strumień niezamaskowany: strumień jest obliczany dla każdej lokalizacji, a nie tylko dla dachów budynków. Nieprawidłowe lokalizacje są zapisywane jako -9999: lokalizacje spoza obsługiwanego obszaru będą nieprawidłowe, a kilka lokalizacji wewnątrz obszaru zasięgu, w przypadku których nie udało się obliczyć strumienia, również będzie nieprawidłowych.

string

Adres URL miesięcznej mapy strumienia światła (słońce na dachach, z podziałem na miesiące) regionu. Wartości to kWh/kW/rok. GeoTIFF wskazywany przez ten adres URL będzie zawierać dwanaście pasm w kolejności odpowiednio od stycznia do grudnia.

string

12 adresów URL na godzinę w kolejności od stycznia do grudnia. Każde GeoTIFF obejmuje 24 pasma odpowiadające 24 godzinom doby. Każdy piksel jest 32-bitową liczbą całkowitą odpowiadającą 31 dniom danego miesiąca (maksymalnie); 1 bit oznacza, że odpowiednia lokalizacja jest widoczna w danym dniu, o tej godzinie i w danym miesiącu. Nieprawidłowe lokalizacje są zapisywane jako -9999 (ponieważ są one ujemne, ma ustawiony bit 31, a żadna prawidłowa wartość nie może mieć fragmentu 31, który odpowiada 32. dniu miesiąca).

Może Ci się przydać przykład: Aby dowiedzieć się, czy punkt (w lokalizacji piksela (x, y)) widział słońce o 16:00 22 czerwca, wykonaj te czynności:

1. pobiera szósty adres URL z tej listy (odpowiadający czerwcu).
2. Wyszukaj 17. kanał (od godziny 16:00).
3. odczytuj wartość 32-bitową w punkcie (x, y).
4. odczytuje bit 21 wartości (odpowiadający 22. dniu miesiąca).
5. jeśli ten fragment to 1, to znaczy, że ta pozycja widziała słońce o 16:00 22 czerwca.

Bardziej formalnie: przy danych month (1–12), day (maks. 1... miesiąc; luty ma 28 dni) i hour (0–23)) cień/słońce dla tego miesiąca/dnia/godziny na pozycji (x, y) to bit

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

gdzie (x, y) oznacza indeksowanie przestrzenne, [month - 1] oznacza pobieranie month - 1 adresu URL (indeksowanie od zera), [hour] oznacza indeksowanie kanałów, a końcowy wynik inny niż 0 oznacza „słoneczny”. Nie ma dni przestępnych ani czasu letniego (wszystkie dni trwają 24 godziny, a południe to zawsze „standardowa godzina 12:00”).

enum (ImageryQuality)

Jakość zdjęć z wyniku.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0, aby określić datę bez roku.

integer

Miesiąc w roku. Należy podać wartość z zakresu od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.

integer

Dzień miesiąca. Należy podać wartość z zakresu od 1 do 31 i ważną dla roku i miesiąca lub 0, aby określić sam rok lub rok i miesiąc, w którym dzień nie jest istotny.