Package google.maps.solar.v1

Índice

• Solar (interface)
• BuildingInsights (mensagem)
• CashPurchaseSavings (mensagem)
• DataLayerView (enum)
• DataLayers (mensagem)
• FinancedPurchaseSavings (mensagem)
• FinancialAnalysis (mensagem)
• FinancialDetails (mensagem)
• FindClosestBuildingInsightsRequest (mensagem)
• GetDataLayersRequest (mensagem)
• GetGeoTiffRequest (mensagem)
• ImageryQuality (enum)
• LatLngBox (mensagem)
• LeasingSavings (mensagem)
• RoofSegmentSizeAndSunshineStats (mensagem)
• RoofSegmentSummary (mensagem)
• SavingsOverTime (mensagem)
• SizeAndSunshineStats (mensagem)
• SolarPanel (mensagem)
• SolarPanelConfig (mensagem)
• SolarPanelOrientation (enum)
• SolarPotential (mensagem)

Solar

Definição de serviço para a API Solar.

FindClosestBuildingInsights
rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights) 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 a aproximadamente 50 m do ponto da consulta. Escopos de autorização Requer o seguinte escopo OAuth: https://www.googleapis.com/auth/cloud-platform

GetDataLayers
rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers) Recebe informações solares para uma região ao redor de um local. Retorna um erro com o código NOT_FOUND se o local estiver fora da área de cobertura. Escopos de autorização Requer o seguinte escopo OAuth: https://www.googleapis.com/auth/cloud-platform

GetGeoTiff
rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody) Retorna uma imagem pelo ID. Escopos de autorização Requer o seguinte escopo OAuth: https://www.googleapis.com/auth/cloud-platform

BuildingInsights

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

Campos
name	string O nome do recurso do edifício, no formato buildings/{place_id}.
center	LatLng Um ponto próximo ao centro do edifício.
bounding_box	LatLngBox A caixa delimitadora do edifício.
imagery_date	Date Data em que as imagens foram adquiridas. Isso é aproximado.
imagery_processed_date	Date Quando o processamento foi concluído nas imagens.
postal_code	string CEP (por exemplo, CEP dos EUA) em que o edifício está localizado.
administrative_area	string Área político-administrativa 1 (por exemplo, o estado nos EUA) que contém o edifício. Por exemplo, nos EUA, a abreviação pode ser "MA" ou "CA".
statistical_area	string Área estatística (por exemplo, Setor censitário dos EUA) em que o edifício está.
region_code	string Código da região do país (ou região) em que o edifício está.
solar_potential	SolarPotential Potencial solar do edifício.
imagery_quality	ImageryQuality A qualidade das imagens usadas para calcular os dados do edifício.

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.

Campos
out_of_pocket_cost	Money Custo inicial antes dos incentivos fiscais: o valor que precisa ser pago com recursos próprios. Compare com upfront_cost, que é após incentivos fiscais.
upfront_cost	Money Custo inicial após incentivos fiscais: é o valor que precisa ser pago durante o primeiro ano. Compare com out_of_pocket_cost, que é antes dos incentivos fiscais.
rebate_value	Money O valor de todos os reembolsos de impostos.
savings	SavingsOverTime Quanto é economizado (ou não) durante o período de validade.
payback_years	float Número de anos até o retorno do investimento. Um valor negativo significa que o retorno nunca ocorre no período de validade.

DataLayerView

Qual subconjunto das informações solares retornar.

Enums
DATA_LAYER_VIEW_UNSPECIFIED	É equivalente a "FULL".
DSM_LAYER	Receber apenas o DSM.
IMAGERY_LAYERS	Receba o DSM, o RGB e a máscara.
IMAGERY_AND_ANNUAL_FLUX_LAYERS	Receba o DSM, RGB, máscara e fluxo anual.
IMAGERY_AND_ALL_FLUX_LAYERS	Receba o DSM, RGB, máscara, fluxo anual e fluxo mensal.
FULL_LAYERS	Receber todos os dados.

DataLayers

Informações sobre o potencial solar de uma região. Os dados reais estão contidos em vários arquivos GeoTIFF que abrangem a região solicitada, e esta mensagem contém URLs: cada string na mensagem DataLayers contém um URL em que o GeoTIFF correspondente pode ser buscado. Esses URLs são válidos por algumas horas após a geração. A maioria dos arquivos GeoTIFF tem uma resolução de 0,1 m/pixel, mas o arquivo de fluxo mensal tem 0,5 m/pixel, e os arquivos de sombra por hora têm 1 m/pixel. Se um valor de pixel_size_meters foi especificado no GetDataLayersRequest, a resolução mínima nos arquivos GeoTIFF será esse valor.

Campos
imagery_date	Date Quando as imagens de origem (de onde todos os outros dados são derivados) foram tiradas. Ele é necessariamente aproximado, já que as imagens podem ter sido tiradas em mais de um dia.
imagery_processed_date	Date Quando o processamento foi concluído nas imagens.
dsm_url	string O URL de uma imagem do DSM (modelo de superfície digital) da região. Os valores estão em metros acima do geóide EGM96 (ou seja, do nível do mar). Os locais inválidos (onde não há dados) são armazenados como -9999.
rgb_url	string O URL de uma imagem de dados RGB (foto aérea) da região.
mask_url	string O URL da imagem da máscara do edifício: um bit por pixel informando se o pixel é considerado parte de um telhado ou não.
annual_flux_url	string O URL do mapa de fluxo anual (insolação anual nos telhados) da região. Os valores são kWh/kW/ano. Esse é o fluxo desmascarado: o fluxo é calculado para cada local, não apenas para os telhados dos edifícios. Os locais inválidos são armazenados como -9999: locais fora da nossa área de cobertura serão inválidos, e alguns locais dentro da área de cobertura, em que não foi possível calcular o fluxo, também serão inválidos.
monthly_flux_url	string O URL do mapa de fluxo mensal (luz solar nos telhados, dividido por mês) da região. Os valores são kWh/kW/ano. O GeoTIFF indicado por este URL vai conter 12 bandas, correspondentes a janeiro a dezembro, em ordem.
hourly_shade_urls[]	string Doze URLs para sombra por hora, correspondentes a janeiro...dezembro, em ordem. Cada GeoTIFF vai conter 24 faixas, correspondendo às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondente a até 31 dias daquele mês. Um bit significa que o local correspondente consegue ver o sol naquele dia, hora e mês. Locais inválidos são armazenados como -9999. Como esse valor é negativo, ele tem o bit 31 definido, e nenhum valor válido pode ter o bit 31 definido, já que isso corresponderia ao 32º dia do mês. Um exemplo pode ser útil. Se você quiser saber se um ponto (na localização do pixel (x, y)) teve sol às 16h do dia 22 de junho, faça o seguinte: buscar o sexto URL da lista (correspondente a junho). pesquise o canal 17 (correspondente às 16h). Leia o valor de 32 bits em (x, y). Leia o bit 21 do valor (correspondente ao dia 22 do mês). Se esse bit for 1, o local terá recebido luz solar às 16h do dia 22 de junho. De forma mais formal: considerando month (1 a 12), day (1 a 31, no máximo, sendo que fevereiro tem 28 dias) e hour (0 a 23), a sombra/sol para esse mês/dia/hora em uma posição (x, y) é o bit (hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1)) em que (x, y) é a indexação espacial, [month - 1] se refere à busca do URL month - 1st (indexação a partir de zero), [hour] é a indexação nos canais e um resultado final diferente de zero significa "ensolarado". Não há dias bissextos, e o horário de verão não existe (todos os dias têm 24 horas; o meio-dia é sempre "horário padrão").
imagery_quality	ImageryQuality A qualidade das imagens do resultado.

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.

Campos
annual_loan_payment	Money Pagamentos anuais de empréstimos.
rebate_value	Money O valor de todos os reembolsos de impostos (incluindo o crédito fiscal federal de investimento (ITC, na sigla em inglês)).
loan_interest_rate	float A taxa de juros dos empréstimos assumidos neste conjunto de cálculos.
savings	SavingsOverTime Quanto é economizado (ou não) durante o período de validade.

FinancialAnalysis

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

Campos
monthly_bill	Money A conta de luz mensal que essa análise assume.
default_bill	bool Se esse é o tamanho de conta selecionado como padrão para a área em que o edifício está. Exatamente um FinancialAnalysis em BuildingSolarPotential precisa ter default_bill definido.
average_kwh_per_month	float Quanta eletricidade a casa usa em um mês médio, com base no tamanho da conta e nas tarifas locais de eletricidade.
financial_details	FinancialDetails Informações financeiras que se aplicam independentemente do método de financiamento usado.
leasing_savings	LeasingSavings Custo e benefício do aluguel dos painéis solares.
cash_purchase_savings	CashPurchaseSavings Custo e benefício de comprar os painéis solares com dinheiro.
financed_purchase_savings	FinancedPurchaseSavings Custo e benefício da compra de painéis solares com financiamento.
panel_config_index	int32 Índice em solar_panel_configs do layout solar ideal para esse tamanho de conta. Pode ser -1, indicando que não há layout. Nesse caso, as submensagens restantes serão omitidas.

FinancialDetails

Detalhes de uma análise financeira. Alguns desses detalhes já estão armazenados em níveis mais altos (por exemplo, custo próprio). Os valores totais são calculados em um período de vida útil definido pelo campo panel_lifetime_years em SolarPotential. Observação: o custo de compra dos painéis é informado no campo out_of_pocket_cost em CashPurchaseSavings.

Campos
initial_ac_kwh_per_year	float Quantas kWh de corrente alternada os painéis solares vão gerar no primeiro ano.
remaining_lifetime_utility_bill	Money Conta de luz para eletricidade não produzida por energia solar, durante a vida útil dos painéis.
federal_incentive	Money Quantidade de dinheiro disponível de incentivos federais; isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
state_incentive	Money Valor disponível de incentivos estaduais; isso se aplica se o usuário comprar (com ou sem empréstimo) os painéis.
utility_incentive	Money Valor disponível em incentivos de serviços públicos. Isso se aplica se o usuário comprar os painéis (com ou sem um empréstimo).
lifetime_srec_total	Money Valor que o usuário vai receber dos créditos de energia renovável solar durante a vida útil do painel. Isso se aplica se o usuário comprar os painéis (com ou sem empréstimo).
cost_of_electricity_without_solar	Money O custo total de eletricidade que o usuário teria pago durante o período de vida útil se não tivesse instalado painéis solares.
net_metering_allowed	bool Se a compensação de energia é permitida.
solar_percentage	float Porcentagem (0 a 100) da energia do usuário fornecida por energia solar. Válido para o primeiro ano, mas aproximadamente correto para anos futuros.
percentage_exported_to_grid	float A porcentagem (0 a 100) da produção de energia 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.

FindClosestBuildingInsightsRequest

Mensagem de solicitação para Solar.FindClosestBuildingInsights.

Campos
location	LatLng Obrigatório. A longitude e a latitude em que a API procura o edifício conhecido mais próximo.
required_quality	ImageryQuality Opcional. O nível mínimo de qualidade permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso é equivalente a restringir apenas a qualidade ALTA.

GetDataLayersRequest

Mensagem de solicitação para Solar.GetDataLayers.

Campos
location	LatLng Obrigatório. A longitude e a latitude do centro da região para extrair dados.
radius_meters	float Obrigatório. O raio, em metros, que define a região ao redor do ponto central para que os dados serão retornados. As limitações desse valor são: É possível especificar qualquer valor até 100 m. Valores acima de 100 m podem ser especificados, desde que radius_meters <= pixel_size_meters * 1000. No entanto, para valores acima de 175 m, o DataLayerView na solicitação não pode incluir fluxo mensal ou sombra por hora.
view	DataLayerView Opcional. O subconjunto de dados desejado a ser retornado.
required_quality	ImageryQuality Opcional. O nível mínimo de qualidade permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso é equivalente a restringir apenas a qualidade ALTA.
pixel_size_meters	float Opcional. A escala mínima, em metros por pixel, dos dados a serem retornados. Os valores 0,1 (padrão, se esse campo não for definido explicitamente), 0,25, 0,5 e 1,0 são aceitos. Os componentes de imagem com resolução normal inferior a pixel_size_meters serão retornados na resolução especificada por pixel_size_meters. Os componentes de imagem com resolução normal igual ou superior a pixel_size_meters serão retornados nessa resolução normal.
exact_quality_required	bool Opcional. Se é necessário exigir a qualidade exata das imagens. Se definido como "false", o campo required_quality é interpretado como a qualidade mínima necessária. Assim, imagens de ALTA qualidade podem ser retornadas quando required_quality é definido como MEDIUM. Se definido como "true", required_quality é interpretado como a qualidade exata necessária, e apenas imagens de qualidade MEDIUM são retornadas se required_quality for definido como MEDIUM.

GetGeoTiffRequest

Mensagem de solicitação para Solar.GetGeoTiff.

Campos
id	string Obrigatório. O ID do recurso que está sendo solicitado.

ImageryQuality

A qualidade das imagens usadas para calcular alguns resultados da API.

Observação: independentemente do nível de qualidade das imagens, as saídas de DSM sempre têm uma resolução de 0,1 m/pixel, as saídas de fluxo mensal sempre têm uma resolução de 0,5 m/pixel e as saídas de sombra por hora sempre têm uma resolução de 1 m/pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED	A qualidade não é conhecida.
HIGH	Os dados solares são derivados de imagens aéreas capturadas em baixa altitude e processados a 0,1 m/pixel.
MEDIUM	Os dados solares são derivados de imagens aéreas aprimoradas capturadas em alta altitude e processadas a 0,25 m/pixel.
LOW	Os dados solares são derivados de imagens de satélite aprimoradas processadas a 0,25 m/pixel.
BASE	Os dados solares são derivados de imagens de satélite aprimoradas processadas a 0,25 m/pixel.

LatLngBox

Uma caixa delimitadora em coordenadas lat/lng.

Campos
sw	LatLng O canto sudoeste da caixa.
ne	LatLng O canto nordeste da caixa.

LeasingSavings

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

Campos
leases_allowed	bool Se os contratos de arrendamento são permitidos nesta jurisdição (eles não são permitidos em alguns estados). Se esse campo for falso, os valores dessa mensagem provavelmente serão ignorados.
leases_supported	bool Se o mecanismo de cálculo financeiro tem suporte a aluguéis nesta jurisdição. Se esse campo for falso, os valores dessa mensagem provavelmente serão ignorados. Isso é independente de leases_allowed: em algumas áreas, os aluguéis são permitidos, mas sob condições que não são tratadas pelos modelos financeiros.
annual_leasing_cost	Money Custo anual estimado do leasing.
savings	SavingsOverTime Quanto é economizado (ou não) durante o período de validade.

RoofSegmentSizeAndSunshineStats

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

Campos
stats	SizeAndSunshineStats Tamanho total e quantis de luz solar para o segmento do telhado.
center	LatLng Um ponto próximo ao centro do segmento do telhado.
bounding_box	LatLngBox A caixa delimitadora do segmento do telhado.
pitch_degrees	float Ângulo do segmento do telhado em relação ao plano teórico do solo. 0 = paralelo ao solo, 90 = perpendicular ao solo.
azimuth_degrees	float 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" (pitch_degrees muito próximo de 0), o azimute não é bem definido. Portanto, para manter a consistência, definimos arbitrariamente como 0 (norte).
plane_height_at_center_meters	float A altura do plano do segmento do telhado, em metros acima do nível do mar, no ponto designado por center. Junto com o ângulo de inclinação, azimute e localização central, isso define totalmente o plano do segmento do telhado.

RoofSegmentSummary

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

Campos
panels_count	int32 O número total de painéis neste segmento.
yearly_energy_dc_kwh	float Quanta energia solar essa parte do layout captura ao longo de um ano, em CC kWh, considerando os painéis descritos acima.
pitch_degrees	float Ângulo do segmento do telhado em relação ao plano teórico do solo. 0 = paralelo ao solo, 90 = perpendicular ao solo.
azimuth_degrees	float 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" (pitch_degrees muito próximo de 0), o azimute não é bem definido. Portanto, para manter a consistência, definimos arbitrariamente como 0 (norte).
segment_index	int32 Índice em roof_segment_stats do RoofSegmentSizeAndSunshineStats correspondente.

SavingsOverTime

Informações financeiras compartilhadas entre diferentes métodos de pagamento.

Campos
savings_year1	Money Economia no primeiro ano após a instalação do painel.
savings_year20	Money Economia nos primeiros 20 anos após a instalação do painel.
present_value_of_savings_year20	Money Usando a taxa de desconto presumida, qual é o valor presente da economia cumulativa de 20 anos?
savings_lifetime	Money Economia em todo o ciclo de vida do painel.
present_value_of_savings_lifetime	Money Usando a taxa de desconto presumida, qual é o valor presente das economias cumulativas da vida útil?
financially_viable	bool Indica se esse cenário é financeiramente viável. Será falso para cenários com baixa viabilidade financeira (por exemplo, perda de dinheiro).

