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. In questa pagina viene descritto come determinare per quali informazioni relative all'edificio vengono restituite le informazioni relative all'energia solare in una richiesta di buildingInsights.

Tipi di edifici

L'API Solar supporta edifici di tipo premise. Questo tipo indica un luogo denominato, di solito un edificio o un insieme di edifici con un nome comune.

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

Tetti di edifici

L'API Solar identifica il posizionamento ottimale dei pannelli solari sul tetto in base a immagini satellitari. Gli edifici residenziali, in particolare quelli con tetti inclinati o spioventi, sono identificati con un elevato grado di precisione, mentre la precisione degli edifici con tetti piatti (ad esempio appartamenti o edifici commerciali) può variare.

Suggerimento: sulla base di altri approcci di selezione, tra cui la selezione manuale dell'utente o una selezione programmatica personalizzata, puoi utilizzare l'endpoint dell'API Solar dataLayers per creare i tuoi calcoli del potenziale solare e il posizionamento dei pannelli.

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 place_id nella risposta buildingInsights corrisponda a place_id dell'API Geocoding o dell'API Place Autocomplete.
   • Per limitare i risultati ai luoghi di tipo premise, aggiungi un filtro per tipo di luogo alle risposte dell'API Geocoding o dell'API Places.

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

Nota: a volte gli ID dei luoghi non corrispondono, il che significa che la ricerca (lat, lng) non si risolve nello stesso indirizzo o edificio. Anche se la risposta dell'API Geocoding è granulare ROOFTOP, place_id potrebbe avere un tipo diverso da premise.

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

Selezionare una località su una mappa

Puoi inoltre 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 del mouse, poi inserisci queste coordinate in una richiesta buildingInsights.