REST Resource: dataLayers

Risorsa: Data Layer

Informazioni sul potenziale di energia 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 URL: ogni stringa del messaggio DataLayers contiene un URL da cui è possibile recuperare il GeoTIFF corrispondente. Questi URL sono validi per alcune ore dopo la generazione. La maggior parte dei file GeoTIFF ha una risoluzione di 0,1 m/pixel, ma il file di flusso mensile ha una risoluzione di 0,5 m/pixel e i file di ombreggiatura oraria hanno una risoluzione di 1 m/pixel. Se è stato specificato un valore pixelSizeMeters in GetDataLayersRequest, la risoluzione minima nei file GeoTIFF sarà 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 scattate le immagini di origine (da cui derivano tutti gli altri dati) in questa regione. È necessariamente approssimativa, in quanto le immagini potrebbero essere state scattate in più di un giorno.
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 posizioni non valide (per le quali non disponiamo di 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 parte di un tetto o meno.
annualFluxUrl

string

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

string

L'URL della mappa del flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono kWh/kW/anno. Il file GeoTIFF indicato da questo URL conterrà dodici bande, corrispondenti ai mesi di gennaio-dicembre, in ordine.
hourlyShadeUrls[]

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; un bit 1 significa che la posizione corrispondente è in grado di vedere il sole in quel giorno, in quell'ora, in quel mese. Le posizioni non valide vengono memorizzate come -9999 (poiché questo valore è negativo, 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. Se vuoi 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. cerca il 17° canale (corrispondente alle 16:00).
  3. legge 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, il punto ha visto il sole alle 16:00 del 22 giugno.

Più formalmente: dati month (1-12), day (1...max mese; 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 del month - 1° URL (indicizzazione da zero), [hour] è l'indicizzazione nei canali e un risultato finale diverso da zero significa "soleggiato". Non ci sono anni bisestili e l'ora legale non esiste (tutti i giorni durano 24 ore; mezzogiorno è sempre mezzogiorno "ora solare").
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 sono irrilevanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • 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

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 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, gli output DSM hanno sempre una risoluzione di 0,1 m/pixel, gli output di flusso mensile hanno sempre una risoluzione di 0,5 m/pixel e gli output di ombreggiatura oraria hanno sempre una risoluzione di 1 m/pixel.

Enum
IMAGERY_QUALITY_UNSPECIFIED Nessuna qualità 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 migliorate acquisite ad alta quota ed elaborate a 0,25 m/pixel.
BASE I dati solari derivano da immagini satellitari migliorate elaborate a 0,25 m/pixel.

Metodi

get

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