REST Resource: dataLayers

Risorsa: DataLayers

Informazioni sul potenziale solare di una regione. I dati effettivi sono contenuti in una serie di file GeoTIFF che coprono la regione richiesta, per i quali questo messaggio contiene gli URL: ogni stringa nel messaggio DataLayers contiene un URL da cui è possibile recuperare il file GeoTIFF corrispondente. Questi URL sono validi per alcune ore dopo la loro generazione. La maggior parte dei file GeoTIFF ha una risoluzione di 0,1 m/pixel, ma il file del flusso mensile è a 0,5 m/pixel e i file dell'ombra oraria sono a 1 m/pixel. Se in GetDataLayersRequest è stato specificato un valore pixelSizeMeters, la risoluzione minima nei file GeoTIFF sarà pari a questo valore.

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

object (Date)

Quando sono state acquisite le immagini di origine (da cui sono stati ricavati tutti gli altri dati) in questa regione. È necessariamente approssimativo, in quanto le immagini potrebbero essere state scattate in più giorni.
imageryProcessedDate

object (Date)

Al termine dell'elaborazione di queste immagini.
dsmUrl

string

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

string

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

string

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

string

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

string

L'URL della mappa del flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono in kWh/kW/anno. Il file GeoTIFF a cui fa riferimento questo URL conterrà dodici bande, corrispondenti a gennaio…dicembre, in ordine.
hourlyShadeUrls[]

string

Dodici URL per l'ombra ogni ora, 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 (massimo) 31 giorni del mese; un bit 1 indica che la posizione corrispondente è in grado di vedere il sole in quel giorno, in quell'ora e in quel mese. Le località non valide vengono memorizzate come -9999 (poiché è un numero negativo, ha il bit 31 impostato e nessun valore valido potrebbe avere il bit 31 impostato, poiché corrisponderebbe al 32° giorno del mese).

Un esempio potrebbe essere utile. Se vuoi sapere se un punto (nella posizione del pixel (x, y)) ha visto il sole alle 16:00 del 22 giugno:

  1. recupera il sesto URL in questo elenco (corrispondente a giugno).
  2. Cerca il canale 17 (corrispondente alle 16:00).
  3. Leggi il valore a 32 bit in (x, y).
  4. Leggi il bit 21 del valore (corrispondente al 22 del mese).
  5. Se il bit è 1, significa che il punto ha visto il sole alle 16:00 del 22 giugno.

In modo più formale: dati month (1-12), day (1…mese max; febbraio ha 28 giorni) e hour (0-23), l'ombra/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'URL month - 1st (indicizzazione da zero), [hour] è l'indicizzazione nei canali e un risultato finale diverso da zero significa "soleggiato". Non ci sono giorni intercalari e non esiste l'ora legale (tutti i giorni durano 24 ore; mezzogiorno è sempre "mezzogiorno dell'ora standard").
imageryQuality

enum (ImageryQuality)

La qualità delle immagini del risultato.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e 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.

ImageryQuality

La qualità delle immagini utilizzate per calcolare alcuni risultati dell'API.

Nota: indipendentemente dal livello di qualità delle immagini, le uscite DSM hanno sempre una risoluzione di 0,1 m/pixel, le uscite del flusso mensile hanno sempre una risoluzione di 0,5 m/pixel e le uscite dell'ombra oraria hanno sempre una risoluzione di 1 m/pixel.

Enum
IMAGERY_QUALITY_UNSPECIFIED La qualità non è nota.
HIGH I dati solari derivano da immagini aeree acquisite a bassa quota ed elaborate a 0,1 m/pixel.
MEDIUM I dati solari derivano da immagini aeree avanzate acquisite ad alta quota ed elaborate a 0,25 m/pixel.
LOW I dati solari sono ricavati da immagini satellitari migliorate elaborate a 0,25 m/pixel.

Metodi

get

 Recupera le informazioni solari per una regione che circonda una località.