Method: buildingInsights.findClosest

Localiza o edifício mais próximo de um ponto de consulta. Retorna um erro com o código NOT_FOUND se não houver construções em um raio de 50 m do ponto de consulta.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
location

object (LatLng)

Obrigatório. A longitude e a latitude a partir das quais a API procura o edifício conhecido mais próximo.
requiredQuality

enum (ImageryQuality)

Opcional. O nível mínimo de qualidade permitido nos resultados. Nenhum resultado com qualidade inferior será retornado. Não especificar isso equivale a restringir somente a qualidade ALTA.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para Solar.FindClosestBuildingInsights. Informações sobre o local, dimensões e potencial solar de um edifício.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação 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)
}
Campos
name

string

O nome do recurso do edifício, no formato building/<place ID>.
center

object (LatLng)

Um ponto próximo ao centro da construção.
boundingBox

object (LatLngBox)

A caixa delimitadora do edifício.
imageryDate

object (Date)

Data em que a imagem subjacente foi adquirida. Esse número é aproximado.
imageryProcessedDate

object (Date)

Quando o processamento das imagens foi concluído.
postalCode

string

CEP (por exemplo, CEP dos EUA) que faz parte deste edifício.
administrativeArea

string

Área político-administrativa 1 (por exemplo, nos EUA, o estado) que contém este edifício. Por exemplo, nos EUA, a abreviação pode ser "MA". ou "CA".
statisticalArea

string

Área estatística (por exemplo, setor censitário dos EUA) onde está o edifício.
regionCode

string

Código regional do país (ou região) em que esta construção está.
solarPotential

object (SolarPotential)

Potencial solar do edifício.
imageryQuality

enum (ImageryQuality)

A qualidade das imagens usadas para computar os dados da construção.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

LatLngBox

Uma caixa delimitadora em coordenadas lat/lng.

Representação JSON 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Campos
sw

object (LatLng)

O canto sudoeste da caixa.
ne

object (LatLng)

O canto nordeste da caixa.

SolarPotential

Informações sobre o potencial solar de um edifício. Vários campos são definidos em termos de "painéis". Os campos panelCapacityWatts, panelHeightMeters e panelWidthMeters descrevem os parâmetros do modelo de painel usado nesses cálculos.

Representação 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)
    }
  ]
}
Campos
maxArrayPanelsCount

integer

Tamanho da matriz máxima, ou seja, o número máximo de painéis que podem caber no telhado.
panelCapacityWatts

number

Capacidade, em watts, do painel usado nos cálculos.
panelHeightMeters

number

Altura, em metros na orientação retrato, do painel usado nos cálculos.
panelWidthMeters

number

Largura, em metros, na orientação retrato do painel usado nos cálculos.
panelLifetimeYears

integer

A vida útil esperada, em anos, dos painéis solares. Isso é usado nos cálculos financeiros.
maxArrayAreaMeters2

number

Tamanho, em metros quadrados, da matriz máxima.
maxSunshineHoursPerYear

number

Número máximo de horas de sol recebidas por ano, em qualquer ponto do telhado. As horas de sol são uma medida da quantidade total de insolação (energia) recebida por ano. 1 hora de sol = 1 kWh por kW (onde kW se refere a kW de capacidade nas condições padrão de teste).
carbonOffsetFactorKgPerMwh

number

Quantidade equivalente de CO2 produzido por MWh de eletricidade da rede. Essa é uma medida da intensidade de carbono da eletricidade deslocada pela eletricidade solar.
wholeRoofStats

object (SizeAndSunshineStats)

Tamanho total e quantis de luz solar para a parte do telhado que foi atribuída a algum segmento do telhado. Apesar do nome, isso pode não incluir toda a construção. Consulte buildingStats.
buildingStats

object (SizeAndSunshineStats)

Tamanho e quantis de luz solar para todo o edifício, incluindo partes do telhado que não foram atribuídas a algum segmento do telhado. Como as orientações dessas peças não são bem caracterizadas, a estimativa da área do telhado não é confiável, mas a estimativa da área do solo é confiável. Uma área de telhado mais confiável do edifício pode ser obtida aumentando a área de wholeRoofStats pela proporção das áreas de solo de buildingStats e wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Tamanho e quantis de luz solar para cada segmento de telhado.
solarPanels[]

