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 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

object (LatLng)

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

requiredQuality

enum (ImageryQuality)

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 (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 su questa immagine.

postalCode

string

Codice postale (ad es. codice postale degli Stati Uniti) in cui è circondato l'edificio.

administrativeArea

string

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

string

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

regionCode

string

Codice regione del paese (o della regione) in cui si trova l'edificio.

solarPotential

object (SolarPotential)

Potenziale solare dell'edificio.

imageryQuality

enum (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 (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Campi
sw

object (LatLng)

L'angolo sud-ovest della scatola.

ne

object (LatLng)

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 (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
Campi
maxArrayPanelsCount

integer

Dimensioni dell'array massimo, 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 con orientamento verticale, del riquadro utilizzato nei calcoli.

panelWidthMeters

number

Larghezza, in metri con orientamento verticale, del riquadro utilizzato nei calcoli.

panelLifetimeYears

integer

La durata prevista, in anni, dei pannelli solari. 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, 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

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 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.

buildingStats

object (SizeAndSunshineStats)

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 wholeRoofStats del rapporto tra le aree del suolo di buildingStats e wholeRoofStats.

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Quantili relativi alle dimensioni e alla luce solare per ogni segmento di tetto.

solarPanels[]

object (SolarPanel)

Ogni SolarPanel descrive un singolo pannello solare. Questi elementi sono elencati nell'ordine in cui l'algoritmo di layout dei riquadri lo ha inserito. Solitamente, ma non sempre, questo avviene in ordine decrescente di produzione annuale di energia.

solarPanelConfigs[]

object (SolarPanelConfig)

Ogni elemento SolarPanelConfig descrive una diversa disposizione dei pannelli solari sul tetto. Il numero di riquadri è crescente. SolarPanelConfig con panelsCount=N si basa sui primi N riquadri nell'elenco solarPanels. Questo campo viene compilato solo se su un tetto possono essere inseriti almeno quattro pannelli.

financialAnalyses[]

object (FinancialAnalysis)

Un FinancialAnalysis indica i risparmi derivanti dall'energia solare supponendo una fattura mensile specifica e un determinato fornitore di energia elettrica. l'importo delle fatture mensili è in ordine crescente. Questo campo sarà vuoto per gli edifici in aree per i quali l'API Solar non dispone di informazioni sufficienti per eseguire i calcoli finanziari.

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

number

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[]

number

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 maxSunshineHoursPerYear.

groundAreaMeters2

number

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 (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Campi
stats

object (SizeAndSunshineStats)

Dimensioni totali e quantili della luce solare per il segmento del 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 del tetto rispetto al piano di terra teorico. 0 = parallela al suolo, 90 = perpendicolare al suolo.

azimuthDegrees

number

Direzione della bussola in cui è rivolto il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piatto" (pitchDegrees molto vicino allo 0), l'azimut non è ben definito, quindi per coerenza, lo definiamo arbitrariamente come 0 (Nord).

planeHeightAtCenterMeters

number

L'altezza del piano del segmento di tetto, in metri sul livello del mare, nel punto designato da center. Insieme all'inclinazione, all'azimut e alla posizione centrale, definisce completamente il piano del segmento del tetto.

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 (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Campi
center

object (LatLng)

Il centro del riquadro.

orientation

enum (SolarPanelOrientation)

L'orientamento del riquadro.

yearlyEnergyDcKwh

number

La quantità di energia solare acquisita da questo layout 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. 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 (RoofSegmentSummary)
    }
  ]
}
Campi
panelsCount

integer

Numero totale di riquadri. Tieni presente che il valore è ridondante per la somma dei campi corrispondenti in roofSegmentSummaries.

yearlyEnergyDcKwh

number

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[]

object (RoofSegmentSummary)

Informazioni sulla produzione di ogni segmento di tetto che ospita almeno un pannello in questo layout. roofSegmentSummaries[i] descrive il segmento "i-th" del tetto, incluse dimensioni, produzione prevista e orientamento.

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

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, supponendo che i riquadri siano descritti sopra.

pitchDegrees

number

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

azimuthDegrees

number

Direzione della bussola in cui è rivolto il segmento del tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piatto" (pitchDegrees molto vicino allo 0), l'azimut non è ben definito, quindi per coerenza, lo definiamo arbitrariamente come 0 (Nord).

segmentIndex

integer

Indice in roofSegmentStats del valore RoofSegmentSizeAndSunshineStats corrispondente.

FinancialAnalysis

Analisi dei costi e dei vantaggi del layout fotovoltaico ottimale per una specifica 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 dell'elettricità mensile si suppone in questa analisi.

defaultBill

boolean

Indica se si tratta della dimensione del conto selezionata come fattura predefinita per l'area in cui si trova l'edificio. Esattamente un FinancialAnalysis in BuildingSolarPotential deve avere defaultBill impostato.

averageKwhPerMonth

number

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

object (FinancialDetails)

Informazioni finanziarie che si applicano indipendentemente dal metodo di finanziamento utilizzato.

leasingSavings

object (LeasingSavings)

Costi e vantaggi del leasing dei pannelli solari.

cashPurchaseSavings

object (CashPurchaseSavings)

Costi e vantaggi dell'acquisto di pannelli solari in contanti.

financedPurchaseSavings

object (FinancedPurchaseSavings)

Costi e vantaggi dell'acquisto di pannelli solari tramite finanziamento dell'acquisto.

panelConfigIndex

integer

Indice in solarPanelConfigs del layout fotovoltaico ottimale per questa dimensione della fattura. Può essere -1 che indica che non è presente alcun layout. In questo caso, i restanti messaggi secondari verranno omessi.

Denaro

Rappresenta una quantità di denaro con il suo tipo di valuta.

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

string

Il codice valuta di tre lettere definito nello standard ISO 4217.

units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità corrisponde 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 un numero positivo o zero. Se units è zero, nanos può essere un numero positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o pari a 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 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 (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 prevediamo che i pannelli solari produrranno nel primo anno.

remainingLifetimeUtilityBill

object (Money)

Bolletta di un'utenza per l'elettricità non prodotta da energia solare, per la durata dei pannelli.

federalIncentive

object (Money)

Importo offerto dagli incentivi federali; si applica se l'utente acquista (con o senza prestito) i panel.

stateIncentive

object (Money)

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

utilityIncentive

object (Money)

Importo disponibile tramite incentivi per le utenze; si applica se l'utente acquista (con o senza prestito) i riquadri.

lifetimeSrecTotal

object (Money)

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

object (Money)

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 netta è consentita.

solarPercentage

number

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

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. 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 (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Campi
leasesAllowed

boolean

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

boolean

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 leasesAllowed: in alcune aree i leasing sono consentiti, ma in condizioni che non sono gestite dai modelli finanziari.

annualLeasingCost

object (Money)

Costo annuale stimato di leasing.

savings

object (SavingsOverTime)

Quanto viene risparmiato (o meno) nel corso del ciclo di vita.

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 vent'anni dall'installazione dei pannelli.

presentValueOfSavingsYear20

object (Money)

Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi cumulativi per un periodo di 20 anni?

savingsLifetime

object (Money)

Risparmi sull'intera durata del pannello.

presentValueOfSavingsLifetime

object (Money)

Utilizzando il tasso di sconto presunto, qual è il valore attuale dei risparmi totali cumulativi?

financiallyViable

boolean

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 (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Campi
outOfPocketCost

object (Money)

Costo iniziale al lordo degli incentivi fiscali: l'importo che deve essere pagato a pagamento. Al contrario, upfrontCost, al netto degli incentivi fiscali.

upfrontCost

object (Money)

Costo iniziale al netto degli incentivi fiscali: importo che deve essere pagato durante il primo anno. Al contrario, outOfPocketCost, al netto degli incentivi fiscali.

rebateValue

object (Money)

Il valore di tutti i rimborsi fiscali.

savings

object (SavingsOverTime)

Quanto viene risparmiato (o meno) nel corso del ciclo di vita.

paybackYears

number

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 (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Campi
annualLoanPayment

object (Money)

Pagamenti di prestiti annuali.

rebateValue

object (Money)

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

loanInterestRate

number

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

savings

object (SavingsOverTime)

Quanto viene risparmiato (o meno) nel corso del ciclo di vita.