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)

Quando sono state scattate le immagini di origine (da cui sono derivati tutti gli altri dati) di questa regione. È necessariamente un po' approssimativo, in quanto le immagini potrebbero essere state acquisite più di un giorno.

object (Date)

Al termine dell'elaborazione di queste immagini.

string

L'URL di un'immagine del DSM (Digital Surface Model) della regione. I valori sono in metri sopra il geoide EGM96 (ad es. il livello del mare). Le località non valide (per le quali non disponiamo di dati) vengono memorizzate come -9999.

string

L'URL di un'immagine di dati RGB (foto aerea) della regione.

string

L'URL dell'immagine della maschera dell'edificio: un bit per pixel che indica se quel pixel è considerato parte di un tetto o meno.

string

L'URL della mappa di flusso annuale (la luce solare annuale sui tetti) della regione. I valori sono kWh/kW/anno. Si tratta di un flusso non mascherato: il flusso viene calcolato per ogni località, non solo per la costruzione di tetti. Le località non valide sono memorizzate come -9999: le località al di fuori dell'area di copertura non saranno valide, mentre anche alcune località all'interno dell'area di copertura in cui non è stato possibile calcolare il flusso non saranno valide.

string

L'URL della mappa di flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono kWh/kW/anno. Il GeoTIFF a cui punta questo URL conterrà dodici bande, corrispondenti a gennaio...dicembre, in sequenza.

string

Dodici URL per l'ombra oraria, corrispondenti a gennaio...dicembre, in ordine. Ogni GeoTIFF conterrà 24 bande, corrispondenti alle 24 ore del giorno. Ogni pixel è un numero intero a 32 bit corrispondente ai (fino a) 31 giorni del mese in questione. a 1 bit significa che la posizione corrispondente è in grado di vedere il sole in quel giorno, di quell'ora, di quel mese. Le località non valide sono memorizzate come -9999 (dato che è negativo, è impostato il bit 31 e nessun valore valido potrebbe avere il bit 31 impostato perché corrisponderebbe al 32 ° giorno del mese).

Può essere utile un esempio. Per sapere se un punto (nella posizione del pixel (x, y)) ha visto il sole alle 16:00 del 22 giugno, devi:

1. recupera il sesto URL di questo elenco (corrispondente a giugno).
2. cercare il 17° canale (corrispondente alle 16:00).
3. leggere il valore a 32 bit in (x, y).
4. si legge il bit 21 del valore (corrispondente al 22 del mese).
5. se quella parte è un 1, quel punto ha visto il sole alle 16:00 del 22 giugno.

Più formalmente: dati month (1-12), day (1...mese massimo; febbraio ha 28 giorni) e hour (0-23), l'ombra/il sole per quel mese/giorno/ora nella posizione (x, y) è la parte

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

dove (x, y) sta eseguendo l'indicizzazione spaziale, [month - 1] si riferisce al recupero del month - 1° URL (indicizzazione da zero), [hour] sta eseguendo l'indicizzazione nei canali e un risultato finale diverso da zero indica "solato". Non esistono giorni bisestili e l'ora legale non esiste (tutti i giorni durano 24 ore; mezzogiorno è sempre "ora standard" mezzogiorno).

enum (ImageryQuality)

La qualità delle immagini del risultato.

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

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.