Method: buildingInsights.findClosest

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 m dal punto della query.

Richiesta HTTP

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
location

object (LatLng)

Obbligatorio. La longitudine e la latitudine da cui l'API cerca l'edificio noto più vicino.

requiredQuality

enum (ImageryQuality)

(Facoltativo) Il livello qualitativo minimo consentito nei risultati. Non verrà restituito nessun risultato di qualità inferiore a questa. Non specificare questo valore equivale a limitarlo solo all'ALTA qualità.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per Solar.FindClosestBuildingInsights. Informazioni sulla posizione, sulle dimensioni e sul 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 (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
Campi
name

string

Il nome della risorsa per l'edificio, nel formato building/<place ID>.

center

object (LatLng)

Un punto vicino al centro dell'edificio.

boundingBox

object (LatLngBox)

Il riquadro di delimitazione dell'edificio.

imageryDate

object (Date)

Data di acquisizione delle immagini sottostanti. Questo valore è approssimativo.

imageryProcessedDate

object (Date)

Al termine dell'elaborazione di queste immagini.

postalCode

string

Codice postale (ad es. codice postale USA) in cui è contenuto questo edificio.

administrativeArea

string

Area amministrativa 1 (ad es. negli Stati Uniti o nello stato) in cui si trova l'edificio. Ad esempio, negli Stati Uniti, l'abbreviazione potrebbe essere "MA". o "CA".

statisticalArea

string

Area statistica (ad es. sezione di censimento degli Stati Uniti) in cui si trova questo edificio.

regionCode

string

Codice regione del paese (o regione) in cui si trova questo edificio.

solarPotential

object (SolarPotential)

Potenziale solare dell'edificio.

imageryQuality

enum (ImageryQuality)

La qualità delle immagini utilizzate per calcolare i dati relativi all'edificio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

LatLngBox

Un riquadro di delimitazione nelle coordinate di latitudine/longitudine.

Rappresentazione JSON
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Campi
sw

object (LatLng)

Nell'angolo a sud-ovest della casella.

ne

object (LatLng)

L'angolo nord-est della casella.

SolarPotential

