Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Solar usa dados de lugar 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 de um 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 edifício ou condomínios com um nome comum.
Outros tipos, como subpremise ou complexos (por exemplo, edifícios isolados localizados em uma única propriedade, a menos que registrados como um premise), não são aceitos.
Telhados de edifícios
A API Solar identifica o posicionamento ideal dos painéis solares no telhado com base em imagens de satélite. Edifícios residenciais, principalmente com telhados inclinados ou em forma de pirâmide, são identificados com um alto grau de precisão. Já edifícios com telhados planos (por exemplo, apartamentos ou edifícios comerciais) podem variar em 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 se estiver muito sombreado para que eles gerem energia significativa.
Use o place_id para se referir ao lugar correspondente.
Use as coordenadas de latitude e longitude do lugar na sua solicitação da API Solar
buildingInsights.
Se a API Solar encontrar um prédio correspondente, verifique se o place_id na resposta buildingInsights corresponde ao place_id da API Geocoding ou Place Autocomplete.
Para limitar os resultados a lugares do tipo premise, adicione um filtro de tipo de lugar às respostas da API Geocoding ou Places.
Você também pode 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eThe Solar API uses place data and satellite imagery to identify buildings and determine their solar potential, focusing on buildings classified as "premise" in Google Places.\u003c/p\u003e\n"],["\u003cp\u003eThe API primarily supports residential buildings with inclined roofs for accurate solar panel placement, while accuracy may vary for flat-roofed buildings.\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003esolarPanelConfigs\u003c/code\u003e field is missing from the API response, it indicates the building was analyzed, but solar panel placement was not feasible due to roof size or shading.\u003c/p\u003e\n"],["\u003cp\u003eUsers can identify buildings for solar analysis by converting addresses to coordinates using Geocoding or Place Autocomplete APIs and passing the coordinates to the Solar API.\u003c/p\u003e\n"],["\u003cp\u003eA complementary approach involves users selecting a building directly on a map using the Maps JavaScript API, and using the extracted coordinates for solar analysis.\u003c/p\u003e\n"]]],["The Solar API utilizes place data and satellite imagery to identify buildings and determine solar potential. It primarily supports `premise` type buildings, excluding `subpremise` types. Optimal solar panel placement is assessed, with higher accuracy for residential pitched roofs; flat roofs may vary. The API can be used by converting an address to coordinates via the Geocoding or Place Autocomplete APIs, or by using a location selected on a map. The results can be filtered to places of type premise, and the results from the building insights api can be compared to the results from the geocoding or places API.\n"],null,[]]