- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Denaro
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Fai una prova!
Individua l'edificio il cui baricentro è più vicino a un punto di query. Restituisce un errore con 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 |
Obbligatorio. La longitudine e la latitudine da cui l'API cerca l'edificio conosciuto più vicino. |
requiredQuality |
Facoltativo. Il livello di qualità minimo consentito nei risultati. Non verrà restituito alcun risultato con una qualità inferiore a questa. Se non viene specificato, equivale a limitare la qualità solo ad ALTA. |
exactQualityRequired |
Facoltativo. Indica se richiedere la qualità esatta delle immagini. Se impostato su false, il campo |
experiments[] |
Facoltativo. Specifica gli esperimenti pre-GA da attivare. Le richieste che utilizzano questo campo sono classificate come offerta pre-GA ai sensi dei Termini di servizio specifici di Google Maps Platform. Per ulteriori dettagli, consulta le descrizioni della fase di lancio. |
additionalInsights[] |
Facoltativo. Un elenco di |
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 ( |
| 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 è un valore approssimativo. |
imageryProcessedDate |
Quando è stata completata l'elaborazione di queste immagini. |
postalCode |
Codice postale (ad es. codice postale degli Stati Uniti) in cui si trova l'edificio. |
administrativeArea |
Area amministrativa 1 (ad es. lo stato negli Stati Uniti) che contiene questo 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 l'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 di questo edificio. |
detectedArrays |
Array solari rilevati sull'edificio. Questo campo viene compilato solo se DETECTED_ARRAYS è incluso nel |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Informazioni aggiuntive sull'edificio, come la geometria del tetto e gli array di pannelli solari, che possono essere restituite in BuildingInsights.
| Enum | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Il valore predefinito. Verrà restituito il valore BuildingInsights predefinito. |
DETECTED_ARRAYS |
Determina se la risposta includerà gli array rilevati. Se specificato, il campo |
LatLngBox
Un riquadro di delimitazione in coordinate di latitudine/longitudine.
| Rappresentazione JSON |
|---|
{ "sw": { object ( |
| Campi | |
|---|---|
sw |
L'angolo sud-ovest della casella. |
ne |
L'angolo nord-est della casella. |
SolarPotential
Informazioni sul potenziale solare di un edificio. Alcuni campi di questo file sono definiti in termini di "pannelli". 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 installati sul tetto. |
panelCapacityWatts |
Capacità, in watt, del pannello utilizzato nei calcoli. |
panelHeightMeters |
Altezza, in metri con orientamento verticale, del pannello utilizzato nei calcoli. |
panelWidthMeters |
Larghezza, in metri con orientamento verticale, del pannello utilizzato nei calcoli. |
panelLifetimeYears |
La durata prevista, in anni, dei pannelli solari. Questo valore 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 insolazione (energia) ricevuta all'anno. 1 ora di sole = 1 kWh per kW (dove kW si riferisce ai kW di capacità in condizioni di test standard). |
carbonOffsetFactorKgPerMwh |
Quantità equivalente di CO2 prodotta per MWh di elettricità della rete. Si tratta di una misura dell'intensità di carbonio dell'elettricità della rete sostituita dall'elettricità solare. |
wholeRoofStats |
Dimensioni totali e quantili di 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 di dimensioni e luce solare per l'intero edificio, incluse le parti del tetto non assegnate ad alcun segmento del tetto. Poiché gli orientamenti di queste parti non sono ben caratterizzati, la stima dell'area del tetto non è affidabile, ma la stima dell'area del terreno è affidabile. È possibile che si possa ottenere un'area del tetto dell'intero edificio più affidabile scalando l'area del tetto da |
roofSegmentStats[] |
Quantili di dimensioni e luce solare per ogni segmento del tetto. |
solarPanels[] |
Ogni |
solarPanelConfigs[] |
Ogni |
financialAnalyses[] |
Un |
SizeAndSunshineStats
Quantili di dimensioni e soleggiamento di un tetto o di una parte di un tetto.
| Rappresentazione JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Campi | |
|---|---|
areaMeters2 |
L'area del tetto o della porzione di tetto, in m^2. Si tratta dell'area del tetto (tenendo conto dell'inclinazione), non dell'area dell'impronta al suolo. |
sunshineQuantiles[] |
Quantili dell'irraggiamento solare puntuale nell'area. Se sono presenti N valori, questi rappresentano gli (N-1)-ili. Ad esempio, se sono presenti 5 valori, questi saranno i quartili (min, 25%, 50%, 75%, max). I valori sono espressi in kWh/kW annui, ad esempio |
groundAreaMeters2 |
L'area della superficie del terreno coperta dal tetto o dal segmento del tetto, in m^2. |
RoofSegmentSizeAndSunshineStats
Informazioni sulle dimensioni e sui quantili di soleggiamento di un segmento del tetto.
| Rappresentazione JSON |
|---|
{ "stats": { object ( |
| Campi | |
|---|---|
stats |
Dimensioni totali e quantili di 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 del terreno teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo. |
azimuthDegrees |
Direzione della bussola verso cui è rivolta la porzione di tetto. 0 = Nord, 90 = Est, 180 = Sud. Per un segmento di tetto "piatto" ( |
planeHeightAtCenterMeters |
L'altezza del piano della falda del tetto, in metri sul livello del mare, nel punto indicato da |
SolarPanel
SolarPanel descrive la posizione, l'orientamento e la produzione di un singolo pannello solare. Per informazioni sui parametri del pannello, consulta i campi panelHeightMeters, panelWidthMeters e panelCapacityWatts in SolarPotential.
| Rappresentazione JSON |
|---|
{ "center": { object ( |
| Campi | |
|---|---|
center |
Il centro del pannello. |
orientation |
L'orientamento del pannello. |
yearlyEnergyDcKwh |
La quantità di energia solare catturata da questo layout nel corso di un anno, in kWh CC. |
segmentIndex |
Indice in |
SolarPanelOrientation
L'orientamento di un pannello solare. Questo valore deve essere interpretato in relazione all'azimut del segmento del tetto su cui è posizionato il pannello.
| Enum | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nessun orientamento dei pannelli è noto. |
LANDSCAPE |
Un pannello LANDSCAPE ha il bordo lungo perpendicolare alla direzione dell'azimut della falda del tetto su cui è posizionato. |
PORTRAIT |
Un pannello PORTRAIT ha il lato lungo parallelo alla direzione dell'azimut della falda del tetto su cui è posizionato. |
SolarPanelConfig
SolarPanelConfig descrive un posizionamento specifico dei pannelli solari sul tetto.
| Rappresentazione JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Campi | |
|---|---|
panelsCount |
Numero totale di pannelli. Tieni presente che questo è ridondante rispetto alla 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 pannelli siano quelli descritti sopra. |
roofSegmentSummaries[] |
Informazioni sulla produzione di ogni segmento del tetto che contiene almeno un pannello in questo layout. |
RoofSegmentSummary
Informazioni su un segmento del tetto dell'edificio, con un certo numero di pannelli posizionati sopra.
| Rappresentazione JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| Campi | |
|---|---|
panelsCount |
Il numero totale di pannelli in questo segmento. |
yearlyEnergyDcKwh |
La quantità di energia solare che questa parte del layout cattura nel corso di un anno, in kWh CC, supponendo che i pannelli siano quelli descritti sopra. |
pitchDegrees |
Angolo del segmento del tetto rispetto al piano del terreno teorico. 0 = parallelo al suolo, 90 = perpendicolare al suolo. |
azimuthDegrees |
Direzione della bussola verso cui è rivolta la porzione di 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 solare ottimale per un determinato importo della bolletta della luce.
| Rappresentazione JSON |
|---|
{ "monthlyBill": { object ( |
| Campi | |
|---|---|
monthlyBill |
La bolletta mensile dell'energia elettrica su cui si basa questa analisi. |
defaultBill |
Indica se questa è l'entità della bolletta selezionata come bolletta predefinita per l'area in cui si trova l'edificio. Esattamente un |
averageKwhPerMonth |
La quantità di elettricità utilizzata dalla 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 |
Costo e vantaggio del leasing dei pannelli solari. |
cashPurchaseSavings |
Costo e vantaggio dell'acquisto dei pannelli solari in contanti. |
financedPurchaseSavings |
Costo e vantaggio dell'acquisto dei pannelli solari tramite finanziamento. |
panelConfigIndex |
Indice in |
Denaro
Rappresenta un importo in denaro con il relativo 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 unità nano (10^-9) dell'importo. 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. il costo out-of-pocket). Gli importi totali si riferiscono a un periodo di tempo definito dal campo panelLifetimeYears in SolarPotential. Nota: il costo vivo dell'acquisto dei pannelli è indicato nel campo outOfPocketCost in CashPurchaseSavings.
| Rappresentazione JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Campi | |
|---|---|
initialAcKwhPerYear |
Quanti kWh CA riteniamo che i pannelli solari genereranno nel primo anno. |
remainingLifetimeUtilityBill |
Bolletta dell'utenza per l'elettricità non prodotta dall'impianto solare, per la durata dei pannelli. |
federalIncentive |
Importo disponibile tramite incentivi federali; si applica se l'utente acquista i pannelli (con o senza prestito). |
stateIncentive |
Importo disponibile dagli incentivi statali; questo si applica se l'utente acquista (con o senza un prestito) i pannelli. |
utilityIncentive |
Importo disponibile dagli incentivi della società di servizi pubblici; questo si applica se l'utente acquista i pannelli (con o senza un prestito). |
lifetimeSrecTotal |
La somma di denaro che l'utente riceverà dai crediti per l'energia solare rinnovabile nel corso della durata dei pannelli; questo vale se l'utente acquista i pannelli (con o senza un prestito). |
costOfElectricityWithoutSolar |
Il costo totale dell'elettricità che l'utente avrebbe pagato nel corso della durata se non avesse installato un impianto solare. |
netMeteringAllowed |
Se la misurazione netta è consentita. |
solarPercentage |
Percentuale (0-100) dell'energia dell'utente fornita dal solare. Valido per il primo anno, ma approssimativamente corretto per gli anni successivi. |
percentageExportedToGrid |
La percentuale (0-100) di produzione di elettricità solare che abbiamo ipotizzato sia stata esportata nella rete, in base al primo trimestre di produzione. Questo influisce sui calcoli se la misurazione del consumo netto non è consentita. |
LeasingSavings
Costo e vantaggio del leasing di una particolare configurazione di pannelli solari con un particolare consumo di elettricità.
| Rappresentazione JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Campi | |
|---|---|
leasesAllowed |
Indica se i contratti di locazione sono consentiti in questa giurisdizione (i contratti di locazione non sono consentiti in alcuni stati). Se questo campo è false, i valori in questo messaggio dovrebbero probabilmente essere ignorati. |
leasesSupported |
Indica se i leasing sono supportati in questa giurisdizione dal motore di calcolo finanziario. Se questo campo è false, i valori in questo messaggio dovrebbero probabilmente essere ignorati. Questo è indipendente da |
annualLeasingCost |
Costo di leasing annuale stimato. |
savings |
Quanto viene risparmiato (o meno) nel corso della durata. |
SavingsOverTime
Informazioni finanziarie condivise tra diversi metodi di finanziamento.
| Rappresentazione JSON |
|---|
{ "savingsYear1": { object ( |
| Campi | |
|---|---|
savingsYear1 |
Risparmio nel primo anno dopo l'installazione dei pannelli. |
savingsYear20 |
Risparmi nei primi vent'anni dopo l'installazione dei pannelli. |
presentValueOfSavingsYear20 |
Utilizzando il tasso di sconto ipotizzato, qual è il valore attuale dei risparmi cumulativi in 20 anni? |
savingsLifetime |
Risparmi nell'intera durata del pannello. |
presentValueOfSavingsLifetime |
Utilizzando il tasso di sconto ipotizzato, qual è il valore attuale dei risparmi cumulativi nel corso della vita? |
financiallyViable |
Indica se questo scenario è finanziariamente sostenibile. Sarà false per gli scenari con scarsa sostenibilità finanziaria (ad es. in perdita). |
CashPurchaseSavings
Costo e vantaggio di un acquisto definitivo di una particolare configurazione di pannelli solari con un particolare consumo di elettricità.
| Rappresentazione JSON |
|---|
{ "outOfPocketCost": { object ( |
| Campi | |
|---|---|
outOfPocketCost |
Costo iniziale prima degli incentivi fiscali: l'importo che deve essere pagato di tasca propria. Confronta con |
upfrontCost |
Costo iniziale dopo gli incentivi fiscali: l'importo che deve essere pagato durante il primo anno. In contrasto con |
rebateValue |
Il valore di tutti i rimborsi parziali delle imposte. |
savings |
Quanto viene risparmiato (o meno) nel corso della durata. |
paybackYears |
Numero di anni necessari per il recupero. Un valore negativo indica che il rimborso non avviene mai entro il periodo di durata. |
FinancedPurchaseSavings
Costo e vantaggio dell'utilizzo di un prestito per acquistare una particolare configurazione di pannelli solari con un particolare consumo di elettricità.
| Rappresentazione JSON |
|---|
{ "annualLoanPayment": { object ( |
| Campi | |
|---|---|
annualLoanPayment |
Pagamenti annuali del prestito. |
rebateValue |
Il valore di tutte le detrazioni fiscali (incluso il credito d'imposta federale sugli investimenti, ITC). |
loanInterestRate |
Il tasso di interesse sui prestiti ipotizzato in questo insieme di calcoli. |
savings |
Quanto viene risparmiato (o meno) nel corso della durata. |
DetectedArrays
Informazioni sugli impianti solari rilevati nell'edificio.
| Rappresentazione JSON |
|---|
{ "detectionStatus": enum ( |
| Campi | |
|---|---|
detectionStatus |
Indica lo stato di rilevamento degli impianti solari per questo edificio. |
arrays[] |
Un elenco di impianti solari rilevati nell'edificio. |
latestCaptureDate |
La data che indica quando sono stati acquisiti gli ultimi dati sull'impianto solare. |
DetectionStatus
Indica lo stato di rilevamento degli impianti solari per questo edificio.
| Enum | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Stato non specificato. |
DETECTION_STATUS_DATA_UNAVAILABLE |
I dati relativi all'impianto solare rilevato non sono disponibili per questo edificio. |
DETECTION_STATUS_ARRAYS_DETECTED |
È stato rilevato almeno un impianto solare per questo edificio. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Nessun impianto solare rilevato per questo edificio. |
SolarArray
Dettagli di un singolo impianto solare rilevato.
| Rappresentazione JSON |
|---|
{ "polygonGeojson": { object } } |
| Campi | |
|---|---|
polygonGeojson |
Una rappresentazione GeoJSON dell'area dell'edificio in cui sono stati rilevati i pannelli solari. I dati GeoJSON devono essere in formato RFC 7946 e rappresentare un poligono per una singola area contigua. Il poligono sarà rappresentato da diversi anelli quando contiene fori. Esempio: { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |