건물 검색

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

건물 유형

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

subpremise 또는 화합물(예: premise로 등록되지 않은 한 단일 부지에 있는 단독 주택)과 같은 다른 유형은 지원되지 않습니다.

건물 지붕

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

buildingInsights 응답에 solarPanelConfigs 필드가 포함되지 않은 경우 건물이 올바르게 처리되었지만 지붕에 패널을 설치할 수 없습니다. 지붕이 너무 작아 패널을 설치할 수 없거나 패널이 그늘에 가려져 충분한 에너지를 생성할 수 없는 경우 이러한 문제가 발생할 수 있습니다.

주소에서 검색

  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 요청에 해당 좌표를 전달합니다.

대화형 지도에서 위치를 가리킵니다.