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 acquisite le immagini di origine (da cui derivano tutti gli altri dati) di questa regione. È necessariamente un'indicazione piuttosto approssimativa, in quanto le immagini potrebbero essere state scattate più di un giorno.

object (Date)

Al termine dell'elaborazione per questa immagine.

string

L'URL di un'immagine del modello di superficie digitale (Digital Surface Model) della regione. I valori sono espressi in metri sopra il geoide EGM96 (cioè il livello del mare). Le località non valide (in cui non sono disponibili dati) vengono memorizzate come -9999.

string

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

string

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

string

L'URL della mappa di flusso annuale (luce solare annuale sui tetti) della regione. I valori sono kWh/kW/anno. Questo è un flusso non mascherato: il flusso viene calcolato per ogni località, non solo per gli edifici dei tetti. Le località non valide vengono memorizzate come -9999: le località al di fuori dell'area di copertura non saranno valide e alcune località all'interno dell'area di copertura per le quali 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 gradazioni, corrispondenti a gennaio...dicembre, in ordine.

string

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

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

1. recupera il sesto URL dell'elenco (corrispondente a giugno).
2. cercate il 17° canale (corrispondente alle 16:00).
3. legge il valore a 32 bit in (x, y).
4. leggere il bit 21 del valore (corrispondente al 22 del mese).
5. se quel bit è un 1, allora 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 in una posizione (x, y) è il bit

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

dove (x, y) è l'indicizzazione spaziale, [month - 1] si riferisce al recupero dell'month - 1URL (indicizzazione da zero), [hour] ai canali e un risultato finale diverso da zero significa "soleggiato". Non esistono giorni bisestili e non esiste l'ora legale (tutti i giorni durano 24 ore; mezzogiorno è sempre "ora solare" o mezzogiorno).

enum (ImageryQuality)

La qualità delle immagini dei risultati.

{
  "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. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese.

integer

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