- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Dinheiro
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Faça um teste
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 edifícios dentro de aproximadamente 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 |
Obrigatório. A longitude e a latitude a partir das quais a API procura o edifício conhecido mais próximo. |
requiredQuality |
Opcional. O nível de qualidade mínimo permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso equivale a restringir apenas 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 uma construção.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{ "name": string, "center": { object ( |
Campos | |
---|---|
name |
O nome do recurso do edifício, no formato |
center |
Um ponto próximo ao centro do edifício. |
boundingBox |
A caixa delimitadora do edifício. |
imageryDate |
Data em que a imagem subjacente foi adquirida. Esses valores são aproximados. |
imageryProcessedDate |
Quando o processamento das imagens foi concluído. |
postalCode |
Código postal (por exemplo, CEP dos EUA). |
administrativeArea |
Área político-administrativa 1 (por exemplo, o estado nos EUA) que contém este edifício. Por exemplo, nos EUA, a abreviação pode ser "MA" ou "CA". |
statisticalArea |
Área estatística (por exemplo, setor censitário dos EUA) em que o prédio está. |
regionCode |
Código regional do país (ou região) do edifício. |
solarPotential |
Potencial solar do edifício. |
imageryQuality |
A qualidade das imagens usadas para calcular os dados desta construção. |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Uma caixa delimitadora em coordenadas de latitude/longitude.
Representação JSON |
---|
{ "sw": { object ( |
Campos | |
---|---|
sw |
O canto sudoeste da caixa. |
ne |
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 ( |
Campos | |
---|---|
maxArrayPanelsCount |
O tamanho da matriz máxima, ou seja, o número máximo de painéis que podem caber no telhado. |
panelCapacityWatts |
Capacidade, em watts, do painel usado nos cálculos. |
panelHeightMeters |
Altura, em metros na orientação retrato, do painel usado nos cálculos. |
panelWidthMeters |
Largura, em metros na orientação retrato, do painel usado nos cálculos. |
panelLifetimeYears |
A vida útil esperada, em anos, dos painéis solares. Isso é usado nos cálculos financeiros. |
maxArrayAreaMeters2 |
Tamanho, em metros quadrados, da matriz máxima. |
maxSunshineHoursPerYear |
Número máximo de horas de sol recebidas por ano, por qualquer ponto no 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 de teste padrão). |
carbonOffsetFactorKgPerMwh |
Quantidade equivalente de CO2 produzido por MWh de energia elétrica. Esta é uma medida da intensidade de carbono da eletricidade de rede deslocada pela eletricidade solar. |
wholeRoofStats |
Tamanho total e quantis de luz solar para a parte do telhado que foi atribuída a algum segmento do telhado. Apesar do nome, a construção pode não incluir a construção inteira. Consulte os |
buildingStats |
Tamanho e quantis de luz solar para toda a construção, incluindo partes do telhado que não foram atribuídas a algum segmento do telhado. Como as orientações dessas peças não estã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 de um edifício mais confiável pode ser obtida dimensionando a área do telhado de |
roofSegmentStats[] |
Tamanho e quantis de luz solar para cada segmento do telhado. |
solarPanels[] |
Cada |
solarPanelConfigs[] |
Cada |
financialAnalyses[] |
O |
SizeAndSunshineStats
Quantis de tamanho e ventilação de um telhado, ou parte de um telhado.
Representação JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Campos | |
---|---|
areaMeters2 |
A área do telhado ou segmento do telhado, em m^2. Esta é a área do telhado (considerando a inclinação), não a área de cobertura do solo. |
sunshineQuantiles[] |
Quantis da precisão pontual na área. Se houver N valores, isso vai representar os {1/}-iles (N-1). Por exemplo, se houver cinco valores, eles seriam os quartis (mín., 25%, 50%, 75%, máx). Os valores são em kWh/kW anuais, como |
groundAreaMeters2 |
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 solidade de um segmento de telhado.
Representação JSON |
---|
{ "stats": { object ( |
Campos | |
---|---|
stats |
Tamanho total e quantis de luz solar para o segmento do telhado. |
center |
Um ponto próximo ao centro do segmento do telhado. |
boundingBox |
A caixa delimitadora do segmento do telhado. |
pitchDegrees |
Ângulo do segmento do telhado em relação ao plano do solo teórico. 0 = paralelo ao solo, 90 = perpendicular ao solo. |
azimuthDegrees |
Direção da bússola para onde o segmento do telhado está apontando. 0 = Norte, 90 = Leste, 180 = Sul. Para um segmento de telhado "plano" ( |
planeHeightAtCenterMeters |
A altura do plano do trecho do telhado, em metros acima do nível do mar, no ponto designado por |
SolarPanel
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 ver informações sobre os parâmetros do painel.
Representação JSON |
---|
{ "center": { object ( |
Campos | |
---|---|
center |
O centro do painel. |
orientation |
É a orientação do painel. |
yearlyEnergyDcKwh |
Quanta energia solar que este layout captura ao longo de um ano, em DC kWh. |
segmentIndex |
Índice em |
SolarPanelOrientation
A orientação de um painel solar. Isso deve ser interpretado em relação ao azimute do segmento do telhado no qual o painel é 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 é colocado. |
PORTRAIT |
Um painel PORTRAIT tem a borda longa paralela à direção do azimute do segmento do telhado em que ele é colocado. |
SolarPanelConfig
SolarPanelConfig descreve um determinado posicionamento de painéis solares no telhado.
Representação JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Campos | |
---|---|
panelsCount |
Número total de painéis. Isso é redundante em relação à soma dos campos correspondentes em |
yearlyEnergyDcKwh |
Quanta energia solar é capturada por um ano, em kWh, DC, considerando os painéis descritos acima. |
roofSegmentSummaries[] |
Informações sobre a produção de cada trecho de telhado que carrega pelo menos um painel neste layout. |
RoofSegmentSummary
Informações sobre um trecho de telhado de um edifício, com um número de painéis posicionados nele.
Representação JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Campos | |
---|---|
panelsCount |
É o número total de painéis neste segmento. |
yearlyEnergyDcKwh |
Quanta energia solar essa parte do layout captura ao longo de um ano, em kWh, supondo os painéis descritos acima. |
pitchDegrees |
Ângulo do segmento do telhado em relação ao plano do solo teórico. 0 = paralelo ao solo, 90 = perpendicular ao solo. |
azimuthDegrees |
Direção da bússola para onde o segmento do telhado está apontando. 0 = Norte, 90 = Leste, 180 = Sul. Para um segmento de telhado "plano" ( |
segmentIndex |
Índice em |
FinancialAnalysis
Análise do custo e dos benefícios do layout de painéis solares ideal para um determinado tamanho de conta de luz.
Representação JSON |
---|
{ "monthlyBill": { object ( |
Campos | |
---|---|
monthlyBill |
A conta de luz mensal que esta análise pressupõe. |
defaultBill |
Indica se esse é o tamanho de conta selecionado como padrão para a área em que o edifício está. Exatamente um |
averageKwhPerMonth |
Quanta eletricidade a casa usa em um mês médio, com base no tamanho da conta e nas tarifas de eletricidade locais. |
financialDetails |
Informações financeiras aplicáveis independentemente do método de financiamento usado. |
leasingSavings |
Custo e benefício de alugar os painéis solares. |
cashPurchaseSavings |
Custo e benefício de comprar painéis solares com dinheiro. |
financedPurchaseSavings |
Custo e benefício de comprar painéis solares com financiamento. |
panelConfigIndex |
Índice em |
Dinheiro
Representa um montante em dinheiro com o respectivo tipo de moeda.
Representação JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campos | |
---|---|
currencyCode |
O código de moeda de três letras definido no ISO 4217. |
units |
As unidades inteiras do montante. Por exemplo, se |
nanos |
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 |
FinancialDetails
Detalhes de uma análise financeira. Alguns desses detalhes já estão armazenados em níveis mais altos (por exemplo, custo de uso do bolso). Os valores totais monetários são referentes a um período de vida útil definido pelo campo panelLifetimeYears
em SolarPotential
. Observação: o custo que cabe no bolso da compra dos painéis é fornecido no campo outOfPocketCost
no CashPurchaseSavings
.
Representação JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Campos | |
---|---|
initialAcKwhPerYear |
Quantos kWh achamos que os painéis solares vão gerar no primeiro ano. |
remainingLifetimeUtilityBill |
Conta de consumo para a eletricidade não produzida por energia solar, para a vida útil dos painéis. |
federalIncentive |
Quantidade de dinheiro disponível de incentivos federais. Aplicável se o usuário compra (com ou sem um empréstimo) os painéis. |
stateIncentive |
Quantidade de dinheiro disponível dos incentivos do estado. Aplicável se o usuário compra (com ou sem um empréstimo) os painéis. |
utilityIncentive |
Quantidade de dinheiro disponível de incentivos de serviços públicos. Aplicável se o usuário compra (com ou sem um empréstimo) os painéis. |
lifetimeSrecTotal |
É a quantia em dinheiro que o usuário vai receber dos créditos de energia renovável solar durante o ciclo de vida do painel. Isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis. |
costOfElectricityWithoutSolar |
Custo total de eletricidade que o usuário teria pago ao longo do ciclo de vida se não instalasse energia solar. |
netMeteringAllowed |
Indica se a medição líquida é permitida. |
solarPercentage |
Porcentagem (0 a 100) de energia do usuário fornecida por energia solar. Válida para o primeiro ano, mas aproximadamente correta para os próximos anos. |
percentageExportedToGrid |
A porcentagem (0 a 100) de produção de eletricidade solar que assumimos foi exportada para a rede, com base no primeiro trimestre de produção. Isso afetará os cálculos se a medição líquida não for permitida. |
LeasingSavings
Custo e benefício de alugar uma configuração específica de painéis solares com um uso de eletricidade específico.
Representação JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Campos | |
---|---|
leasesAllowed |
Se as arrendamentos são permitidos neste direito (arrendas não são permitidas em alguns estados). Se este campo for falso, os valores nesta mensagem provavelmente serão ignorados. |
leasesSupported |
Indica se os arrendamentos são suportados nesta jurisdição pelo mecanismo de cálculo financeiro. Se este campo for falso, os valores nesta mensagem provavelmente serão ignorados. Isso é independente da |
annualLeasingCost |
Custo estimado de locação. |
savings |
quanto é economizado (ou não) durante o período de vida útil. |
SavingsOverTime
Informações financeiras compartilhadas entre diferentes métodos de financiamento.
Representação JSON |
---|
{ "savingsYear1": { object ( |
Campos | |
---|---|
savingsYear1 |
Economia no primeiro ano após a instalação do painel. |
savingsYear20 |
Economia nos primeiros 20 anos após a instalação do painel. |
presentValueOfSavingsYear20 |
Usando a taxa de desconto presumida, qual é o valor atual da economia cumulativa em 20 anos? |
savingsLifetime |
Economia em todo o ciclo de vida do painel. |
presentValueOfSavingsLifetime |
Usando a taxa de desconto presumida, qual é o valor atual da economia cumulativa durante a vida útil? |
financiallyViable |
Indica se este cenário é financeiramente viável. Será falso para cenários com baixa viabilidade financeira (por exemplo, perda de dinheiro). |
CashPurchaseSavings
Custo e benefício de uma compra definitiva de uma configuração específica de painéis solares com um uso de eletricidade específico.
Representação JSON |
---|
{ "outOfPocketCost": { object ( |
Campos | |
---|---|
outOfPocketCost |
Custo inicial antes dos incentivos fiscais: o valor que deve ser pago imediatamente. Contraste com |
upfrontCost |
Custo inicial após incentivos fiscais: é o valor que deve ser pago durante o primeiro ano. Contraste com |
rebateValue |
O valor de todos os reembolsos de impostos. |
savings |
quanto é economizado (ou não) durante o período de vida útil. |
paybackYears |
Número de anos até que o retorno seja realizado. Um valor negativo significa que o retorno não ocorre no período da 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 uso de eletricidade específico.
Representação JSON |
---|
{ "annualLoanPayment": { object ( |
Campos | |
---|---|
annualLoanPayment |
Pagamentos de empréstimo anuais. |
rebateValue |
O valor de todos os reembolsos de impostos (incluindo o Crédito de Tributo Federal de Investimento (ITC, na sigla em inglês). |
loanInterestRate |
A taxa de juros sobre empréstimos presumidas neste conjunto de cálculos. |
savings |
quanto é economizado (ou não) durante o período de vida útil. |