Rechercher des bâtiments

L'API Solar utilise des données de lieu pour déterminer le type de bâtiment et identifier ceux-ci à partir des images satellite. Cette page explique comment déterminer les informations sur l'énergie solaire du 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 les subpremise ou les bâtiments (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.

Toits de bâtiments

L'API Solar détermine l'emplacement optimal des panneaux solaires sur les toits en se basant sur l'imagerie satellite. Les bâtiments résidentiels, en particulier les toits inclinés, sont identifiés avec un degré de précision élevé, tandis que les bâtiments à toit plat (par exemple, les immeubles d'habitation ou les bâtiments commerciaux) peuvent varier en termes de précision.

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

Recherche à 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 buildingInsights de l'API Solar.

   • Si l'API Solar trouve un bâtiment correspondant, vérifiez que place_id dans la réponse buildingInsights correspond à l'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 :Parfois, les ID de lieu ne correspondent pas, ce qui signifie que la recherche (lat, lng) ne renvoie pas vers la même adresse ou le même bâtiment. Même si la réponse de l'API Geocoding est de précision ROOFTOP, place_id peut avoir un type autre que premise.

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

Sélectionner un emplacement 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-les dans une requête buildingInsights.