搜索建筑物

Solar API 使用地点数据来确定建筑物类型，并根据卫星图像识别建筑物。本页介绍了如何确定 buildingInsights 请求中返回的是哪栋建筑的太阳能信息。

建筑类型

Solar API 支持类型为 premise 的建筑物。此类型表示已命名的位置，通常是具有常见名称的建筑物或建筑群。

不支持其他类型，例如 subpremise 或复合建筑物（例如位于单个地产上的独立建筑物，除非已注册为 premise）。

建筑物屋顶

Solar API 可根据卫星图像确定屋顶太阳能板的最佳放置位置。住宅建筑（尤其是倾斜屋顶或坡屋顶）的识别准确性较高，而平屋顶建筑（例如公寓楼或商业建筑）的识别准确性可能会有所不同。

如果 buildingInsights 响应不包含 solarPanelConfigs 字段，则表示系统已正确处理相应建筑物，但无法在屋顶上安装太阳能板。如果屋顶太小而无法放置太阳能板，或者阴影太多而无法让太阳能板产生大量电能，就可能会出现这种情况。

提示： 您可以根据其他选择方法（包括用户手动选择或自定义程序化选择）使用 Solar API dataLayers 端点创建自己的太阳能潜力计算和面板放置。

按地址搜索

1. 您可以使用 Geocoding API 或 Place Autocomplete API 将地址转换为纬度和经度坐标。

   使用 place_id 引用匹配的地点。

2. 在 Solar API buildingInsights 请求中使用地点纬度和经度坐标。

   • 如果 Solar API 找到匹配的建筑物，请检查 buildingInsights 响应中的 place_id 是否与 Geocoding API 或地点自动补全 API 中的 place_id 匹配。
   • 如需将结果限制为类型为 premise 的地点，请向 Geocoding API 或 Places API 响应添加地点类型过滤条件。

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

注意 ：有时地点 ID 不匹配，这意味着搜索到的 (lat, lng) 不会解析为同一地址或建筑物。即使 Geocoding API 响应的粒度为 ROOFTOP，place_id 也可能具有 premise 以外的类型。

您可以使用开源示例应用或发出 buildingInsights 请求，检查 Solar API 涵盖的建筑物的 place_id。

在地图上选择位置

您还可以通过允许用户使用 Maps JavaScript API 在地图上选择建筑物，提供互补体验。从鼠标事件中提取建筑物的纬度和经度，然后在 buildingInsights 请求中传入这些坐标。