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)

Kiedy wykonano zdjęcia źródłowe (z których pochodzą wszystkie inne dane) z tego regionu. Nie musi to być wartość przybliżona, ponieważ zdjęcia mogły zostać zrobione wcześniej niż 1 dzień temu.

object (Date)

Podczas przetwarzania zdjęć.

string

Adres URL obrazu regionu DSM (Digital Surface Model). Wartości są podawane w metrach powyżej geoidy EGM96 (tj. poziomu morza). Nieprawidłowe lokalizacje (które nie mają danych) są przechowywane jako -9999.

string

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

string

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

string

Adres URL do rocznej mapy strumienia (rocznego światła słonecznego na dachach) regionu. Wartości to kWh/kW/rok. Jest to niemaskowany strumień: strumień jest obliczany dla każdej lokalizacji, a nie tylko dla dachów budynków. Nieprawidłowe lokalizacje są przechowywane jako -9999: lokalizacje poza obsługiwanym obszarem będą nieprawidłowe, a kilka lokalizacji w obszarze zasięgu, w których nie udało się obliczyć przepływu, również zostanie nieprawidłowych.

string

Adres URL do miesięcznej mapy strumienia (światło słoneczne na dachach, z podziałem na miesiące) w regionie. Wartości to kWh/kW/rok. GeoTIFF wskazywany przez ten adres URL będzie zawierał 12 pasm, czyli odpowiednio do stycznia i grudnia.

string

12 adresów URL co godzinę, czyli w styczniu i grudniu, po kolei. Każdy plik GeoTIFF będzie zawierać 24 pasma, co odpowiada 24 godzinom dnia. Każdy piksel to 32-bitowa liczba całkowita, która odpowiada (maksymalnie) 31 dniom danego miesiąca. 1 bit oznacza, że dla danej lokalizacji jest widoczne słońce w określonym dniu, o tej godzinie, danego miesiąca. Nieprawidłowe lokalizacje są przechowywane w postaci -9999 (ponieważ jest to wartość ujemna, ma ustawiony bit 31 – żadna prawidłowa wartość nie może mieć ustawionego bitu 31, ponieważ odpowiadałby 32 dniu miesiąca).

Przykład może być przydatny. Jeśli chcesz wiedzieć, czy punkt (w lokalizacji piksela (x, y)) zobaczył Słońce 22 czerwca o godzinie 16:00:

1. pobrać szósty adres URL z tej listy (od czerwca).
2. wyszukać 17. kanał (odpowiadający 16.00).
3. odczytaj 32-bitową wartość w punktach (x, y).
4. odczytaj bit 21 wartości (odpowiada 22. dniu miesiąca).
5. jeśli ta wartość to 1, to w tym miejscu świeciło się słońce 22 czerwca o godzinie 16:00.

Bardziej oficjalnie: biorąc pod uwagę month (1–12), day (maks. 1 miesiąc; luty 28 dni) i hour (0–23), cień/słońce w tym miesiącu/dniu/godzinie w pozycji (x, y) jest bitem

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

gdzie (x, y) oznacza indeksowanie przestrzenne, [month - 1] oznacza pobranie month - 1 adresu URL (indeksowanie od zera), indeksowanie [hour] oznacza indeksowanie kanałów, a wynik końcowy inny niż zero oznacza „słone”. Nie ma dni przestępnych, a czas letni nie istnieje (wszystkie dni trwają 24 godziny, a południe to zawsze południe).

enum (ImageryQuality)

Jakość zdjęć w wyniku wyszukiwania.

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

integer

Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku.

integer

Miesiąc w roku. Musi mieścić się w zakresie od 1 do 12 lub 0, jeśli chcesz określić rok bez miesiąca i dnia.

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.