건물 검색

Solar API는 장소 데이터를 사용하여 건물 유형을 파악하고 위성 이미지를 기반으로 건물을 식별합니다. 이 페이지에서는 buildingInsights 요청에서 반환되는 건물의 태양광 정보를 확인하는 방법을 설명합니다.

건물 유형

Solar API는 premise 유형의 건물을 지원합니다. 이 유형은 이름이 지정된 위치, 일반적으로 공통 이름을 가진 건물 또는 여러 건물을 나타냅니다.

subpremise 또는 조합과 같은 다른 유형(예: premise으로 등록되지 않은 한 단일 속성에 위치한 단독 건물)은 지원되지 않습니다.

건물 옥상

Solar API는 위성 이미지를 기반으로 최적의 옥상 태양 전지판 위치를 식별합니다. 주거용 건물, 특히 경사진 또는 경사진 지붕은 높은 정확도로 식별되지만, 평평한 지붕이 있는 건물 (예: 아파트 또는 상업용 건물)은 정확도가 다를 수 있습니다.

주소에서 검색

  1. Geocoding API 또는 Place Autocomplete API를 사용하여 주소를 위도 및 경도 좌표로 변환할 수 있습니다.

    place_id를 사용하여 일치하는 장소를 참조합니다.

  2. Solar API buildingInsights 요청에서 장소의 위도 및 경도 좌표를 사용합니다.

    • Solar API에서 일치하는 건물을 찾으면 buildingInsights 응답의 place_id가 Geocoding API 또는 Place Autocomplete API의 place_id와 일치하는지 확인합니다.
    • 유형이 premise인 장소로 결과를 제한하려면 Geocoding API 또는 Places API 응답에 장소 유형 필터를 추가합니다.
      {
      "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs",
      "center": {
      "latitude": 37.4449739,
      "longitude": -122.13914659999998
      },...
      }
      

오픈소스 샘플 앱을 사용하거나 buildingInsights 요청을 실행하여 Solar API가 적용되는 건물의 place_id를 확인할 수 있습니다.

지도에서 위치 선택

사용자가 Maps JavaScript API를 사용하여 지도에서 건물을 선택할 수 있도록 하여 보완적인 환경을 제공할 수도 있습니다. 마우스 이벤트에서 건물의 위도와 경도를 추출한 후 buildingInsights 요청에 좌표를 전달합니다.

지점 위치를 연결하는 대화형 지도입니다.