Cerca edifici

L'API Solar utilizza i dati dei luoghi per determinare il tipo di edificio e identificare 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 località con nome, in genere un edificio o una serie 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 quelli con tetto inclinato o a spiovente, vengono identificati con un elevato grado di precisione, mentre la precisione degli edifici con tetto piatto (ad esempio condomini o edifici commerciali) può variare.

Se la risposta buildingInsights non include il campo solarPanelConfigs, l'edificio è stato elaborato correttamente, ma non è stato possibile installare 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 in modo significativo.

Suggerimento: in base ad altri approcci di selezione, tra cui la selezione manuale da parte dell'utente o una selezione programmatica personalizzata, puoi utilizzare l'endpoint dell'API Solare 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 Solare buildingInsights.

   • Se l'API Solar trova un edificio corrispondente, controlla che il valore 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 il 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 luogo non corrispondono, il che significa che i valori (lat, lng) cercati non corrispondono allo stesso indirizzo o edificio. Anche se la risposta dell'API Geocoding è di granularità ROOFTOP, il valore place_id potrebbe avere un tipo diverso da premise.

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

Selezionare una località 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.