object (SolarPanel)

Cada SolarPanel descreve um único painel solar. Eles são listados na ordem em que o algoritmo de layout do painel os colocou. Isso geralmente está, embora não sempre, em ordem decrescente de produção de energia anual.
solarPanelConfigs[]

object (SolarPanelConfig)

Cada SolarPanelConfig descreve uma disposição diferente dos painéis solares no telhado. Eles estão em ordem de número crescente de painéis. O SolarPanelConfig com panelsCount=N é baseado nos primeiros N painéis na lista de solarPanels. Esse campo só é preenchido se pelo menos quatro painéis couberem em um telhado.
financialAnalyses[]

object (FinancialAnalysis)

Com uma FinancialAnalysis, você economiza com a energia solar considerando uma determinada conta mensal e um determinado provedor de eletricidade. Eles estão em ordem crescente de valor da fatura mensal. Este campo ficará vazio para edifícios em áreas onde a API Solar não tem informações suficientes para realizar cálculos financeiros.

SizeAndSunshineStats

Tamanho e quantis de sol de um telhado ou parte dele.

Representação JSON 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Campos
areaMeters2

number

A área do telhado ou segmento do telhado, em m^2. Esta é a área do telhado (considerando a inclinação), não a área da pegada do solo.
sunshineQuantiles[]

number

Quantis do raio de sol em toda a área. Se houver N valores aqui, isso representa os iles (N-1). Por exemplo, se houver cinco valores, eles serão os quartis (mín., 25%, 50%, 75%, máx.). Os valores são em kWh/kW anuais, como maxSunshineHoursPerYear.
groundAreaMeters2

number

A área da pegada do solo coberta pelo telhado ou segmento do telhado, em m^2.

RoofSegmentSizeAndSunshineStats

Informações sobre o tamanho e os quantis de sol de um segmento de telhado.

Representação JSON 
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Campos
stats

object (SizeAndSunshineStats)

Tamanho total e quantis de luz solar para o segmento do telhado.
center

object (LatLng)

Um ponto próximo ao centro do segmento do telhado.
boundingBox

object (LatLngBox)

A caixa delimitadora do segmento de telhado.
pitchDegrees

number

Ângulo do segmento do telhado em relação ao plano do solo teórico. 0 = paralelo ao solo, 90 = perpendicular ao solo.
azimuthDegrees

number

Direção da bússola para a qual o segmento do telhado está apontando. 0 = Norte, 90 = Leste, 180 = Sul. Para uma "plano" segmento de telhado (pitchDegrees muito próximo de 0), o azimute não está bem definido e, para consistência, nós o definimos arbitrariamente como 0 (Norte).
planeHeightAtCenterMeters

number

É a altura do plano do segmento do telhado, em metros acima do nível do mar, no ponto designado por center. Junto com a inclinação, o azimute e a localização central, eles definem totalmente o plano do segmento do telhado.

SolarPanel

O SolarPanel descreve a posição, orientação e produção de um único painel solar. Consulte os campos panelHeightMeters, panelWidthMeters e panelCapacityWatts em SolarPotential para saber mais sobre os parâmetros do painel.

Representação JSON 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Campos
center

object (LatLng)

O centro do painel.
orientation

enum (SolarPanelOrientation)

É a orientação do painel.
yearlyEnergyDcKwh

number

Quanta energia de luz solar esse layout captura ao longo de um ano em kWh DC.
segmentIndex

integer

Índice em roofSegmentStats do RoofSegmentSizeAndSunshineStats, que corresponde ao segmento de telhado em que esse painel é colocado.

SolarPanelOrientation

A orientação de um painel solar. Isso deve ser interpretado em relação ao azimute do segmento do telhado em que o painel está colocado.

Enums
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Nenhuma orientação de painel é conhecida.
LANDSCAPE Um painel LANDSCAPE tem a borda longa perpendicular à direção do azimute do segmento do telhado em que está posicionado.
PORTRAIT Um painel PORTRAIT tem a borda longa paralela à direção do azimute do segmento do telhado em que está colocado.

