- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Valore monetario
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Prova!
Individua l'edificio più vicino a un punto di query. Restituisce un errore con il codice NOT_FOUND
se non sono presenti edifici entro circa 50 metri dal punto di query.
Richiesta HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
location |
obbligatorio. La longitudine e la latitudine da cui l'API cerca l'edificio noto più vicino. |
requiredQuality |
Campo facoltativo. Il livello qualitativo minimo consentito nei risultati. Non verrà restituito nessun risultato con una qualità inferiore. Non specificarlo equivale a limitare solo alla qualità ALTA. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per Solar.FindClosestBuildingInsights
. Informazioni su posizione, dimensioni e potenziale solare di un edificio.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "name": string, "center": { object ( |
Campi | |
---|---|
name |
Il nome della risorsa per l'edificio nel formato |
center |
Un punto vicino al centro dell'edificio. |
boundingBox |
Il riquadro di delimitazione dell'edificio. |
imageryDate |
Data di acquisizione delle immagini sottostanti. Questo valore è approssimativo. |
imageryProcessedDate |
Al termine dell'elaborazione su questa immagine. |
postalCode |
Codice postale (ad es. codice postale degli Stati Uniti) in cui è circondato l'edificio. |
administrativeArea |
Area amministrativa 1 (ad es. negli Stati Uniti, lo stato) che contiene l'edificio. Ad esempio, negli Stati Uniti l'abbreviazione potrebbe essere "MA" o "CA". |
statisticalArea |
Area statistica (ad es. sezione di censimento degli Stati Uniti) in cui si trova questo edificio. |
regionCode |
Codice regione del paese (o della regione) in cui si trova l'edificio. |
solarPotential |
Potenziale solare dell'edificio. |
imageryQuality |
La qualità delle immagini utilizzate per calcolare i dati dell'edificio. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Un riquadro di delimitazione con coordinate lat/lng.
Rappresentazione JSON |
---|
{ "sw": { object ( |
Campi | |
---|---|
sw |
L'angolo sud-ovest della scatola. |
ne |
L'angolo nord-est della scatola. |
SolarPotential
Informazioni sul potenziale solare di un edificio. Alcuni campi in questo campo sono definiti in termini di "riquadri". I campi panelCapacityWatts
, panelHeightMeters
e panelWidthMeters
descrivono i parametri del modello di pannello utilizzato in questi calcoli.
Rappresentazione JSON |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
Campi | |
---|---|
maxArrayPanelsCount |
Dimensioni dell'array massimo, ovvero il numero massimo di pannelli che possono essere inseriti sul tetto. |
panelCapacityWatts |
Capacità, in watt, del pannello utilizzato nei calcoli. |
panelHeightMeters |
Altezza, in metri con orientamento verticale, del riquadro utilizzato nei calcoli. |
panelWidthMeters |
Larghezza, in metri con orientamento verticale, del riquadro utilizzato nei calcoli. |
panelLifetimeYears |
La durata prevista, in anni, dei pannelli solari. Viene utilizzato nei calcoli finanziari. |
maxArrayAreaMeters2 |
Dimensioni, in metri quadrati, dell'array massimo. |
maxSunshineHoursPerYear |
Numero massimo di ore di sole ricevute all'anno, da qualsiasi punto del tetto. Le ore di sole sono una misura della quantità totale di irradiazione (energia) ricevuta ogni anno. 1 ora di sole = 1 kWh per kW (dove per kW si intende kW di capacità in condizioni di test standard). |
carbonOffsetFactorKgPerMwh |
Quantità equivalente di CO2 prodotta per MWh di elettricità di rete. Si tratta di una misura dell'intensità di carbonio dell'elettricità di rete spostata dall'elettricità solare. |
wholeRoofStats |
Quantili totali e luce solare per la parte del tetto assegnata a un segmento del tetto. Nonostante il nome, potrebbe non includere l'intero edificio. Leggi i |
buildingStats |
Quantili relativi alle dimensioni e alla luce solare per l'intero edificio, incluse le parti del tetto non assegnate a un segmento di tetto. Poiché gli orientamenti di queste parti non sono ben definiti, la stima dell'area del tetto è inaffidabile, ma la stima della superficie del suolo è affidabile. Per ottenere un'area del tetto dell'intero edificio più affidabile, scala l'area del tetto da |
roofSegmentStats[] |
Quantili relativi alle dimensioni e alla luce solare per ogni segmento di tetto. |
solarPanels[] |
Ogni |
solarPanelConfigs[] |
Ogni elemento |
financialAnalyses[] |
Un |
SizeAndSunshineStats
Quantili di dimensioni e luce solare di un tetto o di una parte di un tetto.
Rappresentazione JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Campi | |
---|---|
areaMeters2 |
L'area del segmento del tetto o del tetto, in m^2. Si tratta dell'area del tetto (che tiene conto dell'inclinazione), non dell'area dell'impronta del suolo. |
sunshineQuantiles[] |
Quantili di sole a punti in tutta l'area. Se qui sono presenti valori N, rappresenta gli (N-1)-iles. Ad esempio, se sono presenti 5 valori, questi sarebbero i quartili (min, 25%, 50%, 75%, max). I valori sono in kWh/kW annuali, ad esempio |
groundAreaMeters2 |
L'area dell'impronta del suolo coperta dal segmento del tetto o del tetto, in m^2. |
RoofSegmentSizeAndSunshineStats
Informazioni sui quantili di dimensioni e luce solare di un segmento di tetto.
Rappresentazione JSON |
---|
{ "stats": { object ( |
Campi | |
---|---|
stats |
Dimensioni totali e quantili della luce solare per il segmento del tetto. |
center |
Un punto vicino al centro del segmento del tetto. |
boundingBox |
Il riquadro di delimitazione del segmento del tetto. |
pitchDegrees |
Angolo del segmento del tetto rispetto al piano di terra teorico. 0 = parallela al suolo, 90 = perpendicolare al suolo. |
azimuthDegrees |
Direzione della bussola in cui è rivolto il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piatto" ( |
planeHeightAtCenterMeters |
L'altezza del piano del segmento di tetto, in metri sul livello del mare, nel punto designato da |
SolarPanel
Solarpanel descrive la posizione, l'orientamento e la produzione di un singolo pannello solare. Consulta i campi panelHeightMeters
, panelWidthMeters
e panelCapacityWatts
in SolarPotential
per informazioni sui parametri del riquadro.
Rappresentazione JSON |
---|
{ "center": { object ( |
Campi | |
---|---|
center |
Il centro del riquadro. |
orientation |
L'orientamento del riquadro. |
yearlyEnergyDcKwh |
La quantità di energia solare acquisita da questo layout nel corso di un anno, in kWh CC. |
segmentIndex |
Indice in |
SolarPanelOrientation
L'orientamento di un pannello solare. Deve essere interpretato in relazione all'azimut del segmento del tetto su cui è posizionato il pannello.
Enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nessun orientamento del riquadro noto. |
LANDSCAPE |
Un riquadro LANDSCAPE ha il bordo lungo perpendicolare alla direzione di azimut del segmento del tetto su cui è posizionato. |
PORTRAIT |
Un riquadro PORTRAIT ha il bordo lungo parallelo alla direzione di azimut del segmento del tetto su cui è posizionato. |
SolarPanelConfig
SolarpanelConfig descrive una posizione particolare dei pannelli solari sul tetto.
Rappresentazione JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Campi | |
---|---|
panelsCount |
Numero totale di riquadri. Tieni presente che il valore è ridondante per la somma dei campi corrispondenti in |
yearlyEnergyDcKwh |
La quantità di energia solare acquisita da questo layout nel corso di un anno, in kWh CC, supponendo che i riquadri siano descritti sopra. |
roofSegmentSummaries[] |
Informazioni sulla produzione di ogni segmento di tetto che ospita almeno un pannello in questo layout. |
RoofSegmentSummary
Informazioni su un segmento del tetto dell'edificio, con alcuni riquadri posizionati sopra.
Rappresentazione JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Campi | |
---|---|
panelsCount |
Il numero totale di riquadri in questo segmento. |
yearlyEnergyDcKwh |
La quantità di energia solare che questa parte del layout acquisisce nel corso di un anno, in kWh CC, supponendo che i riquadri siano descritti sopra. |
pitchDegrees |
Angolo del segmento del tetto rispetto al piano di terra teorico. 0 = parallela al suolo, 90 = perpendicolare al suolo. |
azimuthDegrees |
Direzione della bussola in cui è rivolto il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piatto" ( |
segmentIndex |
Indice in |
FinancialAnalysis
Analisi dei costi e dei vantaggi del layout fotovoltaico ottimale per una specifica dimensione della bolletta elettrica.
Rappresentazione JSON |
---|
{ "monthlyBill": { object ( |
Campi | |
---|---|
monthlyBill |
La bolletta dell'elettricità mensile si suppone in questa analisi. |
defaultBill |
Indica se si tratta della dimensione del conto selezionata come fattura predefinita per l'area in cui si trova l'edificio. Esattamente un |
averageKwhPerMonth |
Il consumo di elettricità da parte della casa in un mese medio, in base all'importo della bolletta e alle tariffe locali dell'elettricità. |
financialDetails |
Informazioni finanziarie che si applicano indipendentemente dal metodo di finanziamento utilizzato. |
leasingSavings |
Costi e vantaggi del leasing dei pannelli solari. |
cashPurchaseSavings |
Costi e vantaggi dell'acquisto di pannelli solari in contanti. |
financedPurchaseSavings |
Costi e vantaggi dell'acquisto di pannelli solari tramite finanziamento dell'acquisto. |
panelConfigIndex |
Indice in |
Denaro
Rappresenta una quantità di denaro con il suo tipo di valuta.
Rappresentazione JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campi | |
---|---|
currencyCode |
Il codice valuta di tre lettere definito nello standard ISO 4217. |
units |
Le unità intere dell'importo. Ad esempio, se |
nanos |
Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se |
FinancialDetails
Dettagli di un'analisi finanziaria. Alcuni di questi dettagli sono già memorizzati a livelli superiori (ad es. a titolo esemplificativo). Gli importi totali si riferiscono a un periodo di tempo definito dal campo panelLifetimeYears
in SolarPotential
. Nota: il costo immediato dell'acquisto dei riquadri è indicato nel campo outOfPocketCost
in CashPurchaseSavings
.
Rappresentazione JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Campi | |
---|---|
initialAcKwhPerYear |
Quanti kWh CA prevediamo che i pannelli solari produrranno nel primo anno. |
remainingLifetimeUtilityBill |
Bolletta di un'utenza per l'elettricità non prodotta da energia solare, per la durata dei pannelli. |
federalIncentive |
Importo offerto dagli incentivi federali; si applica se l'utente acquista (con o senza prestito) i panel. |
stateIncentive |
Importo disponibile tramite incentivi statali; si applica se l'utente acquista (con o senza prestito) i riquadri. |
utilityIncentive |
Importo disponibile tramite incentivi per le utenze; si applica se l'utente acquista (con o senza prestito) i riquadri. |
lifetimeSrecTotal |
Importo che l'utente riceverà dai crediti per l'energia solare rinnovabili per la durata del pannello; si applica se l'utente acquista (con o senza un prestito) i pannelli. |
costOfElectricityWithoutSolar |
Costo totale dell'elettricità che l'utente avrebbe pagato nel corso del periodo di vita se non avesse installato l'energia solare. |
netMeteringAllowed |
Indica se la misurazione netta è consentita. |
solarPercentage |
Percentuale (0-100) di potenza dell'utente fornita dall'energia solare. Offerta valida per il primo anno, ma pressoché corretta per gli anni futuri. |
percentageExportedToGrid |
La percentuale (da 0 a 100) di produzione di elettricità solare che abbiamo ipotizzato è stata esportata nella rete, in base al primo trimestre di produzione. Questa opzione influisce sui calcoli se il conteggio netto non è consentito. |
LeasingSavings
Costi e vantaggi del leasing di una particolare configurazione di pannelli solari con un particolare utilizzo di elettricità.
Rappresentazione JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Campi | |
---|---|
leasesAllowed |
Indica se i leasing sono consentiti in questa giurisdizione (i leasing non sono consentiti in alcuni stati). Se questo campo è false, è probabile che i valori in questo messaggio vengano ignorati. |
leasesSupported |
Se in questa giurisdizione i leasing sono supportati dal motore di calcolo finanziario. Se questo campo è false, è probabile che i valori in questo messaggio vengano ignorati. Questo comportamento è indipendente da |
annualLeasingCost |
Costo annuale stimato di leasing. |
savings |
Quanto viene risparmiato (o meno) nel corso del ciclo di vita. |
SavingsOverTime
Informazioni finanziarie condivise tra diversi metodi di finanziamento.
Rappresentazione JSON |
---|
{ "savingsYear1": { object ( |
Campi | |
---|---|
savingsYear1 |
Risparmi nel primo anno dopo l'installazione dei pannelli. |
savingsYear20 |
Risparmi nei primi vent'anni dall'installazione dei pannelli. |
presentValueOfSavingsYear20 |
Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi cumulativi per un periodo di 20 anni? |
savingsLifetime |
Risparmi sull'intera durata del pannello. |
presentValueOfSavingsLifetime |
Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi totali cumulativi? |
financiallyViable |
Indica se questo scenario è finanziariamente fattibile. È falso per scenari con una scarsa sostenibilità finanziaria (ad es. perdita di denaro). |
CashPurchaseSavings
Costo e beneficio dell'acquisto definitivo di una particolare configurazione di pannelli solari con un particolare utilizzo di elettricità.
Rappresentazione JSON |
---|
{ "outOfPocketCost": { object ( |
Campi | |
---|---|
outOfPocketCost |
Costo iniziale al lordo degli incentivi fiscali: l'importo che deve essere pagato a pagamento. Al contrario, |
upfrontCost |
Costo iniziale al netto degli incentivi fiscali: importo che deve essere pagato durante il primo anno. Al contrario, |
rebateValue |
Il valore di tutti i rimborsi fiscali. |
savings |
Quanto viene risparmiato (o meno) nel corso del ciclo di vita. |
paybackYears |
Numero di anni prima del recupero dell'investimento. Un valore negativo indica che il recupero non si verifica mai nel corso del lifetime. |
FinancedPurchaseSavings
Costo e vantaggio dell'utilizzo di un prestito per l'acquisto di una determinata configurazione di pannelli solari con un particolare consumo di elettricità.
Rappresentazione JSON |
---|
{ "annualLoanPayment": { object ( |
Campi | |
---|---|
annualLoanPayment |
Pagamenti di prestiti annuali. |
rebateValue |
Il valore di tutti i rimborsi fiscali (incluso il credito d'imposta federale sugli investimenti (ITC)). |
loanInterestRate |
Il tasso di interesse sui prestiti assunti in questa serie di calcoli. |
savings |
Quanto viene risparmiato (o meno) nel corso del ciclo di vita. |