Risorsa: Livelli Dati
Informazioni sul potenziale solare di una regione. I dati effettivi sono contenuti in una serie di file GeoTIFF che coprono la regione richiesta, per i quali il messaggio contiene degli URL: ogni stringa nel 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 è a 0,5 m/pixel e i file delle tonalità orarie sono a 1 m/pixel. Se in GetDataLayersRequest
è stato specificato un valore pixelSizeMeters
, la risoluzione minima nei file GeoTIFF sarà tale valore.
Rappresentazione JSON |
---|
{ "imageryDate": { object ( |
Campi | |
---|---|
imageryDate |
Quando sono state acquisite le immagini di origine (da cui derivano tutti gli altri dati) di questa regione. È necessariamente un'indicazione piuttosto approssimativa, in quanto le immagini potrebbero essere state scattate più di un giorno. |
imageryProcessedDate |
Al termine dell'elaborazione per questa immagine. |
dsmUrl |
L'URL di un'immagine del modello di superficie digitale (Digital Surface Model) della regione. I valori sono espressi in metri sopra il geoide EGM96 (cioè il livello del mare). Le località non valide (in cui non sono disponibili dati) vengono memorizzate come -9999. |
rgbUrl |
L'URL di un'immagine dei dati RGB (foto aerea) della regione. |
maskUrl |
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 |
L'URL della mappa di flusso annuale (luce solare annuale sui tetti) della regione. I valori sono kWh/kW/anno. Questo è un flusso non mascherato: il flusso viene calcolato per ogni località, non solo per gli edifici dei tetti. Le località non valide vengono memorizzate come -9999: le località al di fuori dell'area di copertura non saranno valide e alcune località all'interno dell'area di copertura per le quali non è stato possibile calcolare il flusso non saranno valide. |
monthlyFluxUrl |
L'URL della mappa di flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono kWh/kW/anno. Il GeoTIFF a cui punta questo URL conterrà dodici gradazioni, corrispondenti a gennaio...dicembre, in ordine. |
hourlyShadeUrls[] |
Dodici URL per l'area oraria, corrispondenti a gennaio...dicembre, in ordine. Ogni GeoTIFF conterrà 24 bande, corrispondenti alle 24 ore della giornata. Ogni pixel è un numero intero a 32 bit, corrispondente ai (fino a) 31 giorni di quel mese; 1 bit significa che la posizione corrispondente è in grado di vedere il sole in quel giorno, di quell'ora, di quel mese. Le posizioni non valide vengono memorizzate come -9999 (poiché questo è negativo, ha 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. Per sapere se un punto (nella posizione del pixel (x, y)) ha rilevato il sole alle 16:00 del 22 giugno:
Più formalmente: dati
dove |
imageryQuality |
La qualità delle immagini dei risultati. |
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 non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti valori:
- Una data completa, con valori di anno, mese e giorno diversi da zero.
- Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
- Un anno per sé, con un mese e un giorno zero.
- Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).
Tipi correlati:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
Giorno del mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 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à dell'immagine, gli output del file DSM hanno sempre una risoluzione di 0,1 m/pixel, gli output di flusso mensili hanno sempre una risoluzione di 0,5 m/pixel e gli output di tonalità orarie hanno sempre una risoluzione di 1 m/pixel.
Enum | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
Nessuna qualità nota. |
HIGH |
Le immagini sottostanti e i dati di DSM sono stati elaborati a 0,1 m/pixel. |
MEDIUM |
Le immagini soggiacenti e i dati presenti nel sistema sono stati elaborati a 0,25 m/pixel. |
LOW |
Le immagini sottostanti e i dati di DSM sono stati elaborati a 0,5 m/pixel. |
Metodi |
|
---|---|
|
Recupera le informazioni sull'energia solare per una regione intorno a una località. |