SolarPanelConfig

SolarPanelConfig descreve um posicionamento específico de painéis solares no telhado.

Representação JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Campos
panelsCount

integer

Número total de painéis. Isso é redundante com relação à (soma dos) campos correspondentes em roofSegmentSummaries.
yearlyEnergyDcKwh

number

Quanta energia de luz solar esse layout captura ao longo de um ano, em kWh DC, supondo os painéis descritos acima.
roofSegmentSummaries[]

object (RoofSegmentSummary)

Informações sobre a produção de cada trecho de telhado que carrega pelo menos um painel neste layout. roofSegmentSummaries[i] descreve o i-ésimo segmento de telhado, incluindo tamanho, produção esperada e orientação.

RoofSegmentSummary

Informações sobre um trecho de telhado no edifício, com alguns painéis colocados nele.

Representação JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Campos
panelsCount

integer

O número total de painéis neste trecho.
yearlyEnergyDcKwh

number

Quanta energia de luz solar esta parte do layout captura ao longo de um ano em kWh DC, supondo que os painéis descritos acima sejam usados.
pitchDegrees

number

Ângulo do segmento do telhado em relação ao plano do solo teórico. 0 = paralelo ao solo, 90 = perpendicular ao solo.
azimuthDegrees

number

Direção da bússola para a qual o segmento do telhado está apontando. 0 = Norte, 90 = Leste, 180 = Sul. Para uma "plano" segmento de telhado (pitchDegrees muito próximo de 0), o azimute não está bem definido e, para consistência, nós o definimos arbitrariamente como 0 (Norte).
segmentIndex

integer

Índice em roofSegmentStats do RoofSegmentSizeAndSunshineStats correspondente.

FinancialAnalysis

Análise do custo e dos benefícios do layout solar ideal para um determinado tamanho de conta de luz.

Representação JSON 
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
Campos
monthlyBill

object (Money)

A conta de luz mensal que esta análise considera.
defaultBill

boolean

Indica se este é o tamanho de conta selecionado para ser a conta padrão da área em que este edifício está. Exatamente um FinancialAnalysis em BuildingSolarPotential precisa ter defaultBill definido.
averageKwhPerMonth

number

Quanta eletricidade a casa usa em um mês médio, com base no tamanho da conta e nas tarifas de eletricidade locais.
financialDetails

object (FinancialDetails)

Informações financeiras que se aplicam independentemente da forma de financiamento usada.
leasingSavings

object (LeasingSavings)

Custo e benefício da locação de painéis solares.
cashPurchaseSavings

object (CashPurchaseSavings)

Custo e benefício de comprar os painéis solares com dinheiro.
financedPurchaseSavings

object (FinancedPurchaseSavings)

Custo e benefício do financiamento da compra dos painéis solares.
panelConfigIndex

integer

Índice em solarPanelConfigs do layout solar ideal para esse tamanho de conta. Pode ser -1, indicando que não há layout. Neste caso, as submensagens restantes serão omitidas.

Dinheiro

Representa um montante em dinheiro com o respectivo tipo de moeda.

Representação JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

É o código de moeda de três letras definido no ISO 4217.
units

string (int64 format)

As unidades inteiras do montante. Por exemplo, se currencyCode for "USD", 1 unidade equivalerá a um dólar americano.
nanos

integer

Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se units for positivo, nanos precisará ser positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos precisará ser negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

FinancialDetails

Detalhes de uma análise financeira. Alguns desses detalhes já estão armazenados em níveis mais altos (por exemplo, custo de bolso). Os valores totais em dinheiro correspondem a um período definido pelo campo panelLifetimeYears no SolarPotential. Observação: o custo inicial da compra de painéis é fornecido no campo outOfPocketCost em CashPurchaseSavings.

Representação 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
}
Campos
initialAcKwhPerYear

number

Quantos kWh de AC achamos que os painéis solares vão gerar no primeiro ano.
remainingLifetimeUtilityBill

object (Money)

Conta de consumo de eletricidade não produzida por energia solar, para o ciclo de vida dos painéis.
federalIncentive

object (Money)

Quantia de dinheiro disponível com incentivos federais isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
stateIncentive