Informazioni sul potenziale solare di un edificio. Alcuni campi sono definiti in termini di "riquadri". I campi panelCapacityWatts, panelHeightMeters e panelWidthMeters descrivono i parametri del modello del 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 (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
Campi
maxArrayPanelsCount

integer

Le dimensioni della matrice massima, ovvero il numero massimo di pannelli che possono essere inseriti sul tetto.

panelCapacityWatts

number

Capacità, in watt, del pannello utilizzato nei calcoli.

panelHeightMeters

number

Altezza, in metri in orientamento verticale, del riquadro utilizzato nei calcoli.

panelWidthMeters

number

Larghezza, in metri in orientamento verticale, del riquadro utilizzato per i calcoli.

panelLifetimeYears

integer

La durata prevista, in anni, dei pannelli solari. che viene utilizzato nei calcoli finanziari.

maxArrayAreaMeters2

number

Dimensioni, in metri quadrati, dell'array massimo.

maxSunshineHoursPerYear

number

Numero massimo di ore di sole ricevute all'anno, per qualsiasi punto del tetto. Le ore di sole sono una misura della quantità totale di energia solare ricevuta ogni anno. 1 ora di luce solare = 1 kWh per kW (dove kW si riferiscono a kW di capacità secondo le Condizioni di test standard).

carbonOffsetFactorKgPerMwh

number

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

object (SizeAndSunshineStats)

Quantili totali e quantità di luce solare per la parte del tetto assegnata a un segmento di tetto. Nonostante il nome, potrebbe non includere l'intero edificio. Leggi i buildingStats.

buildingStats

object (SizeAndSunshineStats)

Quantili di dimensioni e luce solare per l'intero edificio, comprese le parti del tetto che non erano state assegnate a una parte. Poiché gli orientamenti di queste parti non sono ben caratterizzati, la stima dell'area del tetto non è affidabile, mentre la stima dell'area del suolo è affidabile. È possibile che si possa ottenere un'area più affidabile del tetto dell'intero edificio scalando l'area del tetto da wholeRoofStats in base al rapporto tra le aree del terreno di buildingStats e wholeRoofStats.

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Quantili di dimensioni e luce solare per ciascun segmento di tetto.

solarPanels[]

object (SolarPanel)

Ogni SolarPanel descrive un singolo pannello solare. Sono elencati nell'ordine in cui sono stati inseriti dall'algoritmo di layout dei riquadri. Generalmente, ma non sempre, questo valore è in ordine decrescente di produzione annuale di energia.

solarPanelConfigs[]

object (SolarPanelConfig)

Ogni SolarPanelConfig descrive una diversa disposizione dei pannelli solari sul tetto. I riquadri sono elencati in ordine crescente. SolarPanelConfig con panelsCount=N si basa sui primi N riquadri nell'elenco solarPanels. Questo campo viene compilato solo se almeno 4 riquadri possono rientrare in un tetto.

financialAnalyses[]

object (FinancialAnalysis)

Un FinancialAnalysis consente di risparmiare grazie all'uso dell'energia solare presupponendo una determinata fattura mensile e un determinato fornitore di energia elettrica. Questi importi sono in ordine crescente per l'importo mensile delle fatture. Questo campo sarà vuoto per gli edifici in aree in cui l'API Solar non dispone di informazioni sufficienti per eseguire calcoli finanziari.

SizeAndSunshineStats

Quantili di dimensioni e quantità di luce solare di un tetto o di una parte di un tetto.

Rappresentazione JSON
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Campi
areaMeters2

number

L'area del tetto o del segmento del tetto, in m^2. Si tratta dell'area del tetto (che tiene conto dell'inclinazione), non dell'area del suolo.

sunshineQuantiles[]

number

Quantili dell'esposizione solare puntuale nell'area. Se in questo campo sono presenti N valori, rappresentano gli (N-1)-iles. Ad esempio, se ci sono 5 valori, si tratta dei quartili (min, 25%, 50%, 75%, max). I valori sono in kWh/kW annuali, come maxSunshineHoursPerYear.

groundAreaMeters2

number

L'area della superficie del suolo coperta dal tetto o dal segmento del tetto, in m^2.

RoofSegmentSizeAndSunshineStats

Informazioni sui quantili delle dimensioni e dell'esposizione al sole di un segmento di tetto.

Rappresentazione JSON
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Campi
stats

object (SizeAndSunshineStats)

Quantili totali e quantità di luce solare per il segmento di tetto.

center

object (LatLng)

Un punto vicino al centro del segmento del tetto.

boundingBox

object (LatLngBox)

Il riquadro di delimitazione del segmento del tetto.

pitchDegrees

number

Angolo del segmento di tetto rispetto al piano di terra teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo.

azimuthDegrees

number

Direzione della bussola verso cui punta il segmento di tetto. 0 = nord, 90 = est, 180 = sud. Per un "flat" segmento del tetto (pitchDegrees molto vicino a 0), l'azimut non è ben definito, quindi per coerenza lo definiamo arbitrariamente essere 0 (nord).

planeHeightAtCenterMeters

number

L'altezza del piano del segmento di tetto, in metri sul livello del mare, nel punto indicato da center. Insieme alla posizione mediana, azimut e beccheggio, definisce in modo completo il piano del segmento del tetto.

SolarPanel

Solarpanel descrive la posizione, l'orientamento e la produzione di un singolo pannello solare. Vedi i campi panelHeightMeters, panelWidthMeters e panelCapacityWatts in SolarPotential per informazioni sui parametri del riquadro.

Rappresentazione JSON
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Campi
center

object (LatLng)

Al centro del riquadro.

orientation

enum (SolarPanelOrientation)

L'orientamento del riquadro.

yearlyEnergyDcKwh

number

La quantità di energia solare che questo layout acquisisce nel corso di un anno, in kWh CC.

segmentIndex

integer

Indice in roofSegmentStats di RoofSegmentSizeAndSunshineStats che corrisponde al segmento del tetto su cui è posizionato questo riquadro.

SolarPanelOrientation

L'orientamento di un pannello solare. Questo valore deve essere interpretato in relazione all'azimut del segmento del tetto su cui è posizionato il riquadro.

Enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Non è noto l'orientamento del riquadro.
LANDSCAPE Un riquadro LANDSCAPE ha il bordo lungo perpendicolare alla direzione dell'azimut del segmento del tetto su cui è posizionato.
PORTRAIT Un riquadro PORTRAIT ha il bordo lungo parallelo alla direzione dell'azimut del segmento del tetto su cui è posizionato.

SolarPanelConfig

SolarpanelConfig descrive un posizionamento particolare dei pannelli solari sul tetto.

Rappresentazione JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Campi
panelsCount

integer

Numero totale di riquadri. Tieni presente che ciò è ridondante (la somma) dei campi corrispondenti in roofSegmentSummaries.

yearlyEnergyDcKwh

number

La quantità di energia solare che questo layout acquisisce nel corso di un anno, in kWh CC, supponendo che i pannelli descritti sopra.

roofSegmentSummaries[]

object (RoofSegmentSummary)

Informazioni sulla produzione di ogni segmento di tetto che include almeno un pannello in questo layout. roofSegmentSummaries[i] descrive l'i-esimo segmento del tetto, incluse le dimensioni, la produzione e l'orientamento previsti.

RoofSegmentSummary

Informazioni su un segmento di tetto dell'edificio, su cui sono posizionati alcuni pannelli.

Rappresentazione JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Campi
panelsCount

integer

Il numero totale di riquadri in questo segmento.

yearlyEnergyDcKwh

number

La quantità di energia solare che questa parte del layout acquisisce nel corso di un anno, in kWh CC, assumendo i pannelli descritti sopra.

pitchDegrees

number

Angolo del segmento di tetto rispetto al piano di terra teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo.

azimuthDegrees

number

Direzione della bussola verso cui punta il segmento di tetto. 0 = nord, 90 = est, 180 = sud. Per un "flat" segmento del tetto (pitchDegrees molto vicino a 0), l'azimut non è ben definito, quindi per coerenza lo definiamo arbitrariamente essere 0 (nord).

segmentIndex

integer

Indice in roofSegmentStats delle RoofSegmentSizeAndSunshineStats corrispondenti.

FinancialAnalysis

Analisi dei costi e dei vantaggi del layout ottimale dell'energia solare per una determinata dimensione della bolletta elettrica.

Rappresentazione JSON
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
Campi
monthlyBill

object (Money)

La bolletta mensile dell'elettricità parte da questa analisi.

defaultBill

boolean

Indica se queste sono le dimensioni della fattura selezionate come predefinite per l'area in cui si trova l'edificio. Esattamente un FinancialAnalysis in BuildingSolarPotential dovrebbe avere defaultBill impostato.

averageKwhPerMonth

number

Quanta elettricità consumata dalla casa in un mese medio, in base alle dimensioni della bolletta e alle tariffe dell'elettricità locale.

financialDetails

object (FinancialDetails)

Informazioni finanziarie valide indipendentemente dal metodo di finanziamento utilizzato.

leasingSavings

object (LeasingSavings)

Costi e benefici del leasing dei pannelli solari.

cashPurchaseSavings

object (CashPurchaseSavings)

Costi e benefici derivanti dall'acquisto di pannelli solari in contanti.

financedPurchaseSavings

object (FinancedPurchaseSavings)

Costi e vantaggi legati all'acquisto dei pannelli solari tramite finanziamento dell'acquisto.

panelConfigIndex

integer

Indice in solarPanelConfigs del layout solare ottimale per questo importo della bolletta. Il valore -1 indica che non è presente alcun layout. In questo caso, i messaggi secondari rimanenti verranno omessi.

Denaro

Rappresenta un importo di denaro con il tipo di valuta.

Rappresentazione JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campi
currencyCode

string

Il codice valuta di tre lettere definito in ISO 4217.

units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità equivale a un dollaro statunitense.

nanos

integer

Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 (inclusi). Se units è positivo, nanos deve essere positivo o zero. Se units è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o zero. Ad esempio -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

FinancialDetails

Dettagli di un'analisi finanziaria. Alcuni di questi dettagli sono già memorizzati a livelli più alti (ad es., costi tascabili). Gli importi totali si riferiscono a un periodo complessivo definito dal campo panelLifetimeYears in SolarPotential. Nota: il costo reperibile dell'acquisto dei pannelli è indicato nel campo outOfPocketCost in CashPurchaseSavings.

Rappresentazione JSON
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
Campi
initialAcKwhPerYear

number

Quanti kWh CA generiamo i pannelli solari nel loro primo anno.

remainingLifetimeUtilityBill

object (Money)

Bolletta per l'elettricità non prodotta dall'energia solare per tutta la durata dei pannelli.

federalIncentive

object (Money)

importo disponibile tramite incentivi federali; Ciò si applica se l'utente acquista (con o senza un prestito) i riquadri.

stateIncentive

object (Money)

importo disponibile tramite incentivi statali; Ciò si applica se l'utente acquista (con o senza un prestito) i riquadri.

utilityIncentive

object (Money)

importo disponibile tramite gli incentivi delle società di servizi pubblici; Ciò si applica se l'utente acquista (con o senza un prestito) i riquadri.

lifetimeSrecTotal

object (Money)

L'importo che l'utente riceverà dai crediti per l'energia rinnovabile solare nel corso della durata del pannello; Ciò si applica se l'utente acquista (con o senza un prestito) i riquadri.

costOfElectricityWithoutSolar

object (Money)

Il costo totale dell'elettricità che l'utente avrebbe pagato nel corso del periodo di vita se non avesse installato l'energia solare.

netMeteringAllowed

boolean

Indica se la misurazione della rete è consentita.

solarPercentage

number

Percentuale (0-100) dell'energia fornita dall'utente tramite solare. Offerta valida per il primo anno, ma corretta per gli anni futuri.

percentageExportedToGrid

number

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. Ciò influisce sui calcoli se la misurazione della rete non è consentita.

LeasingSavings

Costi e benefici del leasing di una particolare configurazione di pannelli solari con un determinato consumo di elettricità

Rappresentazione JSON
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Campi
leasesAllowed

boolean

Indica se i leasing sono consentiti in questa giurisdizione (non sono consentiti in alcuni stati). Se questo campo è false, probabilmente i valori in questo messaggio dovrebbero essere ignorati.

leasesSupported

boolean

Indica se i leasing sono supportati in questa giurisdizione dal motore di calcolo finanziario. Se questo campo è false, probabilmente i valori in questo messaggio dovrebbero essere ignorati. Ciò è indipendente da leasesAllowed: in alcune aree i leasing sono consentiti, ma in condizioni non gestite dai modelli finanziari.

annualLeasingCost

object (Money)

Costo di leasing annuale stimato.

savings

object (SavingsOverTime)

L'importo risparmiato (o meno) nel corso della durata.

SavingsOverTime

Informazioni finanziarie condivise tra diversi metodi di finanziamento.

Rappresentazione JSON
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Campi
savingsYear1

object (Money)

Risparmi nel primo anno dopo l'installazione dei pannelli.

savingsYear20

object (Money)

Risparmi nei primi venti anni dopo l'installazione dei pannelli.

presentValueOfSavingsYear20

object (Money)

Utilizzando il tasso di sconto presunto, qual è il valore attuale del risparmio cumulativo di 20 anni?

savingsLifetime

object (Money)

Risparmi per l'intera durata del riquadro.

presentValueOfSavingsLifetime

object (Money)

Utilizzando il tasso di sconto presunto, qual è il valore attuale del risparmio complessivo complessivo?

financiallyViable

boolean

Indica se questo scenario è finanziariamente fattibile. È falso per scenari con scarsa redditività finanziaria (ad es. perdita di denaro).

CashPurchaseSavings

Costi e benefici derivanti dall'acquisto totale di una particolare configurazione di pannelli solari con un determinato consumo di elettricità

Rappresentazione JSON
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Campi
outOfPocketCost

object (Money)

Costo iniziale al netto degli incentivi fiscali: l'importo che deve essere pagato a carico. Contrasta con upfrontCost, che è al netto degli incentivi fiscali.

upfrontCost

object (Money)

Costo iniziale al netto degli incentivi fiscali: è l'importo che deve essere pagato durante il primo anno. Contrasta con outOfPocketCost, che al netto degli incentivi fiscali.

rebateValue

object (Money)

Il valore di tutti i rimborsi fiscali.

savings

object (SavingsOverTime)

L'importo risparmiato (o meno) nel corso della durata.

paybackYears

number

Numero di anni prima del recupero dell'investimento. Un valore negativo indica che il recupero non si verifica mai nel periodo in cui si è verificato il lifetime dell'utente.

FinancedPurchaseSavings

Costi e benefici derivanti dall'utilizzo di un prestito per l'acquisto di una particolare configurazione di pannelli solari con un determinato consumo di elettricità

Rappresentazione JSON
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Campi
annualLoanPayment

object (Money)

Pagamenti annuali del prestito.

rebateValue

object (Money)

Il valore di tutti i rimborsi fiscali (incluso il credito d'imposta federale sugli investimenti).

loanInterestRate

number

Il tasso di interesse sui prestiti assunto in questa serie di calcoli.

savings

object (SavingsOverTime)

L'importo risparmiato (o meno) nel corso della durata.