- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Dinheiro
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Faça um teste
Localiza o edifício cujo centroide está mais próximo de um ponto de consulta. Retorna um erro com o código NOT_FOUND se não houver edifícios em um raio 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 em que a API procura o edifício conhecido mais próximo. |
requiredQuality |
Opcional. O nível mínimo de qualidade permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso equivale a restringir apenas à qualidade ALTA. |
exactQualityRequired |
Opcional. Se é necessário exigir a qualidade exata das imagens. Se definido como falso, o campo |
experiments[] |
Opcional. Especifica os experimentos pré-GA que serão ativados. As solicitações que usam esse campo são classificadas como produtos e recursos em pré-GA de acordo com os Termos de Serviço específicos da Plataforma Google Maps. Consulte as descrições da fase de lançamento para mais detalhes. |
additionalInsights[] |
Opcional. Uma lista de |
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, as dimensões e o 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 ( |
| 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 as imagens subjacentes foram adquiridas. Isso é uma aproximação. |
imageryProcessedDate |
Quando o processamento dessas imagens foi concluído. |
postalCode |
Código postal (por exemplo, CEP dos EUA) em que o edifício está localizado. |
administrativeArea |
Área político-administrativa 1 (por exemplo, nos EUA, o estado) que contém esse 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 edifício está localizado. |
regionCode |
Código do país (ou região) em que o edifício está localizado. |
solarPotential |
Potencial solar do edifício. |
imageryQuality |
A qualidade das imagens usadas para calcular os dados do edifício. |
detectedArrays |
Painéis solares detectados no edifício. Esse campo só é preenchido se DETECTED_ARRAYS estiver incluído no |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Informações adicionais sobre o edifício, como a geometria do telhado e os conjuntos de painéis solares que podem ser retornados em BuildingInsights.
| Tipos enumerados | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
O valor padrão. O BuildingInsights padrão será retornado. |
DETECTED_ARRAYS |
Determina se a resposta vai incluir as matrizes detectadas. Se especificado, o campo |
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 |
Tamanho do conjunto máximo, ou seja, o número máximo de painéis que cabem 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 luz solar 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 (em que kW se refere à capacidade em kW sob condições de teste padrão). |
carbonOffsetFactorKgPerMwh |
Quantidade equivalente de CO2 produzida por MWh de eletricidade da rede. Essa é uma medida da intensidade de carbono da eletricidade da rede substituída pela eletricidade solar. |
wholeRoofStats |
Tamanho total e quantis de luz solar para a parte do telhado que foi atribuída a algum segmento. Apesar do nome, isso pode não incluir todo o edifício. Consulte |
buildingStats |
Quantis de tamanho e luz solar para todo o edifício, incluindo partes do telhado que não foram atribuídas a algum segmento. Como as orientações dessas partes não são bem caracterizadas, a estimativa da área do telhado não é confiável, mas a estimativa da área do solo é. É possível que uma área de telhado mais confiável para todo o edifício seja obtida ao dimensionar a área de telhado de |
roofSegmentStats[] |
Quantis de tamanho e luz solar para cada segmento de telhado. |
solarPanels[] |
Cada |
solarPanelConfigs[] |
Cada |
financialAnalyses[] |
Um |
SizeAndSunshineStats
Quantis de tamanho e incidência de luz solar de um telhado ou parte dele.
| Representação JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Campos | |
|---|---|
areaMeters2 |
A área do telhado ou do segmento do telhado, em m^2. Essa é a área do telhado (considerando a inclinação), não a área de projeção do solo. |
sunshineQuantiles[] |
Quantis da incidência de luz solar pontual na área. Se houver N valores aqui, isso representa os (N-1)-is. Por exemplo, se houver cinco valores, eles serão os quartis (mínimo, 25%, 50%, 75%, máximo). Os valores são em kWh/kW anuais, como |
groundAreaMeters2 |
A área de projeção no solo coberta pelo telhado ou segmento de telhado, em m^2. |
RoofSegmentSizeAndSunshineStats
Informações sobre o tamanho e os quantis de incidência de luz solar de um segmento de telhado.
| Representação JSON |
|---|
{ "stats": { object ( |
| Campos | |
|---|---|
stats |
Tamanho total e quantis de luz solar do 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 teórico do solo. 0 = paralelo ao chão, 90 = perpendicular ao chão. |
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 segmento do telhado, em metros acima do nível do mar, no ponto designado por |
SolarPanel
SolarPanel descreve a posição, a orientação e a 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 ( |
| Campos | |
|---|---|
center |
O centro do painel. |
orientation |
A orientação do painel. |
yearlyEnergyDcKwh |
Quanta energia solar esse layout captura ao longo de um ano, em kWh CC. |
segmentIndex |
Índice em |
SolarPanelOrientation
A orientação de um painel solar. Isso precisa ser interpretado em relação ao azimute do segmento do telhado em que o painel está localizado.
| Tipos enumerados | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nenhuma orientação do painel é conhecida. |
LANDSCAPE |
Um painel LANDSCAPE tem a borda longa perpendicular à direção do azimute do segmento do telhado em que está colocado. |
PORTRAIT |
Um painel PORTRAIT tem a borda longa paralela à direção do azimute do segmento do telhado em que está colocado. |
SolarPanelConfig
SolarPanelConfig descreve uma posição específica dos painéis solares no telhado.
| Representação JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Campos | |
|---|---|
panelsCount |
Número total de painéis. Isso é redundante para (a soma de) os campos correspondentes em |
yearlyEnergyDcKwh |
Quanta energia solar esse layout captura ao longo de um ano, em kWh CC, considerando os painéis descritos acima. |
roofSegmentSummaries[] |
Informações sobre a produção de cada segmento de telhado que tem pelo menos um painel neste layout. |
RoofSegmentSummary
Informações sobre um segmento de telhado no edifício, com um número de painéis colocados 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 CC, considerando os painéis descritos acima. |
pitchDegrees |
Ângulo do segmento do telhado em relação ao plano teórico do solo. 0 = paralelo ao chão, 90 = perpendicular ao chão. |
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 solar ideal para um determinado valor de conta de luz.
| Representação JSON |
|---|
{ "monthlyBill": { object ( |
| Campos | |
|---|---|
monthlyBill |
A conta de energia mensal considerada nesta análise. |
defaultBill |
Se esse é o tamanho de conta selecionado como padrão para a área em que o edifício está. Exatamente um |
averageKwhPerMonth |
A quantidade de eletricidade que a casa usa em um mês médio, com base no valor da conta e nas tarifas de eletricidade locais. |
financialDetails |
Informações financeiras que se aplicam 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 os painéis solares à vista. |
financedPurchaseSavings |
Custo e benefício de comprar os painéis solares financiando a compra. |
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 desembolsado). Os valores totais em dinheiro são referentes a um período definido pelo campo panelLifetimeYears em SolarPotential. Observação: o custo de compra dos painéis é informado no campo outOfPocketCost em CashPurchaseSavings.
| Representação JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Campos | |
|---|---|
initialAcKwhPerYear |
Quantos kWh de corrente alternada (CA) acreditamos que os painéis solares vão gerar no primeiro ano. |
remainingLifetimeUtilityBill |
Conta de consumo de eletricidade não produzida por energia solar, durante a vida útil dos painéis. |
federalIncentive |
Valor disponível em incentivos federais. Isso se aplica se o usuário comprar os painéis (com ou sem empréstimo). |
stateIncentive |
Valor disponível em incentivos estaduais. Isso se aplica se o usuário comprar os painéis (com ou sem empréstimo). |
utilityIncentive |
Valor disponível em incentivos de concessionárias de serviços públicos. Isso se aplica se o usuário comprar os painéis (com ou sem empréstimo). |
lifetimeSrecTotal |
Quantia que o usuário vai receber dos créditos de energia solar renovável durante a vida útil do painel. Isso se aplica se o usuário comprar os painéis (com ou sem empréstimo). |
costOfElectricityWithoutSolar |
Custo total da eletricidade que o usuário teria pago durante o período de vida útil se não tivesse instalado energia solar. |
netMeteringAllowed |
Se a compensação de energia é permitida. |
solarPercentage |
Porcentagem (0 a 100) da energia do usuário fornecida por energia solar. Válido para o primeiro ano, mas aproximadamente correto para os anos seguintes. |
percentageExportedToGrid |
A porcentagem (0 a 100) da produção de eletricidade solar que presumimos ter sido exportada para a rede, com base no primeiro trimestre de produção. Isso afeta os cálculos se a compensação de energia não for permitida. |
LeasingSavings
Custo e benefício de alugar uma configuração específica de painéis solares com um determinado uso de eletricidade.
| Representação JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Campos | |
|---|---|
leasesAllowed |
Se os contratos de locação são permitidos nessa jurisdição (em alguns estados, eles não são permitidos). Se esse campo for falso, os valores nesta mensagem provavelmente serão ignorados. |
leasesSupported |
Se os contratos de locação são aceitos nessa jurisdição pelo mecanismo de cálculo financeiro. Se esse campo for falso, os valores nesta mensagem provavelmente serão ignorados. Isso é independente de |
annualLeasingCost |
Custo anual estimado de leasing. |
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 dos painéis. |
presentValueOfSavingsYear20 |
Usando a taxa de desconto presumida, qual é o valor presente da economia cumulativa de 20 anos? |
savingsLifetime |
Economia durante toda a vida útil do painel. |
presentValueOfSavingsLifetime |
Usando a taxa de desconto presumida, qual é o valor presente da economia cumulativa ao longo da vida útil? |
financiallyViable |
Indica se esse cenário é financeiramente viável. Será falso para cenários com baixa viabilidade financeira (por exemplo, que dão prejuízo). |
CashPurchaseSavings
Custo e benefício de uma compra direta de uma configuração específica de painéis solares com um uso específico de eletricidade.
| Representação JSON |
|---|
{ "outOfPocketCost": { object ( |
| Campos | |
|---|---|
outOfPocketCost |
Custo inicial antes dos incentivos fiscais: o valor que precisa ser pago do próprio bolso. Compare com |
upfrontCost |
Custo inicial após incentivos fiscais: é o valor que precisa ser pago durante o primeiro ano. Compare com |
rebateValue |
O valor de todas as restituições de tributos. |
savings |
Quanto é economizado (ou não) durante o período de vida útil. |
paybackYears |
Número de anos até que o retorno ocorra. 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 uso específico de eletricidade.
| Representação JSON |
|---|
{ "annualLoanPayment": { object ( |
| Campos | |
|---|---|
annualLoanPayment |
Pagamentos anuais de empréstimos. |
rebateValue |
O valor de todas as restituições de tributos, incluindo o Crédito Fiscal de Investimento Federal (ITC, na sigla em inglês). |
loanInterestRate |
A taxa de juros dos empréstimos assumida neste conjunto de cálculos. |
savings |
Quanto é economizado (ou não) durante o período de vida útil. |
DetectedArrays
Informações sobre os painéis solares detectados no edifício.
| Representação JSON |
|---|
{ "detectionStatus": enum ( |
| Campos | |
|---|---|
detectionStatus |
Indica o status de detecção de painéis solares para este edifício. |
arrays[] |
Uma lista de painéis solares detectados no edifício. |
latestCaptureDate |
A data que indica quando os dados mais recentes do painel solar foram capturados. |
DetectionStatus
Indica o status de detecção de painéis solares para este edifício.
| Tipos enumerados | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Status não especificado. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Os dados detectados do painel solar não estão disponíveis para este edifício. |
DETECTION_STATUS_ARRAYS_DETECTED |
Pelo menos um painel solar foi detectado neste edifício. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Nenhum painel solar foi detectado para este edifício. |
SolarArray
Detalhes de um único painel solar detectado.
| Representação JSON |
|---|
{ "polygonGeojson": { object } } |
| Campos | |
|---|---|
polygonGeojson |
Uma representação GeoJSON da área do edifício em que os painéis solares foram detectados. Os dados do GeoJSON precisam estar no formato RFC 7946 e representar um polígono para uma única área contígua. O polígono será representado por vários loops quando tiver furos. Exemplo: { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |