REST Resource: dataLayers

Zasób: DataLayers

Informacje o potencjale słonecznym regionu. Rzeczywiste dane znajdują się w licznych plikach GeoTIFF obejmujących żądany region. Wiadomość zawiera adresy URL tych plików: każdy ciąg znaków w wiadomości DataLayers zawiera adres URL, z którego można pobrać odpowiedni plik GeoTIFF. Te adresy URL są ważne przez kilka godzin po wygenerowaniu. Większość plików GeoTIFF ma rozdzielczość 0,1 m/piksel, ale plik z miesięcznym natężeniem promieniowania ma rozdzielczość 0,5 m/piksel, a pliki z godzinnym natężeniem promieniowania – 1 m/piksel. Jeśli w pliku GetDataLayersRequest podana jest wartość pixelSizeMeters, to minimalna rozdzielczość w plikach GeoTIFF będzie równa tej wartości.

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

object (Date)

Kiedy zostały wykonane zdjęcia źródłowe (z których pochodzą wszystkie inne dane) w tym regionie. Jest to przybliżona wartość, ponieważ zdjęcia mogły zostać zrobione w ciągu kilku dni.
imageryProcessedDate

object (Date)

Data zakończenia przetwarzania tych obrazów.
dsmUrl

string

Adres URL obrazu DSM (cyfrowego modelu powierzchni) regionu. Wartości są podawane w metrach nad geoidem EGM96 (czyli nad poziomem morza). Nieprawidłowe lokalizacje (w których nie mamy danych) są przechowywane jako -9999.
rgbUrl

string

Adres URL obrazu z danymi RGB (zdjęcie lotnicze) regionu.
maskUrl

string

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

string

Adres URL mapy rocznego natężenia (roczne nasłonecznienie dachów) w danym regionie. Wartości są podawane w kWh/kW/rok. Jest to niezamaskowany 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 obszarem obsługiwanym będą nieprawidłowe, a niektóre lokalizacje w obszarze obsługiwanym, w których nie udało się obliczyć natężenia, również będą nieprawidłowe.
monthlyFluxUrl

string

Adres URL mapy miesięcznego natężenia (światło słoneczne na dachach, pogrupowane według miesięcy) w danym regionie. Wartości są podawane w kWh/kW/rok. GeoTIFF wskazany przez ten URL będzie zawierać 12 pasm odpowiadających kolejno styczniowi, lutym itd.
hourlyShadeUrls[]

string

12 adresów URL dla cieniowania godzinowego odpowiadających kolejno styczniowi, lutym itd. Każdy plik GeoTIFF będzie zawierać 24 pasma odpowiadające 24 godzinom w dobowej skali. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca maksymalnie 31 dniom w danym miesiącu. 1 bit oznacza, że w danym dniu i godzinie w danym miesiącu w odpowiedniej lokalizacji jest widoczne słońce. Nieprawidłowe lokalizacje są przechowywane jako -9999 (ponieważ jest to wartość ujemna, ma ustawiony bit 31, a żadna prawidłowa wartość nie może mieć ustawionego bitu 31, ponieważ odpowiadałby on 32 dniowi miesiąca).

Możesz skorzystać z przykładu. Jeśli chcesz się dowiedzieć, czy punkt (w uwzględnieniu położenia piksela (x, y)) był oświetlony przez słońce 22 czerwca o 16:00, wykonaj te czynności:

  1. pobrać 6. adres URL z tej listy (odpowiadający czerwcu).
  2. sprawdzić kanał 17 (odpowiadający godzinie 16:00).
  3. odczytywanie wartości 32-bitowej w punkcie (x, y).
  4. odczytaj bit 21 wartości (odpowiadający 22 dniu miesiąca).
  5. Jeśli ten bit ma wartość 1, oznacza to, że w tym miejscu słońce było widoczne 22 czerwca o 16:00.

Bardziej formalnie: dla month (1–12), day (1… miesiąc maksymalnie; luty ma 28 dni) i hour (0–23) cień/słońce dla danego miesiąca/dnia/godziny w pozycji (x, y) to bit

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

gdzie (x, y) to indeksowanie przestrzenne, [month - 1] to pobieranie adresu URL month - 1st (indeksowanie od zera), [hour] to indeksowanie w kanałach, a końcowy wynik inny niż zero oznacza „słonecznie”. Nie ma dni przestępnych ani czasu letniego (wszystkie dni mają 24 godziny, a południe zawsze jest „standardowym” południem).
imageryQuality

enum (ImageryQuality)

jakość obrazów w wyniku.

Data

Reprezentuje całą lub częściową datę kalendarzową, np. urodziny. Godzina i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podawana w kalendarzu gregoriańskim. Może to być:

  • Pełna data z wartościami roku, miesiąca i dnia innymi niż zero.
  • miesiąc i dzień z zerowym rokiem (np. rocznica).
  • Rok bez miesiąca i dnia.
  • Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi być liczbą z zakresu od 1 do 9999 lub 0, jeśli chcesz podać datę bez roku.
month

integer

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

integer

Dzień miesiąca. Musi zawierać wartość od 1 do 31 i być prawidłową dla roku lub miesiąca albo 0, aby określić tylko rok lub rok i miesiąc, w których przypadku dzień nie ma znaczenia.

ImageryQuality

Jakość obrazów użytych do obliczenia niektórych wyników interfejsu API.

Uwaga: niezależnie od poziomu jakości obrazów, dane DSM mają zawsze rozdzielczość 0,1 m/piksel, dane o miesięcznym natężeniu promieniowania mają zawsze rozdzielczość 0,5 m/piksel, a dane o cieni w godzinnych interwałach mają zawsze rozdzielczość 1 m/piksel.

Wartości w polu enum
IMAGERY_QUALITY_UNSPECIFIED Nie wiadomo, jaka jest jakość.
HIGH Dane dotyczące słońca pochodzą ze zdjęć lotniczych wykonanych na niskiej wysokości i przetworzonych z rozdzielczości 0,1 m/piksel.
MEDIUM Dane dotyczące energii słonecznej pochodzą ze zdjęć lotniczych o ulepszonej rozdzielczości, wykonanych na dużej wysokości i przetworzonych z rozdzielczości 0,25 m/piksel.
LOW Dane dotyczące energii słonecznej pochodzą z ulepszonych zdjęć satelitarnych przetworzonych z wysoką rozdzielczością 0,25 m/piksel.

Metody

get

 Pobiera informacje o energii słonecznej dla regionu otaczającego lokalizację.