La API de Solar usa datos de lugares para determinar el tipo de edificio y los identifica según las imágenes satelitales. En esta página, se describe cómo determinar qué información solar del edificio se muestra en una solicitud de buildingInsights
.
Tipos de edificios
La API de Solar admite edificios del tipo premise
. Este tipo indica una ubicación designada, generalmente un edificio o un conjunto de edificios con un nombre común.
No se admiten otros tipos, como subpremise
o los compuestos (por ejemplo, edificios independientes ubicados en una sola propiedad, a menos que se registren como premise
).
Techos de edificios
La API de Solar identifica la ubicación óptima de los paneles solares en el techo en función de las imágenes satelitales. Los edificios residenciales, en particular, los techos inclinados o a dos aguas, se identifican con un alto grado de precisión, mientras que los edificios con techos planos (por ejemplo, edificios de departamentos o comerciales) pueden variar en precisión.
Cómo realizar búsquedas desde una dirección
Puedes convertir una dirección en coordenadas de latitud y longitud con la API de Geocoding o la API de Place Autocomplete.
Usa
place_id
para hacer referencia al lugar coincidente.Usa las coordenadas de latitud y longitud del lugar en tu solicitud a la API de Solar
buildingInsights
.- Si la API de Solar encuentra un edificio que coincide, verifica que el
place_id
de la respuestabuildingInsights
coincida con elplace_id
de la API de Geocoding o la API de Place Autocomplete. - Para limitar los resultados a lugares con el tipo
premise
, agrega un filtro de tipo de lugar a las respuestas de la API de Geocoding o de la API de Places.{ "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs", "center": { "latitude": 37.4449739, "longitude": -122.13914659999998 },... }
- Si la API de Solar encuentra un edificio que coincide, verifica que el
Puedes usar la app de ejemplo de código abierto o realizar una solicitud de buildingInsights
para verificar el place_id
de los edificios cubiertos por la API de Solar.
Selecciona una ubicación en un mapa
También puedes ofrecer una experiencia complementaria si permites que los usuarios seleccionen el
edificio en el mapa con la API de Maps JavaScript. Extrae la latitud y la longitud del edificio del evento del mouse y, luego, pasa esas coordenadas en una solicitud buildingInsights
.