Solar API는 장소 데이터를 사용하여 건물 유형을 확인하고 위성 이미지를 기반으로 건물을 식별합니다. 이 페이지에서는 buildingInsights
요청에서 어떤 건물의 태양광 정보가 반환되는지 확인하는 방법을 설명합니다.
건물 유형
Solar API는 premise
유형의 건물을 지원합니다. 이 유형은 이름이 지정된 위치를 나타내며, 일반적으로 공통 이름을 가진 건물 또는 건물 집합을 나타냅니다.
subpremise
또는 화합물(예: premise
로 등록되지 않은 한 단일 부지에 있는 단독 주택)과 같은 다른 유형은 지원되지 않습니다.
건물 지붕
Solar API는 위성 이미지를 기반으로 최적의 옥상 태양광 패널 배치를 식별합니다. 주거용 건물, 특히 경사 또는 지붕이 있는 건물은 높은 정확도로 식별되지만 평평한 지붕이 있는 건물 (예: 아파트 또는 상업용 건물)은 정확도가 다를 수 있습니다.
buildingInsights
응답에 solarPanelConfigs
필드가 포함되지 않은 경우 건물이 올바르게 처리되었지만 지붕에 패널을 설치할 수 없습니다. 지붕이 너무 작아 패널을 설치할 수 없거나 패널이 그늘에 가려져 충분한 에너지를 생성하지 못하는 경우 이러한 문제가 발생할 수 있습니다.
주소에서 검색
Geocoding API 또는 Place Autocomplete API를 사용하여 주소를 위도 및 경도 좌표로 변환할 수 있습니다.
place_id
를 사용하여 일치하는 장소를 참조합니다.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 },... }
- Solar API에서 일치하는 건물을 찾으면
오픈소스 샘플 앱을 사용하거나 buildingInsights
요청을 실행하여 Solar API의 적용 범위 내 건물의 place_id
를 확인할 수 있습니다.
지도에서 위치 선택
사용자가 Maps JavaScript API를 사용하여 지도에서 건물을 선택할 수 있도록 허용하여 보완적인 환경을 제공할 수도 있습니다. 마우스 이벤트에서 건물의 위도와 경도를 추출한 다음 buildingInsights
요청에 해당 좌표를 전달합니다.