L'endpoint dataLayers restituisce i dati codificati come file GeoTIFF, che possono essere utilizzati in qualsiasi applicazione GIS (sistema informativo geografico) per progettare sistemi solari.
Ogni stringa nella risposta dataLayers contiene un URL che puoi utilizzare per recuperare il file GeoTIFF corrispondente. Gli URL sono validi per un massimo di un'ora dopo la generazione dalla richiesta dei livelli di dati originali. 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, poiché il contenuto è costituito da dati codificati anziché da immagini RGB. Inoltre, i file GeoTIFF non possono essere utilizzati direttamente come immagine di overlay con l'API Maps JavaScript.
La tabella seguente descrive in dettaglio ogni livello.
| incorporato | Profondità pixel | Risoluzione | Descrizione |
|---|---|---|---|
| Modello digitale della superficie (DSM) | Virgola mobile a 32 bit | 0,1 m/pixel | Dati di elevazione che rappresentano la topografia della superficie terrestre, incluse le caratteristiche naturali e artificiali. I valori sono espressi in metri sopra il 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 |
Un'immagine aerea o satellitare 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 dell'edificio | 1 bit | 0,1 m/pixel | Un bit per pixel che indica se il pixel è considerato parte di un tetto. |
| Flusso annuale | Virgola mobile a 32 bit | 0,1 m/pixel | La mappa del flusso annuale, ovvero la luce solare annuale sui tetti, della regione.
I valori sono espressi in kWh/kW/anno. Il flusso viene calcolato per ogni località, non solo per i tetti degli edifici. 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 | Virgola mobile a 32 bit | 0,5 m/pixel | La mappa del flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono espressi in kWh/kW/anno. Il file di immagini GeoTIFF contiene 12 bande corrispondenti ai mesi da gennaio a dicembre, in ordine. |
| Ombra oraria | Intero a 32 bit | 1 m/pixel | 12 URL per le mappe delle ombre orarie corrispondenti ai mesi da gennaio a dicembre, in
ordine. Ogni file GeoTIFF contiene 24 bande, corrispondenti alle 24 ore del giorno. Ogni pixel è un intero a 32 bit, corrispondente ai (massimo) 31 giorni del mese. Un bit 1 indica che la località corrispondente può vedere il sole in quel giorno, a quell'ora, in quel mese. Le località non valide vengono memorizzate come -9999 e hanno il bit 31 impostato, poiché corrisponde al 32° giorno del mese e pertanto non è valido. |
Decodificare i raster delle ombre orarie
I dati delle ombre orarie sono codificati in raster multibanda. Per saperne di più sulle nozioni di base dei raster, consulta Concetti dell'API Solar.
Quando effettui una richiesta di dati sulle ombre orarie, 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 corrispondono ai (massimo) 31 giorni del mese. La decodifica del giorno, dell'ora e del mese dei dati delle ombre richiede quindi la comprensione del bit, della banda e del raster che stai analizzando.
Ad esempio, per verificare se una determinata località con coordinate (x, y) ha visto il sole alle 16:00 del 22 giugno, procedi nel seguente modo:
- Invia una richiesta di livelli di dati per tutti i livelli della località (x, y).
- Poiché il mese di giugno è il sesto mese dell'anno, recupera il sesto URL nell'elenco
hourlyShadeUrls. - Le bande orarie sono indicate in formato 24 ore. Per ottenere i dati per le 16:00, cerca il 17° canale.
- I bit (giorni) sono indicizzati a partire da 0. Per ottenere i dati per il 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 località ha visto il sole. Se il bit è 0, la località ha visto l'ombra.
Il seguente codice riassume i passaggi precedenti:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))