Pesquisar edifícios

A API Solar usa dados de lugares para determinar o tipo de edifício e identifica edifícios com base em imagens de satélite. Esta página descreve como determinar quais informações solares do edifício são retornadas em uma solicitação buildingInsights.

Tipos de edifícios

A API Solar é compatível com edifícios do tipo premise. Esse tipo indica um local nomeado, geralmente um prédio ou um conjunto de prédios com um nome em comum.

Outros tipos, como subpremise ou compostos, por exemplo, edifícios separados localizados em uma única propriedade, a menos que esteja registrado como premise, não são compatíveis.

Telhados de edifícios

A API Solar identifica a posição ideal dos painéis solares em telhados com base em imagens de satélite. Edifícios residenciais, principalmente com telhados inclinados ou inclinados, são identificados com um alto grau de precisão, enquanto edifícios com telhados planos (por exemplo, edifícios comerciais ou de apartamentos) podem variar na precisão.

Se a resposta buildingInsights não incluir o campo solarPanelConfigs, o edifício foi processado corretamente, mas não foi possível colocar painéis no telhado. Isso pode acontecer se o telhado for muito pequeno para colocar painéis ou tiver sombra demais para que os painéis gerem energia suficiente.

Dica: com base em outras abordagens de seleção, incluindo a seleção manual do usuário ou uma seleção programática personalizada, é possível usar o endpoint dataLayers da API Solar para criar seus próprios cálculos de potencial solar e posicionamento do painel.

Pesquisar usando um endereço

1. É possível converter um endereço em coordenadas de latitude e longitude usando a API Geocoding ou a API Place Autocomplete.

   Use place_id para se referir ao lugar correspondente.

2. Use as coordenadas de latitude e longitude do lugar na solicitação buildingInsights da API Solar.

   • Se a API Solar encontrar um edifício correspondente, verifique se o place_id na resposta buildingInsights corresponde ao place_id da API Geocoding ou da API Place Autocomplete.
   • Para limitar os resultados a lugares com o tipo premise, adicione um filtro de tipo de lugar às respostas da API Geocoding ou Places.

     {
     "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs",
     "center": {
     "latitude": 37.4449739,
     "longitude": -122.13914659999998
     },...
     }

Observação: às vezes, os IDs de lugar não correspondem, o que significa que a pesquisa (lat, lng) não resolve para o mesmo endereço ou edifício. Mesmo que a resposta da API de Geocodificação tenha granularidade ROOFTOP, o place_id pode ter um tipo diferente de premise.

É possível usar o app de amostra de código aberto ou fazer uma solicitação buildingInsights para verificar o place_id de edifícios cobertos pela API Solar.

Como selecionar um local no mapa

Também é possível oferecer uma experiência complementar permitindo que os usuários selecionem o edifício no mapa usando a API Maps JavaScript. Extraia a latitude e a longitude do edifício do evento do mouse e transmita essas coordenadas em uma solicitação buildingInsights.