object (Money)

Quantia de dinheiro disponível com incentivos do estado isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
utilityIncentive

object (Money)

Quantia de dinheiro disponível com incentivos de serviços públicos isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
lifetimeSrecTotal

object (Money)

Valor que o usuário vai receber de créditos de energia solar renovável durante o ciclo de vida do painel. isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
costOfElectricityWithoutSolar

object (Money)

Custo total da eletricidade que o usuário teria pago ao longo do ciclo de vida se não tivesse instalado a energia solar.
netMeteringAllowed

boolean

Indica se a medição líquida é permitida.
solarPercentage

number

Porcentagem (0 a 100) da energia do usuário fornecida por energia solar. Válido pelo primeiro ano, mas aproximadamente correto para anos futuros.
percentageExportedToGrid

number

A porcentagem (0 a 100) de produção de eletricidade solar que consideramos foi exportada para a rede, com base no primeiro trimestre da produção. Isso afetará os cálculos se a medição líquida não for permitida.

LeasingSavings

Custo e benefício da locação de uma configuração específica de painéis solares com um determinado uso de eletricidade.

Representação JSON 
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Campos
leasesAllowed

boolean

Se locações são permitidas nesta jurisdição (leases não são permitidas em alguns estados). Se esse campo for definido como "false", os valores da mensagem provavelmente serão ignorados.
leasesSupported

boolean

Indica se as locações são compatíveis com esta jurisdição pelo mecanismo de cálculo financeiro. Se esse campo for definido como "false", os valores da mensagem provavelmente serão ignorados. Isso não depende de leasesAllowed: em algumas áreas, os leases são permitidos, mas em condições que não são tratadas pelos modelos financeiros.
annualLeasingCost

object (Money)

Custo estimado do aluguel anual.
savings

object (SavingsOverTime)

Quanto é economizado (ou não) durante o período.

SavingsOverTime

Informações financeiras compartilhadas entre diferentes formas de financiamento.

Representação JSON 
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Campos
savingsYear1

object (Money)

Economia no primeiro ano após a instalação do painel.
savingsYear20

object (Money)

Economia nos primeiros vinte anos após a instalação do painel.
presentValueOfSavingsYear20

object (Money)

Usando a taxa de desconto presumida, qual é o valor atual da economia cumulativa de 20 anos?
savingsLifetime

object (Money)

Economia em todo o ciclo de vida do painel.
presentValueOfSavingsLifetime

object (Money)

Usando a taxa de desconto presumida, qual é o valor atual da economia cumulativa da vida útil?
financiallyViable

boolean

Indica se o cenário é financeiramente viável. Será falso para cenários com baixa viabilidade financeira (por exemplo, perda de dinheiro).

CashPurchaseSavings

Custo e benefício da compra definitiva de uma configuração específica de painéis solares com um uso de eletricidade específico.

Representação JSON 
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Campos
outOfPocketCost

object (Money)

Custo inicial antes dos incentivos fiscais: o valor que precisa ser pago imediatamente. Já upfrontCost, que está depois de incentivos fiscais.
upfrontCost

object (Money)

Custo inicial após incentivos fiscais: é o valor que deve ser pago durante o primeiro ano. Já outOfPocketCost está antes dos incentivos fiscais.
rebateValue

object (Money)

O valor de todos os abatimentos fiscais.
savings

object (SavingsOverTime)

Quanto é economizado (ou não) durante o período.
paybackYears

number

Número de anos até o retorno do investimento. Um valor negativo significa que o retorno nunca ocorre dentro do período de vida útil.

FinancedPurchaseSavings

Custo e benefício de usar um empréstimo para comprar uma configuração específica de painéis solares com um determinado uso de eletricidade.

Representação JSON 
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Campos
annualLoanPayment

object (Money)

Pagamentos anuais dos empréstimos.
rebateValue

object (Money)

O valor de todos os abatimentos fiscais (incluindo o Crédito de Imposto de Investimento Federal (ITC, na sigla em inglês)).
loanInterestRate

number

A taxa de juros dos empréstimos assumida neste conjunto de cálculos.
savings

object (SavingsOverTime)

Quanto é economizado (ou não) durante o período.