Rechercher des bâtiments

L'API Solar utilise des données de lieu pour déterminer le type de bâtiment et identifie les bâtiments en fonction des images satellite. Cette page explique comment déterminer les informations solaires d'un bâtiment qui sont renvoyées dans une requête buildingInsights.

Types de bâtiments

L'API Solar est compatible avec les bâtiments de type premise. Ce type indique un lieu nommé, généralement un bâtiment ou un ensemble de bâtiments ayant un nom commun.

Les autres types, tels que subpremise ou les ensembles (par exemple, les bâtiments indépendants situés sur une seule propriété, sauf s'ils sont enregistrés en tant que premise) ne sont pas acceptés.

Toitures de bâtiments

L'API Solar identifie l'emplacement optimal des panneaux solaires sur les toits en fonction des images satellites. Les bâtiments résidentiels, en particulier ceux aux toits inclinés ou en pente, sont identifiés avec un degré de précision élevé, tandis que la précision des bâtiments aux toits plats (par exemple, les immeubles d'habitation ou les bâtiments commerciaux) peut varier.

Si la réponse buildingInsights n'inclut pas le champ solarPanelConfigs, le bâtiment a été traité correctement, mais nous n'avons pas pu installer de panneaux sur le toit. Cela peut se produire si le toit est trop petit pour accueillir des panneaux ou trop ombragé pour que les panneaux génèrent une énergie importante.

Conseil :En fonction d'autres approches de sélection, y compris une sélection manuelle par l'utilisateur ou une sélection programmatique personnalisée, vous pouvez utiliser le point de terminaison de l'API Solar dataLayers pour créer vos propres calculs du potentiel solaire et l'emplacement des panneaux.

Rechercher à partir d'une adresse

1. Vous pouvez convertir une adresse en coordonnées de latitude et de longitude à l'aide de l'API Geocoding ou de l'API Place Autocomplete.

   Utilisez place_id pour faire référence au lieu correspondant.

2. Utilisez les coordonnées de latitude et de longitude du lieu dans votre requête API Solar buildingInsights.

   • Si l'API Solar trouve un bâtiment correspondant, vérifiez que le place_id de la réponse buildingInsights correspond au place_id de l'API Geocoding ou de l'API Place Autocomplete.
   • Pour limiter les résultats aux lieux de type premise, ajoutez un filtre de type de lieu aux réponses de l'API Geocoding ou de l'API Places.

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

Remarque :Il arrive que les ID de lieu ne correspondent pas, ce qui signifie que les coordonnées (lat, lng) recherchées ne renvoient pas à la même adresse ou au même bâtiment. Même si la réponse de l'API de géocodage est de granularité ROOFTOP, place_id peut avoir un type autre que premise.

Vous pouvez utiliser l'application exemple Open Source ou envoyer une requête buildingInsights pour vérifier la place_id des bâtiments couverts par l'API Solar.

Sélectionner un lieu sur une carte

Vous pouvez également proposer une expérience complémentaire en permettant aux utilisateurs de sélectionner le bâtiment sur la carte à l'aide de l'API Maps JavaScript. Extrayez la latitude et la longitude du bâtiment à partir de l'événement de souris, puis transmettez ces coordonnées dans une requête buildingInsights.