L'endpoint dataLayers restituisce dati codificati come file GeoTIFF, che possono essere utilizzati in qualsiasi applicazione di sistema di informazione geografica (GIS) per progettare sistemi solari.
Ogni stringa nella risposta dataLayers contiene un URL che puoi utilizzare per recuperare il GeoTIFF corrispondente. Gli URL sono validi per un massimo di un'ora dopo essere stati generati dalla richiesta di livelli dati originale. I file GeoTIFF possono essere archiviati per un massimo di 30 giorni.
Ad eccezione del livello RGB, i file GeoTIFF non vengono visualizzati correttamente con un visualizzatore di immagini, perché i contenuti sono dati codificati anziché immagini RGB. Inoltre, i file GeoTIFF non possono essere utilizzati direttamente come immagine overlay con l'API Maps JavaScript.
La seguente tabella descrive in dettaglio ogni livello.
| incorporato | Profondità di pixel | Risoluzione | Descrizione |
|---|---|---|---|
| Digital Surface Model (DSM) | Numero in virgola mobile a 32 bit | 0,1 m/pixel | Dati di elevazione che rappresentano la topografia della superficie terrestre, inclusi gli elementi naturali e costruiti. I valori sono in metri sul livello del mare. Le località non valide o le aree in cui non disponiamo di dati vengono memorizzate come -9999. |
| RGB | 8 bit | 0,1 m/pixel 0,25 m/pixel 0,5 m/pixel 1 m/pixel |
Un'immagine aerea della regione. Il file di immagini GeoTIFF contiene tre bande corrispondenti ai valori rosso, verde e blu per formare un valore RGB a 24 bit per ogni pixel. Per impostazione predefinita, la risoluzione dei pixel è 0,1 m/pixel. |
| Maschera di creazione | 1 bit | 0,1 m/pixel | Un bit per pixel che indica se il pixel è considerato parte di un tetto. |
| Flusso annuale | Numero in virgola mobile a 32 bit | 0,1 m/pixel | La mappa di flusso annuale o la luce solare annuale sui tetti della regione.
I valori sono kWh/kW/anno. Il flusso viene calcolato per qualsiasi località, non solo per la costruzione di tetti. Le località non valide o le aree in cui non è stato possibile calcolare il flusso vengono memorizzate come -9999. Le località al di fuori della nostra area di copertura non sono valide. Nota: si tratta di un flusso non mascherato. |
| Flusso mensile | Numero in virgola mobile a 32 bit | 0,5 m/pixel | La mappa di flusso mensile (luce del sole sui tetti, suddivisa per mese) della regione. I valori sono kWh/kW/anno. Il file di immagini GeoTIFF contiene 12 bande, nell'ordine compreso tra gennaio e dicembre. |
| Ombra oraria | Numero intero a 32 bit | 1 m/pixel | 12 URL per le mappe delle tonalità orarie corrispondenti a gennaio-dicembre, in
ordine. Ogni file GeoTIFF contiene 24 bande, corrispondenti alle 24 ore del giorno. Ogni pixel è un numero intero a 32 bit che corrisponde ai (fino a) 31 giorni del mese. 1 bit significa che la località corrispondente è in grado di vedere il sole in quel giorno, a quell'ora, di quel mese. Le località non valide sono memorizzate come -9999 e hanno il bit 31 impostato, che corrisponde al 32° giorno del mese e quindi non sono valide. |
Decodifica i raster delle ombre ogni ora
I dati delle sfumature orarie sono codificati in raster multibanda. Per scoprire di più sulle nozioni di base raster, leggi la pagina Concetti di base dell'API Solar.
Quando effettui una richiesta per i dati orari delle ombre, puoi ricevere fino a 12 raster, uno per ogni mese dell'anno solare (da gennaio a dicembre). Ogni raster è composto da 24 livelli, o bande, che corrispondono alle 24 ore del giorno.
Ogni banda è rappresentata da una matrice di celle, o pixel. Ogni pixel ha una profondità di 32 bit, che corrisponde al (massimo) 31 giorni del mese. Pertanto, la decodifica del giorno, dell'ora e del mese dei dati delle ombreggiature richiede la comprensione del bit, della banda e del raster che stai analizzando.
Ad esempio, per capire se un determinato luogo nelle coordinate (x, y) ha visto il sole alle 16:00 del 22 giugno, procedi nel seguente modo:
- Effettua una richiesta di livelli dati per tutti i livelli per la posizione (x, y).
- Poiché il mese di giugno è il sesto mese dell'anno, recupera il sesto URL nell'elenco
hourlyShadeUrls. - Le fasce orarie sono indicate nel formato 24 ore. Per ottenere i dati delle 16:00, cerca il 17° canale.
- Indice di bit (giorni) da 0. Per ottenere i dati del 22 giugno, leggi il bit 21.
- I bit forniscono dati binari che indicano se la località ha visto il sole alla data e all'ora indicate. Se il bit è 1, la posizione ha visto il sole. Se il bit è 0, la posizione ha visto ombra.
Il seguente codice riassume i passaggi precedenti:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))