L'endpoint dataLayers restituisce i dati codificati come file GeoTIFF, che possono essere utilizzati in qualsiasi applicazione di sistema informativo geografico (GIS) per progettare impianti solari.
Ogni stringa nella risposta dataLayer contiene un URL, che puoi utilizzare per recuperare il GeoTIFF corrispondente. Gli URL sono validi fino a un'ora dopo essere stati generati dalla richiesta dei livelli 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é 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 tabella seguente descrive ogni livello in dettaglio.
| ponderazioni | Profondità pixel | Risoluzione | Descrizione |
|---|---|---|---|
| Digital Surface Model (DSM) | Floating a 32 bit | 0,1 m/pixel | Dati di elevazione che rappresentano la topografia della superficie terrestre, inclusi 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 archiviate 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 di rosso, verde e blu per formare un valore RGB a 24 bit per ogni pixel. Per impostazione predefinita, la risoluzione dei pixel è di 0,1 m/pixel. |
| Maschera per l'edificio | 1 bit | 0,1 m/pixel | Un bit per pixel che indica se il pixel è considerato parte di un tetto. |
| Flusso annuale | Floating a 32 bit | 0,1 m/pixel | La mappa del flusso annuale o la luce solare annuale sui tetti di una regione.
I valori sono 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: questo è un flusso non mascherato. |
| Flusso mensile | Floating 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 gradazioni corrispondenti a gennaio-dicembre, in ordine. |
| Area oraria | Numero intero a 32 bit | 1 m/pixel | 12 URL per le mappe tonalità orarie corrispondenti a gennaio-dicembre, in ordine. Ogni file GeoTIFF contiene 24 bande, che corrispondono alle 24 ore del giorno. Ogni pixel è un numero intero a 32 bit, corrispondente ai 31 giorni (fino a) di quel mese. 1 bit indica che la località corrispondente può vedere il sole in quel giorno, a quell'ora di quel mese. Le località non valide vengono memorizzate come -9999 e hanno il bit 31 impostato, che corrisponde al 32° giorno del mese e pertanto non è valido. |
Decodifica i raster di tonalità orarie
I dati orari delle aree sono codificati in raster multibanda. Per scoprire di più sulle nozioni di base del raster, consulta i concetti dell'API Solar.
Quando effettui una richiesta di dati orari delle aree, puoi ricevere fino a 12 raster, uno per ogni mese dell'anno di calendario (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 ai 31 giorni (massimo) del mese. Pertanto, la decodifica del giorno, dell'ora e del mese dei dati di tonalità richiede la comprensione del bit, della banda e del raster che stai analizzando.
Ad esempio, per sapere se un determinato luogo alle coordinate (x, y) ha visualizzato il sole alle 16:00 del 22 giugno:
- Crea una richiesta dei livelli dati per tutti i livelli relativi alla posizione (x, y).
- Poiché il mese di giugno è il sesto mese dell'anno, recupera il sesto URL nell'elenco
hourlyShadeUrls. - Le bande orarie sono indicate nel formato 24 ore. Per ottenere i dati per le 16:00 (16:00), cerca il 17° canale.
- Indice di bit (giorni) da 0. Per ottenere i dati relativi al 22 giugno, leggi il bit 21.
- I bit forniscono dati binari che indicano se la località ha visto il sole nella data e all'ora specificate. Se il bit è 1, la località ha rilevato il sole. Se il bit è 0, la posizione ha visto l'ombra.
Il seguente codice riassume i passaggi precedenti:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))