SizeAndSunshineStats

Quantis de tamanho e insolação de um telhado ou parte dele.

Campos
area_meters2	float 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 do terreno.
sunshine_quantiles[]	float Quantis da insolação por ponto na área. Se houver N valores aqui, isso representa os percentis (N-1). Por exemplo, se houver cinco valores, eles serão os quartis (mínimo, 25%, 50%, 75%, máximo). Os valores estão em kWh/kW anuais, como max_sunshine_hours_per_year.
ground_area_meters2	float A área do terreno coberta pelo telhado ou pelo segmento do telhado, em m2.

SolarPanel

SolarPanel descreve a posição, a orientação e a produção de um único painel solar. Consulte os campos panel_height_meters, panel_width_meters e panel_capacity_watts em SolarPotential para informações sobre os parâmetros do painel.

Campos
center	LatLng O centro do painel.
orientation	SolarPanelOrientation A orientação do painel.
yearly_energy_dc_kwh	float Quanta energia solar esse layout captura ao longo de um ano, em kWh de corrente contínua.
segment_index	int32 Índice em roof_segment_stats do RoofSegmentSizeAndSunshineStats que corresponde ao segmento do telhado em que o painel está colocado.

SolarPanelConfig

SolarPanelConfig descreve uma posição específica de painéis solares no telhado.

Campos
panels_count	int32 Número total de painéis. Isso é redundante com (a soma de) os campos correspondentes em roof_segment_summaries.
yearly_energy_dc_kwh	float Quanta energia solar esse layout captura ao longo de um ano, em kWh CC, considerando os painéis descritos acima.
roof_segment_summaries[]	RoofSegmentSummary Informações sobre a produção de cada segmento de telhado que carrega pelo menos um painel nesse layout. roof_segment_summaries[i] descreve o segmento de telhado i, incluindo o tamanho, a produção esperada e a orientação.

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

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

SolarPotential

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

Campos
max_array_panels_count	int32 Tamanho da matriz máxima, ou seja, o número máximo de painéis que cabem no telhado.
panel_capacity_watts	float Capacidade, em watts, do painel usado nos cálculos.
panel_height_meters	float Altura, em metros na orientação retrato, do painel usado nos cálculos.
panel_width_meters	float Largura, em metros na orientação retrato, do painel usado nos cálculos.
panel_lifetime_years	int32 A vida útil esperada, em anos, dos painéis solares. Ele é usado nos cálculos financeiros.
max_array_area_meters2	float Tamanho, em metros quadrados, da matriz máxima.
max_sunshine_hours_per_year	float 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 (kW refere-se à capacidade em condições de teste padrão).
carbon_offset_factor_kg_per_mwh	float Quantidade equivalente de CO2 produzida por MWh de eletricidade da rede. Essa é uma medida da intensidade de carbono da eletricidade da rede deslocada pela eletricidade solar.
whole_roof_stats	SizeAndSunshineStats Tamanho total e quantis de luz solar para a parte do telhado atribuída a algum segmento. Apesar do nome, isso pode não incluir o edifício inteiro. Consulte building_stats.
building_stats	SizeAndSunshineStats Tamanho e cuantels 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 partes não são bem caracterizadas, a estimativa da área do telhado não é confiável, mas a estimativa da área do solo é. Talvez seja possível obter uma área de telhado de edifício mais confiável ao dimensionar a área do telhado de whole_roof_stats pela proporção das áreas do solo de building_stats e whole_roof_stats.
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats Quantis de tamanho e luz solar para cada segmento do telhado.
solar_panels[]	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 ocorre em ordem decrescente da produção anual de energia, mas nem sempre.
solar_panel_configs[]	SolarPanelConfig Cada SolarPanelConfig descreve um arranjo diferente de painéis solares no telhado. Elas estão em ordem crescente de número de painéis. O SolarPanelConfig com panels_count=N é baseado nos primeiros N painéis da lista solar_panels. Esse campo só será preenchido se pelo menos quatro painéis couberem em um telhado.
financial_analyses[]	FinancialAnalysis Um FinancialAnalysis mostra a economia da energia solar, considerando uma conta mensal e um determinado fornecedor de eletricidade. Eles estão em ordem crescente do valor da fatura mensal. Esse campo vai ficar vazio para edifícios em áreas em que a API Solar não tem informações suficientes para realizar cálculos financeiros.