Cerca edifici

L'API Solar utilizza i dati sui luoghi per determinare il tipo di edificio e identifica gli edifici in base alle immagini satellitari. Questa pagina descrive come determinare quali informazioni solari dell'edificio vengono restituite in una richiesta buildingInsights.

Tipi di edifici

L'API Solar supporta gli edifici di tipo premise. Questo tipo indica una posizione denominata, di solito un edificio o un insieme di edifici con un nome comune.

Altri tipi, come subpremise o complessi, ad esempio edifici indipendenti situati in un'unica proprietà, a meno che non siano registrati come premise, non sono supportati.

Tetti degli edifici

L'API Solar identifica il posizionamento ottimale dei pannelli solari sul tetto in base alle immagini satellitari. Gli edifici residenziali, in particolare i tetti inclinati, sono identificati con un alto grado di precisione, mentre gli edifici con tetti piani (ad esempio condomini o edifici commerciali) possono variare in precisione.

Se la risposta buildingInsights non include il campo solarPanelConfigs, l'edificio è stato elaborato correttamente, ma non è stato possibile posizionare i pannelli sul tetto. Ciò può accadere se il tetto è troppo piccolo per posizionare i pannelli o troppo ombreggiato per consentire ai pannelli di generare energia significativa.

Ricerca da un indirizzo

1. Puoi convertire un indirizzo in coordinate di latitudine e longitudine utilizzando l'API Geocoding o l'API Place Autocomplete.

   Utilizza place_id per fare riferimento al luogo corrispondente.

2. Utilizza le coordinate di latitudine e longitudine del luogo nella richiesta dell'API Solar buildingInsights.

   • Se l'API Solar trova un edificio corrispondente, verifica che il place_id nella risposta buildingInsights corrisponda al place_id dell'API Geocoding o dell'API Place Autocomplete.
   • Per limitare i risultati ai luoghi di tipo premise, aggiungi un filtro per il tipo di luogo alle risposte dell'API Geocoding o dell'API Places.

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

Puoi utilizzare l'app di esempio open source o effettuare una richiesta buildingInsights per controllare il place_id degli edifici coperti dall'API Solar.

Selezionare una posizione su una mappa

Puoi anche offrire un'esperienza complementare consentendo agli utenti di selezionare l'edificio sulla mappa utilizzando l'API Maps JavaScript. Estrai la latitudine e la longitudine dell'edificio dall'evento mouse, quindi passa queste coordinate in una richiesta buildingInsights.