Buscar edificios

La API de Solar utiliza datos de ubicación para determinar el tipo de edificio y los identifica en función de las imágenes satelitales. En esta página, se describe cómo determinar qué información solar de un edificio se devuelve 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 compuestos (por ejemplo, edificios separados ubicados en una sola propiedad, a menos que se registren como premise).

Construcción de techos

La API de Solar identifica la ubicación óptima de los paneles solares en el techo según las imágenes satelitales. Los edificios residenciales, en especial 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 apartamentos o comerciales) pueden variar en precisión.

Si la respuesta de buildingInsights no incluye el campo solarPanelConfigs, el edificio se procesó correctamente, pero no pudimos colocar paneles en el techo. Esto puede suceder si el techo es demasiado pequeño para colocar paneles o si tiene demasiada sombra para que los paneles generen energía significativa.

Sugerencia: Según otros enfoques de selección, como la selección manual del usuario o una selección programática personalizada, puedes usar el extremo dataLayers de la API de Solar para crear tus propios cálculos de potencial solar y la colocación de paneles.

Cómo buscar desde una dirección

1. 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.

2. Usa las coordenadas de latitud y longitud del lugar en tu solicitud de la API de Solar buildingInsights.

   • Si la API de Solar encuentra un edificio coincidente, verifica que el place_id en la respuesta de buildingInsights coincida con el place_id de la API de Geocoding o la API de Place Autocomplete.
   • Para limitar los resultados a lugares del tipo premise, agrega un filtro de tipo de lugar a las respuestas de la API de Geocoding o de Places.

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

Nota: A veces, los IDs de lugar no coincidirán, lo que significa que la búsqueda (latitud, longitud) no se resuelve en la misma dirección o edificio. Incluso si la respuesta de la API de Geocoding tiene una granularidad de ROOFTOP, es posible que place_id tenga un tipo distinto de premise.

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.

Cómo seleccionar una ubicación en un mapa

También puedes ofrecer una experiencia complementaria permitiendo 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 de buildingInsights.