L'endpoint di dataLayers restituisce dati codificati come file GeoTIFF, che possono essere utilizzati in qualsiasi un'applicazione di sistemi informativi (GIS) per la progettazione di sistemi solari.
Ogni stringa nella risposta di dataLayers contiene un URL, che puoi per recuperare il GeoTIFF corrispondente. Gli URL sono validi fino a un'ora dopo la loro generazione dalla richiesta dei livelli di dati originali. I file GeoTIFF possono essere per un massimo di 30 giorni.
Ad eccezione del livello RGB, i file GeoTIFF non vengono visualizzati correttamente con un visualizzatore di immagini, in quanto i contenuti sono dati codificati anziché immagini RGB. GeoTIFF Inoltre, i file 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 | I dati di elevazione che rappresentano la topografia della superficie terrestre, incluse le caratteristiche naturali e quelle costruite. I valori sono in metri sul livello del mare livello. 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 di rosso, verde e blu per formare
Valore RGB a 24 bit per ogni pixel. Per impostazione predefinita, la risoluzione dei pixel è di 0,1 m/pixel. |
| Maschera di creazione | 1 bit | 0,1 m/pixel | Un bit per pixel che indica se il pixel è considerato come in 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 ogni località, non solo costruendo tetti. Località non valide o aree non accessibili calcolare flusso, sono memorizzati come -9999. Sedi al di fuori di area di copertura non sono validi. Nota: si tratta di un flusso non mascherato. |
| Flusso mensile | Numero in virgola mobile a 32 bit | 0,5 m/pixel | La mappa dei flussi mensile (luce del sole sui tetti, suddivisa per mese) del regione. I valori sono kWh/kW/anno. Il file di immagini GeoTIFF contiene 12 fasce corrispondenti a gennaio-dicembre, in ordine. |
| Ombra oraria | Numero intero a 32 bit | 1 m/pixel | 12 URL per le mappe delle ombre orarie corrispondenti a gennaio-dicembre, in
ordine. Ogni file GeoTIFF contiene 24 bande, corrispondenti ai 24 ore al giorno. Ogni pixel è un numero intero a 32 bit, corrispondente al (fino a) 31 giorni del mese in questione. 1 bit indica che le istanze corrispondenti posizione è in grado di vedere il sole di quel giorno, a quell'ora, di quel mese. Le località non valide sono memorizzate come -9999 e hanno il bit 31 impostato, come che corrisponde al 32° giorno del mese e pertanto non è valido. |
Decodifica i raster delle ombre ogni ora
I dati delle sfumature orarie sono codificati in raster multibanda. Per ulteriori informazioni sul raster consulta i concetti dell'API Solar.
Quando effettui una richiesta di dati orari sulle ombre, puoi ricevere fino a 12 raster, una per ogni mese dell'anno solare (da gennaio a dicembre). Ogni raster è composto da 24 strati, o bande, che corrispondono alle 24 ore del giorno.
Ogni banda è rappresentata da una matrice di celle, o pixel. Ogni pixel ha un di 32 bit, che corrispondono ai 31 giorni (massimo) del mese. La decodifica del giorno, dell'ora e del mese dei dati sull'ombra richiede quindi di comprendere i bit, le bande e il raster che stai analizzando.
Ad esempio, per identificare se un determinato luogo alle coordinate (x, y) ha visto dom alle 16:00 del 22 giugno:
- 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 mese
URL nell'elenco
hourlyShadeUrls. - Le fasce orarie sono indicate nel formato 24 ore. Per ottenere i dati delle 16:00 (16:00), cercare 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 quella posizione ha visto il sole alla una determinata data e ora. Se il bit è 1, la posizione ha visto il sole. Se il bit è 0, l'ombra.
Il seguente codice riassume i passaggi precedenti:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))