Indice
Solar
(interfaccia)BuildingInsights
(messaggio)CashPurchaseSavings
(messaggio)DataLayerView
(enum)DataLayers
(messaggio)FinancedPurchaseSavings
(messaggio)FinancialAnalysis
(messaggio)FinancialDetails
(messaggio)FindClosestBuildingInsightsRequest
(messaggio)GetDataLayersRequest
(messaggio)GetGeoTiffRequest
(messaggio)ImageryQuality
(enum)LatLngBox
(messaggio)LeasingSavings
(messaggio)RoofSegmentSizeAndSunshineStats
(messaggio)RoofSegmentSummary
(messaggio)SavingsOverTime
(messaggio)SizeAndSunshineStats
(messaggio)SolarPanel
(messaggio)SolarPanelConfig
(messaggio)SolarPanelOrientation
(enum)SolarPotential
(messaggio)
Solare
Definizione del servizio per l'API Solar.
FindClosestBuildingInsights |
---|
Individua l'edificio il cui centroide è più vicino a un punto di query. Restituisce un errore con codice
|
GetDataLayers |
---|
Recupera le informazioni solari per una regione che circonda una località. Restituisce un errore con codice
|
GetGeoTiff |
---|
Restituisce un'immagine in base al relativo ID.
|
BuildingInsights
Messaggio di risposta per Solar.FindClosestBuildingInsights
. Informazioni sulla posizione, sulle dimensioni e sul potenziale solare di un edificio.
Campi | |
---|---|
name |
Il nome della risorsa per l'edificio, nel formato |
center |
Un punto vicino al centro dell'edificio. |
bounding_box |
Il riquadro delimitatore dell'edificio. |
imagery_date |
Data di acquisizione delle immagini sottostanti. Si tratta di una stima approssimativa. |
imagery_processed_date |
Al termine dell'elaborazione di queste immagini. |
postal_code |
Codice postale (ad es. (codice postale statunitense) che contiene l'edificio. |
administrative_area |
L'area amministrativa 1 (ad es. lo stato negli Stati Uniti) che contiene l'edificio. Ad esempio, negli Stati Uniti l'abbreviazione potrebbe essere "MA" o "CA". |
statistical_area |
Area statistica (ad es. Distretto di censimento degli Stati Uniti) in cui si trova l'edificio. |
region_code |
Codice della regione in cui si trova l'edificio. |
solar_potential |
Potenziale solare dell'edificio. |
imagery_quality |
La qualità delle immagini utilizzate per calcolare i dati di questo edificio. |
CashPurchaseSavings
Costo e vantaggio di un acquisto diretto di una determinata configurazione di pannelli solari con un determinato utilizzo di elettricità.
Campi | |
---|---|
out_of_pocket_cost |
Costo iniziale prima degli incentivi fiscali: l'importo che deve essere pagato di tasca propria. È diverso da |
upfront_cost |
Costo iniziale dopo gli incentivi fiscali: si tratta dell'importo da pagare durante il primo anno. A differenza di |
rebate_value |
Il valore di tutti gli sgravi fiscali. |
savings |
La quantità di risparmio (o meno) nel periodo di tempo del ciclo di vita. |
payback_years |
Numero di anni fino al ritorno sull'investimento. Un valore negativo indica che il ritorno sull'investimento non si verifica mai nel periodo di tempo del lifetime. |
DataLayerView
Il sottoinsieme di informazioni solari da restituire.
Enum | |
---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
Equivalente a COMPLETO. |
DSM_LAYER |
Ricevi solo DSM. |
IMAGERY_LAYERS |
Ottieni il DSM, l'RGB e la maschera. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Ottieni DSM, RGB, maschera e flusso annuale. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Visualizza DSM, RGB, maschera, flusso annuale e flusso mensile. |
FULL_LAYERS |
Ottieni tutti i dati. |
DataLayers
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 questo messaggio contiene gli URL: ogni stringa nel messaggio DataLayers
contiene un URL da cui è possibile recuperare il file GeoTIFF corrispondente. Questi URL sono validi per alcune ore dopo la loro generazione. La maggior parte dei file GeoTIFF ha una risoluzione di 0,1 m/pixel, ma il file del flusso mensile ha una risoluzione di 0,5 m/pixel e i file dell'ombra oraria hanno una risoluzione di 1 m/pixel. Se in GetDataLayersRequest
è stato specificato un valore pixel_size_meters
, la risoluzione minima nei file GeoTIFF sarà pari a questo valore.
Campi | |
---|---|
imagery_date |
Quando sono state acquisite le immagini di origine (da cui sono stati ricavati tutti gli altri dati) in questa regione. È necessariamente approssimativo, in quanto le immagini potrebbero essere state scattate in più giorni. |
imagery_processed_date |
Al termine dell'elaborazione di queste immagini. |
dsm_url |
L'URL di un'immagine del DSM (Digital Surface Model) della regione. I valori sono in metri sopra il geoide EGM96 (ovvero il livello del mare). Le località non valide (per le quali non abbiamo dati) vengono archiviate come -9999. |
rgb_url |
L'URL di un'immagine dei dati RGB (foto aerea) della regione. |
mask_url |
L'URL dell'immagine della maschera dell'edificio: un bit per pixel che indica se il pixel è considerato o meno parte di un tetto. |
annual_flux_url |
L'URL della mappa del flusso annuale (luce solare annuale sui tetti) della regione. I valori sono in kWh/kW/anno. Si tratta di flusso non mascherato: il flusso viene calcolato per ogni posizione, non solo per i tetti degli edifici. Le località non valide vengono memorizzate come -9999: le località al di fuori della nostra area di copertura non saranno valide e alcune località all'interno dell'area di copertura, in cui non è stato possibile calcolare il flusso, non saranno valide. |
monthly_flux_url |
L'URL della mappa del flusso mensile (luce solare sui tetti, suddivisa per mese) della regione. I valori sono in kWh/kW/anno. Il file GeoTIFF a cui fa riferimento questo URL conterrà dodici bande, corrispondenti a gennaio…dicembre, in ordine. |
hourly_shade_urls[] |
Dodici URL per l'ombra ogni ora, corrispondenti a gennaio…dicembre, in ordine. Ogni GeoTIFF conterrà 24 bande, corrispondenti alle 24 ore del giorno. Ogni pixel è un numero intero a 32 bit, corrispondente ai (massimo) 31 giorni del mese; un bit 1 indica che la posizione corrispondente è in grado di vedere il sole in quel giorno, in quell'ora e in quel mese. Le località non valide vengono memorizzate come -9999 (poiché è un valore negativo, ha il bit 31 impostato e nessun valore valido potrebbe avere il bit 31 impostato, poiché corrisponderebbe al 32° giorno del mese). Un esempio potrebbe essere utile. Se vuoi sapere se un punto (nella posizione del pixel (x, y)) ha visto il sole alle 16:00 del 22 giugno:
In modo più formale: dati
dove |
imagery_quality |
La qualità delle immagini del risultato. |
FinancedPurchaseSavings
Costo e vantaggio dell'utilizzo di un prestito per acquistare una determinata configurazione di pannelli solari con un determinato consumo di elettricità.
Campi | |
---|---|
annual_loan_payment |
Pagamenti annuali del prestito. |
rebate_value |
Il valore di tutti gli sgravi fiscali (incluso il credito fiscale per gli investimenti federali (ITC)). |
loan_interest_rate |
Il tasso di interesse sui prestiti assunto in questo insieme di calcoli. |
savings |
La quantità di risparmio (o meno) nel periodo di tempo del ciclo di vita. |
FinancialAnalysis
Analisi dei costi e dei vantaggi dell'impianto solare ottimale per una determinata dimensione della bolletta elettrica.
Campi | |
---|---|
monthly_bill |
La bolletta elettrica mensile assunta da questa analisi. |
default_bill |
Indica se si tratta della dimensione della fattura selezionata come predefinita per la zona in cui si trova l'edificio. Per |
average_kwh_per_month |
La quantità di elettricità utilizzata dalla casa in un mese medio, in base all'importo della bolletta e alle tariffe dell'elettricità locali. |
financial_details |
Informazioni finanziarie che si applicano indipendentemente dal metodo di finanziamento utilizzato. |
leasing_savings |
Costo e vantaggio del leasing dei pannelli solari. |
cash_purchase_savings |
Costo e vantaggio dell'acquisto dei pannelli solari in contanti. |
financed_purchase_savings |
Costo e vantaggio dell'acquisto dei pannelli solari tramite il finanziamento dell'acquisto. |
panel_config_index |
Indice in |
FinancialDetails
Dettagli di un'analisi finanziaria. Alcuni di questi dettagli sono già archiviati a livelli superiori (ad es. il costo a carico dell'utente). Gli importi totali si riferiscono a un periodo di tempo definito dal campo panel_lifetime_years
in SolarPotential
. Nota: il costo di acquisto dei pannelli è indicato nel campo out_of_pocket_cost
in CashPurchaseSavings
.
Campi | |
---|---|
initial_ac_kwh_per_year |
La quantità di kWh CA che riteniamo che i pannelli solari genereranno nel primo anno. |
remaining_lifetime_utility_bill |
Bolletta della società di servizi pubblici per l'elettricità non prodotta dall'impianto solare, per l'intera durata dei pannelli. |
federal_incentive |
Importo disponibile degli incentivi federali; si applica se l'utente acquista (con o senza un prestito) i pannelli. |
state_incentive |
Importo di denaro disponibile dagli incentivi statali; si applica se l'utente acquista (con o senza un prestito) i pannelli. |
utility_incentive |
Importo disponibile dagli incentivi delle società di servizi pubblici; si applica se l'utente acquista (con o senza un prestito) i pannelli. |
lifetime_srec_total |
Importo che l'utente riceverà dai crediti per energia rinnovabile solare per tutta la durata del pannello; questo vale se l'utente acquista (con o senza un prestito) i pannelli. |
cost_of_electricity_without_solar |
Costo totale dell'elettricità che l'utente avrebbe pagato per l'intero periodo di utilizzo se non avesse installato un impianto solare. |
net_metering_allowed |
Indica se la misurazione del consumo netto è consentita. |
solar_percentage |
Percentuale (0-100) dell'energia dell'utente fornita dall'energia solare. Valido per il primo anno, ma approssimativamente corretto per gli anni futuri. |
percentage_exported_to_grid |
La percentuale (0-100) di produzione di energia elettrica solare che abbiamo ipotizzato essere stata esportata nella rete, in base al primo trimestre di produzione. Ciò influisce sui calcoli se la misurazione netta non è consentita. |
FindClosestBuildingInsightsRequest
Richiedi messaggio per Solar.FindClosestBuildingInsights
.
Campi | |
---|---|
location |
Obbligatorio. La longitudine e la latitudine da cui l'API cerca l'edificio noto più vicino. |
required_quality |
Facoltativo. Il livello di qualità minimo consentito nei risultati. Non verrà restituito alcun risultato con una qualità inferiore a questa. Se non lo specifichi, la ricerca è limitata solo alla qualità ALTA. |
GetDataLayersRequest
Richiedi messaggio per Solar.GetDataLayers
.
Campi | |
---|---|
location |
Obbligatorio. La longitudine e la latitudine del centro della regione per cui vuoi ottenere i dati. |
radius_meters |
Obbligatorio. Il raggio, in metri, che definisce la regione che circonda il punto centrale per cui devono essere restituiti i dati. Le limitazioni di questo valore sono:
|
view |
Facoltativo. Il sottoinsieme di dati da restituire. |
required_quality |
Facoltativo. Il livello di qualità minimo consentito nei risultati. Non verrà restituito alcun risultato con una qualità inferiore a questa. Se non lo specifichi, la ricerca è limitata solo alla qualità ALTA. |
pixel_size_meters |
Facoltativo. La scala minima, in metri per pixel, dei dati da restituire. Sono supportati i valori 0,1 (il valore predefinito, se questo campo non è impostato esplicitamente), 0,25, 0,5 e 1,0. I componenti delle immagini la cui risoluzione normale è inferiore a |
exact_quality_required |
Facoltativo. Se richiedere una qualità esatta delle immagini. Se impostato su false, il campo |
GetGeoTiffRequest
Richiedi messaggio per Solar.GetGeoTiff
.
Campi | |
---|---|
id |
Obbligatorio. L'ID della risorsa richiesta. |
ImageryQuality
La qualità delle immagini utilizzate per calcolare alcuni risultati dell'API.
Nota: indipendentemente dal livello di qualità delle immagini, le uscite DSM hanno sempre una risoluzione di 0,1 m/pixel, le uscite del flusso mensile hanno sempre una risoluzione di 0,5 m/pixel e le uscite dell'ombra oraria hanno sempre una risoluzione di 1 m/pixel.
Enum | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
La qualità non è nota. |
HIGH |
I dati solari sono ricavati da immagini aeree acquisite a bassa quota ed elaborate a 0,1 m/pixel. |
MEDIUM |
I dati solari derivano da immagini aeree avanzate acquisite ad alta quota ed elaborate a 0,25 m/pixel. |
LOW |
I dati solari sono ricavati da immagini satellitari migliorate elaborate a 0,25 m/pixel. |
BASE |
I dati solari sono ricavati da immagini satellitari migliorate elaborate a 0,25 m/pixel. |
LatLngBox
Un riquadro di delimitazione in coordinate lat/lng.
LeasingSavings
Costo e vantaggio del leasing di una determinata configurazione di pannelli solari con un determinato utilizzo di elettricità.
Campi | |
---|---|
leases_allowed |
Se i contratti di locazione sono consentiti in questa giurisdizione (non sono consentiti in alcuni stati). Se questo campo è falso, è probabile che i valori in questo messaggio debbano essere ignorati. |
leases_supported |
Indica se i leasing sono supportati in questa giurisdizione dal motore di calcolo finanziario. Se questo campo è falso, è probabile che i valori in questo messaggio debbano essere ignorati. Questo è indipendente da |
annual_leasing_cost |
Costo di leasing annuale stimato. |
savings |
La quantità di risparmio (o meno) nel periodo di tempo del ciclo di vita. |
RoofSegmentSizeAndSunshineStats
Informazioni sulle dimensioni e sui quantili di insolazione di un segmento di tetto.
Campi | |
---|---|
stats |
Dimensioni totali e quantili di irraggiamento solare per il segmento del tetto. |
center |
Un punto vicino al centro del tratto del tetto. |
bounding_box |
Il riquadro delimitatore del tratto del tetto. |
pitch_degrees |
Angolo del tratto del tetto rispetto al piano del suolo teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo. |
azimuth_degrees |
La direzione in cui punta il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piano" ( |
plane_height_at_center_meters |
L'altezza del piano del tratto del tetto, in metri sul livello del mare, nel punto designato da |
RoofSegmentSummary
Informazioni su un segmento del tetto dell'edificio, con un certo numero di pannelli posizionati sopra.
Campi | |
---|---|
panels_count |
Il numero totale di pannelli in questo segmento. |
yearly_energy_dc_kwh |
Quantità di energia solare catturata da questa parte del layout nel corso di un anno, in kWh CC, assumendo i pannelli descritti sopra. |
pitch_degrees |
Angolo del tratto del tetto rispetto al piano del suolo teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo. |
azimuth_degrees |
La direzione in cui punta il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piano" ( |
segment_index |
Indice in |
SavingsOverTime
Informazioni finanziarie condivise tra diversi metodi di finanziamento.
Campi | |
---|---|
savings_year1 |
Risparmio nel primo anno dopo l'installazione del pannello. |
savings_year20 |
Risparmi nei primi vent'anni dopo l'installazione dei pannelli. |
present_value_of_savings_year20 |
Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi cumulativi di 20 anni? |
savings_lifetime |
Risparmio nell'intero ciclo di vita del panel. |
present_value_of_savings_lifetime |
Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi cumulativi per tutta la vita? |
financially_viable |
Indica se questo scenario è finanziariamente sostenibile. Sarà falso per gli scenari con scarsa sostenibilità finanziaria (ad es. perdita di denaro). |
SizeAndSunshineStats
Quantili di dimensioni e insolazione di un tetto o di una parte di un tetto.
Campi | |
---|---|
area_meters2 |
L'area del tetto o del segmento del tetto, in m². Si tratta dell'area del tetto (tenendo conto dell'inclinazione), non dell'area del suolo. |
sunshine_quantiles[] |
Quantili dell'insolazione puntuale nell'area. Se sono presenti N valori, questi rappresentano le (N-1)-ile. Ad esempio, se sono presenti 5 valori, questi saranno i quartili (min, 25%, 50%, 75%, max). I valori sono in kWh/kW annuali, ad esempio |
ground_area_meters2 |
L'area al suolo coperta dal tetto o dal segmento di tetto, in m². |
SolarPanel
SolarPanel descrive la posizione, l'orientamento e la produzione di un singolo pannello solare. Consulta i campi panel_height_meters
, panel_width_meters
e panel_capacity_watts
in SolarPotential
per informazioni sui parametri del riquadro.
Campi | |
---|---|
center |
Il centro del riquadro. |
orientation |
L'orientamento del riquadro. |
yearly_energy_dc_kwh |
Quantità di energia solare catturata da questo layout nell'arco di un anno, in kWh CC. |
segment_index |
Indice in |
SolarPanelConfig
SolarPanelConfig descrive un determinato posizionamento dei pannelli solari sul tetto.
Campi | |
---|---|
panels_count |
Numero totale di pannelli. Tieni presente che questo è ridondante rispetto alla somma dei campi corrispondenti in |
yearly_energy_dc_kwh |
Quantità di energia solare catturata da questo layout nel corso di un anno, in kWh in corrente continua, supponendo i pannelli descritti sopra. |
roof_segment_summaries[] |
Informazioni sulla produzione di ogni segmento del tetto che supporta almeno un pannello in questo layout. |
SolarPanelOrientation
L'orientamento di un pannello solare. Questo valore deve essere interpretato in base all'azimut del tratto di tetto su cui è posizionato il pannello.
Enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
L'orientamento del pannello non è noto. |
LANDSCAPE |
Il lato lungo di un pannello LANDSCAPE è perpendicolare alla direzione di azimut del tratto di tetto su cui è posizionato. |
PORTRAIT |
Il lato lungo di un pannello PORTRAIT è parallelo alla direzione di azimut del tratto di tetto su cui è posizionato. |
SolarPotential
Informazioni sul potenziale solare di un edificio. Alcuni campi sono definiti in termini di "riquadri". I campi panel_capacity_watts
, panel_height_meters
e panel_width_meters
descrivono i parametri del modello di pannello utilizzato in questi calcoli.
Campi | |
---|---|
max_array_panels_count |
Dimensioni dell'array massimo, ovvero il numero massimo di pannelli che possono essere montati sul tetto. |
panel_capacity_watts |
Capacità, in watt, del pannello utilizzata nei calcoli. |
panel_height_meters |
Altezza, in metri in orientamento verticale, del pannello utilizzato nei calcoli. |
panel_width_meters |
Larghezza, in metri in orientamento verticale, del pannello utilizzato nei calcoli. |
panel_lifetime_years |
La durata prevista, in anni, dei pannelli solari. Questo valore viene utilizzato nei calcoli finanziari. |
max_array_area_meters2 |
Dimensioni, in metri quadrati, dell'array massimo. |
max_sunshine_hours_per_year |
Numero massimo di ore di sole ricevute all'anno in qualsiasi punto del tetto. Le ore di sole misurano la quantità totale di insolazione (energia) ricevuta in un anno. 1 ora di sole = 1 kWh per kW (dove kW si riferisce ai kW di capacità in condizioni di test standard). |
carbon_offset_factor_kg_per_mwh |
Quantità equivalente di CO2 prodotta per MWh di elettricità di rete. Si tratta di una misura dell'intensità di carbonio dell'elettricità di rete sostituita dall'elettricità solare. |
whole_roof_stats |
Dimensioni totali e quantili di irraggiamento solare per la parte del tetto assegnata a un determinato segmento. Nonostante il nome, l'intero edificio potrebbe non essere incluso. Leggi i |
building_stats |
Quantili di dimensioni e irraggiamento solare per l'intero edificio, incluse le parti del tetto che non sono state assegnate a un segmento del tetto. Poiché l'orientamento di queste parti non è ben definito, la stima dell'area del tetto non è affidabile, ma la stima dell'area al suolo è affidabile. È possibile ottenere una superficie del tetto dell'intero edificio più affidabile moltiplicando la superficie del tetto di |
roof_segment_stats[] |
Quantili di dimensioni e irraggiamento solare per ogni segmento del tetto. |
solar_panels[] |
Ogni |
solar_panel_configs[] |
Ogni |
financial_analyses[] |
Un |