Package google.maps.solar.v1

색인

태양광

Solar API의 서비스 정의입니다.

FindClosestBuildingInsights

rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights)

중심점이 쿼리 지점에 가장 가까운 건물을 찾습니다. 쿼리 지점으로부터 약 50m 이내에 건물이 없으면 코드 NOT_FOUND와 함께 오류를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetDataLayers

rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers)

위치 주변 지역의 태양광 정보를 가져옵니다. 위치가 서비스 지역 외부에 있는 경우 코드 NOT_FOUND와 함께 오류를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetGeoTiff

rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody)

ID별로 이미지를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

BuildingInsights

Solar.FindClosestBuildingInsights의 응답 메시지입니다. 건물의 위치, 크기, 태양광 발전 가능성에 관한 정보입니다.

필드
name

string

건물의 리소스 이름으로, buildings/{place_id} 형식입니다.

center

LatLng

건물 중앙 근처의 지점

bounding_box

LatLngBox

건물의 경계 상자입니다.

imagery_date

Date

기본 이미지가 획득된 날짜입니다. 이는 대략적인 수치입니다.

imagery_processed_date

Date

이 이미지의 처리가 완료된 시간입니다.

postal_code

string

우편번호 (예: 미국 우편번호)를 포함합니다.

administrative_area

string

이 건물이 있는 행정 구역 1 (예: 미국의 경우 주)입니다. 예를 들어 미국에서는 'MA' 또는 'CA'가 약어일 수 있습니다.

statistical_area

string

통계 지역 (예: 건물이 위치한 미국 인구조사 구역)을 입력합니다.

region_code

string

건물이 있는 국가 (또는 지역)의 지역 코드입니다.

solar_potential

SolarPotential

건물의 태양광 잠재 발전량

imagery_quality

ImageryQuality

이 건물의 데이터를 계산하는 데 사용된 이미지의 품질입니다.

CashPurchaseSavings

특정 전기 사용량으로 특정 구성의 태양광 패널을 일괄 구매할 때의 비용과 이점

필드
out_of_pocket_cost

Money

세금 인센티브 전 초기 비용: 본인이 직접 지불해야 하는 금액입니다. 세금 인센티브를 적용한 upfront_cost와 대비됩니다.

upfront_cost

Money

세금 인센티브 후 초기 비용: 첫해에 지불해야 하는 금액입니다. 세금 인센티브 이전의 out_of_pocket_cost와 대비됩니다.

rebate_value

Money

모든 세금 환급 금액입니다.

savings

SavingsOverTime

전체 기간 동안 절약되는 금액입니다.

payback_years

float

투자 회수가 발생할 때까지의 년 수입니다. 음수 값은 전체 기간 내에 투자 회수가 발생하지 않음을 의미합니다.

DataLayerView

반환할 태양 정보의 하위 집합입니다.

열거형
DATA_LAYER_VIEW_UNSPECIFIED FULL과 같습니다.
DSM_LAYER DSM만 받습니다.
IMAGERY_LAYERS DSM, RGB, 마스크를 가져옵니다.
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, 마스크, 연간 플럭스를 가져옵니다.
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, 마스크, 연간 플럭스, 월간 플럭스를 가져옵니다.
FULL_LAYERS 모든 데이터를 가져옵니다.

DataLayers

지역의 태양광 발전 가능성에 관한 정보입니다. 실제 데이터는 요청된 지역을 다루는 여러 GeoTIFF 파일에 포함되며 이 메시지에는 URL이 포함됩니다. DataLayers 메시지의 각 문자열에는 해당 GeoTIFF를 가져올 수 있는 URL이 포함됩니다. 이러한 URL은 생성된 후 몇 시간 동안 유효합니다. 대부분의 GeoTIFF 파일은 해상도가 0.1m/픽셀이지만 월간 플럭스 파일은 0.5m/픽셀이고 시간당 그늘 파일은 1m/픽셀입니다. GetDataLayersRequestpixel_size_meters 값이 지정된 경우 GeoTIFF 파일의 최소 해상도는 이 값이 됩니다.

필드
imagery_date

Date

이 지역의 소스 이미지 (다른 모든 데이터가 파생됨)가 촬영된 날짜입니다. 이미지가 2일 이상에 걸쳐 촬영되었을 수 있으므로 이 수치는 다소 근사치입니다.

imagery_processed_date

Date

이 이미지의 처리가 완료된 시간입니다.

dsm_url

string

해당 지역의 DSM (디지털 표면 모델) 이미지의 URL입니다. 값은 EGM96 지오이드 (해수면) 위의 미터입니다. 잘못된 위치 (데이터가 없는 위치)는 -9999로 저장됩니다.

rgb_url

string

해당 지역의 RGB 데이터 이미지 (항공 사진)의 URL입니다.

mask_url

string

건물 마스크 이미지의 URL입니다. 픽셀당 1비트로, 해당 픽셀이 옥상의 일부로 간주되는지 여부를 나타냅니다.

annual_flux_url

string

해당 지역의 연간 플럭스 지도 (지붕에 비치는 연간 일조량)의 URL입니다. 값은 kWh/kW/년입니다. 이는 마스크 해제된 플럭스입니다. 플럭스는 건물 옥상뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치는 -9999로 저장됩니다. 서비스 지역 외부의 위치는 잘못된 위치로 간주되며, 서비스 지역 내에서 플럭스를 계산할 수 없는 일부 위치도 잘못된 위치로 간주됩니다.

monthly_flux_url

string

해당 지역의 월별 플럭스 지도 (지붕에 비치는 일조량, 월별 분류)의 URL입니다. 값은 kWh/kW/년입니다. 이 URL이 가리키는 GeoTIFF에는 1월부터 12월까지 순서대로 12개의 밴드가 포함됩니다.

hourly_shade_urls[]

string

1월부터 12월까지 시간별 음영에 해당하는 12개의 URL입니다(순서대로). 각 GeoTIFF에는 하루 24시간에 해당하는 24개의 대역이 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 날짜, 해당 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다. 음수이므로 비트 31이 설정되며, 유효한 값은 비트 31을 설정할 수 없습니다 (32일째에 해당하기 때문).

예를 들어 보겠습니다. 6월 22일 오후 4시에 (픽셀 위치 (x, y)의) 지점에서 태양이 보였는지 확인하려면 다음을 실행합니다.

  1. 이 목록에서 여섯 번째 URL (6월에 해당)을 가져옵니다.
  2. 17번째 채널 (오후 4시)을 조회합니다.
  3. (x, y)에서 32비트 값을 읽습니다.
  4. 값의 비트 21 (월 22일에 해당)을 읽습니다.
  5. 이 비트가 1이면 해당 지점에서 6월 22일 오후 4시에 태양이 보였음을 의미합니다.

더 엄밀히 말하자면 month (1~12), day (1~최대 월, 2월은 28일), hour (0~23)가 주어질 때 (x, y) 위치의 해당 월/일/시간의 그늘/햇빛은 비트

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

여기서 (x, y)는 공간 색인 생성, [month - 1]month - 1번째 URL 가져오기 (0부터 색인 생성)를 나타내고, [hour]는 채널에 색인을 생성하며, 0이 아닌 최종 결과는 '맑음'을 의미합니다. 윤년은 없으며 일광 절약 시간은 없습니다 (모든 날이 24시간이며 정오가 항상 '표준시' 정오입니다).

imagery_quality

ImageryQuality

결과 이미지의 품질입니다.

FinancedPurchaseSavings

특정 전기 사용량으로 특정 구성의 태양광 패널을 구매하는 데 융자를 사용하는 비용과 이점

필드
annual_loan_payment

Money

연간 대출 상환액

rebate_value

Money

모든 세금 환급 금액 (연방 투자 세금 공제 (ITC) 포함)

loan_interest_rate

float

이 계산에서 가정된 대출 금리입니다.

savings

SavingsOverTime

전체 기간 동안 절약되는 금액입니다.

FinancialAnalysis

특정 전기 요금 규모에 적합한 태양광 배치의 비용과 이점을 분석합니다.

필드
monthly_bill

Money

이 분석에서 가정하는 월별 전기 요금입니다.

default_bill

bool

이 건물이 위치한 지역의 기본 청구서 크기로 선택된 청구서 크기입니다. BuildingSolarPotentialFinancialAnalysis 중 정확히 하나에 default_bill가 설정되어야 합니다.

average_kwh_per_month

float

청구서 금액과 현지 전기 요금을 기준으로 한 집에서 한 달에 평균적으로 사용하는 전기의 양입니다.

financial_details

FinancialDetails

사용한 파이낸싱 방법과 관계없이 적용되는 금융 정보입니다.

leasing_savings

LeasingSavings

태양광 패널 임대의 비용 및 이점

cash_purchase_savings

CashPurchaseSavings

현금으로 태양광 패널을 구매하는 비용과 이점

financed_purchase_savings

FinancedPurchaseSavings

구매 자금 조달을 통해 태양광 패널을 구매하는 데 드는 비용과 이점

panel_config_index

int32

이 청구서 크기에 적합한 최적의 태양광 레이아웃의 solar_panel_configs 색인입니다. 레이아웃이 없음을 나타내는 -1일 수 있습니다. 이 경우 나머지 하위 메시지는 생략됩니다.

FinancialDetails

재무 분석의 세부정보입니다. 이러한 세부정보 중 일부는 이미 상위 수준 (예: 본인 부담 비용)에 저장되어 있습니다. 총 금액은 SolarPotentialpanel_lifetime_years 필드에 의해 정의된 전체 기간 동안의 금액입니다. 참고: 패널 구매 시 지출한 비용은 CashPurchaseSavingsout_of_pocket_cost 필드에 표시됩니다.

필드
initial_ac_kwh_per_year

float

태양광 패널이 첫해에 생산할 것으로 예상되는 AC kWh입니다.

remaining_lifetime_utility_bill

Money

태양광으로 생산되지 않은 전기에 대한 공공요금(패널의 전체 기간 동안)

federal_incentive

Money

연방 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다.

state_incentive

Money

주 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다.

utility_incentive

Money

공공 서비스 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다.

lifetime_srec_total

Money

사용자가 패널의 전체 기간 동안 태양광 재생에너지 크레딧으로 받을 금액입니다. 이는 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다.

cost_of_electricity_without_solar

Money

사용자가 태양광을 설치하지 않은 경우 전체 기간 동안 지불했을 총 전기 요금입니다.

net_metering_allowed

bool

상계거래가 허용되는지 여부입니다.

solar_percentage

float

태양열로 공급되는 사용자 전원의 비율 (0~100)입니다. 첫해에는 유효하지만 향후 몇 년 동안은 대략적으로 정확합니다.

percentage_exported_to_grid

float

1분기 생산량을 기준으로 그리드로 수출되었다고 가정된 태양광 발전의 비율 (0~100%)입니다. 상계거래가 허용되지 않는 경우 계산에 영향을 미칩니다.

FindClosestBuildingInsightsRequest

Solar.FindClosestBuildingInsights에 대한 요청 메시지입니다.

필드
location

LatLng

필수입니다. API가 가장 가까운 알려진 건물을 찾는 위도 및 경도입니다.

required_quality

ImageryQuality

선택사항입니다. 결과에서 허용되는 최소 품질 수준입니다. 이보다 낮은 품질의 결과는 반환되지 않습니다. 이 옵션을 지정하지 않으면 HIGH 품질로만 제한하는 것과 같습니다.

GetDataLayersRequest

Solar.GetDataLayers에 대한 요청 메시지입니다.

필드
location

LatLng

필수입니다. 데이터를 가져올 지역 중심의 경도 및 위도입니다.

radius_meters

float

필수입니다. 데이터를 반환해야 하는 중심점을 둘러싼 영역을 정의하는 반경(미터)입니다. 이 값의 제한사항은 다음과 같습니다.

  • 최대 100m까지의 값을 언제든지 지정할 수 있습니다.
  • radius_meters <= pixel_size_meters * 1000인 경우 100m를 초과하는 값을 지정할 수 있습니다.
  • 하지만 175m를 초과하는 값의 경우 요청의 DataLayerView에 월간 플럭스 또는 시간당 음영이 포함되어서는 안 됩니다.
view

DataLayerView

선택사항입니다. 반환할 데이터의 원하는 하위 집합입니다.

required_quality

ImageryQuality

선택사항입니다. 결과에서 허용되는 최소 품질 수준입니다. 이보다 낮은 품질의 결과는 반환되지 않습니다. 이 옵션을 지정하지 않으면 HIGH 품질로만 제한하는 것과 같습니다.

pixel_size_meters

float

선택사항입니다. 반환할 데이터의 최소 배율(미터/픽셀)입니다. 0.1 (이 필드가 명시적으로 설정되지 않은 경우의 기본값), 0.25, 0.5, 1.0 값이 지원됩니다. 일반 해상도가 pixel_size_meters보다 작은 이미지 구성요소는 pixel_size_meters로 지정된 해상도로 반환됩니다. 일반 해상도가 pixel_size_meters보다 크거나 같은 이미지 구성요소는 해당 일반 해상도로 반환됩니다.

exact_quality_required

bool

선택사항입니다. 이미지의 정확한 품질이 필요한지 여부입니다. false로 설정하면 required_quality 필드는 필요한 최소 품질로 해석되므로 required_quality이 MEDIUM으로 설정된 경우 HIGH 품질 이미지가 반환될 수 있습니다. true로 설정하면 required_quality가 정확한 필수 품질로 해석되며 required_qualityMEDIUM로 설정된 경우 MEDIUM 품질 이미지만 반환됩니다.

GetGeoTiffRequest

Solar.GetGeoTiff에 대한 요청 메시지입니다.

필드
id

string

필수입니다. 요청된 저작물의 ID입니다.

ImageryQuality

일부 API 결과를 계산하는 데 사용되는 이미지의 품질입니다.

참고: 이미지 품질 수준과 관계없이 DSM 출력의 해상도는 항상 0.1m/픽셀이고, 월간 플럭스 출력의 해상도는 항상 0.5m/픽셀이며, 시간당 그늘 출력의 해상도는 항상 1m/픽셀입니다.

열거형
IMAGERY_QUALITY_UNSPECIFIED 알 수 없는 품질입니다.
HIGH 태양 데이터는 저고도에서 촬영된 항공 이미지에서 가져와 0.1m/픽셀로 처리됩니다.
MEDIUM 태양 데이터는 높은 고도에서 촬영된 향상된 항공 이미지에서 가져와 0.25m/픽셀로 처리됩니다.
LOW 태양광 데이터는 0.25m/픽셀로 처리된 향상된 위성 이미지에서 가져옵니다.
BASE 태양광 데이터는 0.25m/픽셀로 처리된 향상된 위성 이미지에서 가져옵니다.

LatLngBox

위도/경도 좌표의 경계 상자입니다.

필드
sw

LatLng

상자의 남서쪽 모서리입니다.

ne

LatLng

상자의 북동쪽 모서리입니다.

LeasingSavings

특정 전기 사용량으로 특정 구성의 태양광 패널을 임대하는 데 드는 비용과 이점

필드
leases_allowed

bool

이 관할권에서 임대가 허용되는지 여부 (일부 주에서는 임대가 허용되지 않음). 이 필드가 false인 경우 이 메시지의 값은 무시해야 할 가능성이 높습니다.

leases_supported

bool

이 관할권에서 금융 계산 엔진이 임대를 지원하는지 여부입니다. 이 필드가 false인 경우 이 메시지의 값은 무시해야 할 가능성이 높습니다. 이는 leases_allowed와는 무관합니다. 일부 지역에서는 임대가 허용되지만 재무 모델에서 처리하지 않는 조건이 적용됩니다.

annual_leasing_cost

Money

예상 연간 임대료입니다.

savings

SavingsOverTime

전체 기간 동안 절약되는 금액입니다.

RoofSegmentSizeAndSunshineStats

지붕 세그먼트의 크기 및 일조량 분위수에 관한 정보입니다.

필드
stats

SizeAndSunshineStats

지붕 구간의 총 크기 및 일조량 분위수입니다.

center

LatLng

지붕 구간의 중앙 근처에 있는 점입니다.

bounding_box

LatLngBox

지붕 구간의 경계 상자입니다.

pitch_degrees

float

이론적 지상 평면을 기준으로 한 지붕 세그먼트의 각도입니다. 0 = 지면과 평행, 90 = 지면과 수직

azimuth_degrees

float

지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북, 90 = 동, 180 = 남 '평평한' 지붕 세그먼트 (pitch_degrees가 0에 매우 근접함)의 경우 방위각이 잘 정의되어 있지 않으므로 일관성을 위해 임의로 0 (북쪽)으로 정의합니다.

plane_height_at_center_meters

float

center로 지정된 지점에서 지붕 세그먼트 평면의 높이(해발 미터)입니다. 이 값은 피치, 방위각, 중심 위치와 함께 지붕 세그먼트 평면을 완전히 정의합니다.

RoofSegmentSummary

건물의 지붕 세그먼트에 관한 정보로, 지붕에 패널이 여러 개 배치되어 있습니다.

필드
panels_count

int32

이 세그먼트의 총 패널 수입니다.

yearly_energy_dc_kwh

float

위에 설명된 패널을 가정할 때 레이아웃의 이 부분이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다.

pitch_degrees

float

이론적 지상 평면을 기준으로 한 지붕 세그먼트의 각도입니다. 0 = 지면과 평행, 90 = 지면과 수직

azimuth_degrees

float

지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북, 90 = 동, 180 = 남 '평평한' 지붕 세그먼트 (pitch_degrees가 0에 매우 근접함)의 경우 방위각이 잘 정의되어 있지 않으므로 일관성을 위해 임의로 0 (북쪽)으로 정의합니다.

segment_index

int32

해당 RoofSegmentSizeAndSunshineStatsroof_segment_stats 색인입니다.

SavingsOverTime

다양한 파이낸싱 방법 간에 공유되는 금융 정보

필드
savings_year1

Money

패널 설치 후 첫해에 발생한 절감액입니다.

savings_year20

Money

패널 설치 후 처음 20년 동안의 절약액입니다.

present_value_of_savings_year20

Money

가정된 할인율을 사용하면 20년간 누적된 절감액의 현재 가치는 얼마인가요?

savings_lifetime

Money

전체 패널 수명 주기 동안의 절감액입니다.

present_value_of_savings_lifetime

Money

가정된 할인율을 사용하면 누적 전체 기간 절감액의 현재 가치는 얼마인가요?

financially_viable

bool

이 시나리오가 재무적으로 실행 가능한지 여부를 나타냅니다. 재정 건정성이 좋지 않은 시나리오 (예: 손실 발생)에서는 false입니다.

SizeAndSunshineStats

지붕 또는 지붕 일부의 크기 및 일조량 분위수입니다.

필드
area_meters2

float

지붕 또는 지붕 세그먼트의 면적(m^2)입니다. 지상 면적은 아니며 지붕 면적 (경사 고려)입니다.

sunshine_quantiles[]

float

지역 전체의 지점별 일조량 값의 중앙값입니다. 여기에 N개의 값이 있으면 (N-1)-iles을 나타냅니다. 예를 들어 값이 5개인 경우 값은 분위수 (최솟값, 25%, 50%, 75%, 최대값)입니다. 값은 max_sunshine_hours_per_year와 같이 연간 kWh/kW 단위로 표시됩니다.

ground_area_meters2

float

지붕 또는 지붕 세그먼트가 차지하는 지상 면적(m^2)입니다.

SolarPanel

SolarPanel은 단일 태양광 패널의 위치, 방향, 생산량을 설명합니다. 패널의 매개변수에 관한 자세한 내용은 SolarPotentialpanel_height_meters, panel_width_meters, panel_capacity_watts 필드를 참고하세요.

필드
center

LatLng

패널의 중앙

orientation

SolarPanelOrientation

패널의 방향입니다.

yearly_energy_dc_kwh

float

이 레이아웃이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다.

segment_index

int32

이 패널이 배치된 지붕 세그먼트에 해당하는 RoofSegmentSizeAndSunshineStatsroof_segment_stats 색인입니다.

SolarPanelConfig

SolarPanelConfig는 지붕에 태양광 패널을 배치하는 특정 방법을 설명합니다.

필드
panels_count

int32

총 패널 수입니다. 이는 roof_segment_summaries의 해당 필드 (합계)와 중복됩니다.

yearly_energy_dc_kwh

float

위에서 설명한 패널을 가정할 때 이 레이아웃이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다.

roof_segment_summaries[]

RoofSegmentSummary

이 레이아웃에서 패널을 1개 이상 탑재하는 각 지붕 구간의 제작에 관한 정보입니다. roof_segment_summaries[i]는 크기, 예상 생산량, 방향을 포함하여 i번째 지붕 세그먼트를 나타냅니다.

SolarPanelOrientation

태양광 패널의 방향입니다. 이는 패널이 배치된 지붕 세그먼트의 방위각을 기준으로 해석해야 합니다.

열거형
SOLAR_PANEL_ORIENTATION_UNSPECIFIED 알려진 패널 방향이 없습니다.
LANDSCAPE LANDSCAPE 패널의 긴 모서리는 패널이 배치된 지붕 세그먼트의 방위각 방향에 수직입니다.
PORTRAIT PORTRAIT 패널의 긴 모서리는 패널이 배치된 지붕 세그먼트의 방위각 방향과 평행합니다.

SolarPotential

건물의 태양광 발전 가능성에 관한 정보입니다. 여기의 여러 필드는 '패널'이라는 용어로 정의됩니다. panel_capacity_watts, panel_height_meters, panel_width_meters 필드는 이러한 계산에 사용되는 패널 모델의 매개변수를 설명합니다.

필드
max_array_panels_count

int32

최대 배열 크기: 지붕에 장착할 수 있는 최대 패널 수입니다.

panel_capacity_watts

float

계산에 사용된 패널의 용량(와트)입니다.

panel_height_meters

float

계산에 사용된 패널의 높이(세로 모드 방향, 미터)입니다.

panel_width_meters

float

계산에 사용된 패널의 너비(세로 방향, 미터)입니다.

panel_lifetime_years

int32

태양광 패널의 예상 수명(년)입니다. 이는 재무 계산에 사용됩니다.

max_array_area_meters2

float

최대 배열의 크기(m2)입니다.

max_sunshine_hours_per_year

float

옥상의 모든 지점에서 연간 최대 일조량입니다. 일조량은 연간 수신되는 총 일조량 (에너지)을 측정한 값입니다. 일조 시간 1시간 = kW당 1kWh (여기서 kW는 표준 테스트 조건에서의 용량을 나타냄)

carbon_offset_factor_kg_per_mwh

float

그리드 전기 1MWh당 발생하는 CO2의 양입니다. 태양광 전력으로 대체된 전력망 전기의 탄소 집약도를 나타냅니다.

whole_roof_stats

SizeAndSunshineStats

일부 지붕 구간에 할당된 지붕 부분의 총 크기 및 일조량 분위수입니다. 이름과 달리 건물 전체가 포함되지 않을 수도 있습니다. building_stats를 참조하세요.

building_stats

SizeAndSunshineStats

일부 지붕 구간에 할당되지 않은 지붕 부분을 포함하여 전체 건물의 크기 및 일조량 분위수입니다. 이러한 부분의 방향은 잘 특성화되지 않으므로 지붕 면적 추정치는 신뢰할 수 없지만 지상 면적 추정치는 신뢰할 수 있습니다. whole_roof_stats의 지붕 면적을 building_statswhole_roof_stats의 지상 면적 비율로 조정하여 더 신뢰할 수 있는 전체 건물 지붕 면적을 얻을 수 있습니다.

roof_segment_stats[]

RoofSegmentSizeAndSunshineStats

각 지붕 세그먼트의 크기 및 일조량 분위수입니다.

solar_panels[]

SolarPanel

SolarPanel는 단일 태양광 패널을 나타냅니다. 패널 레이아웃 알고리즘이 배치한 순서대로 나열됩니다. 일반적으로 연간 에너지 생산량이 감소하는 순서로 표시되지만 항상 그런 것은 아닙니다.

solar_panel_configs[]

SolarPanelConfig

SolarPanelConfig는 지붕에 설치된 태양광 패널의 다양한 배열을 나타냅니다. 패널 수가 증가하는 순으로 표시됩니다. panels_count=N인 SolarPanelConfigsolar_panels 목록의 첫 번째 N개 패널을 기반으로 합니다. 이 필드는 지붕에 패널 4개 이상을 설치할 수 있는 경우에만 채워집니다.

financial_analyses[]

FinancialAnalysis

FinancialAnalysis는 지정된 월별 청구서와 지정된 전기 공급자를 가정하여 태양광으로 전환할 때의 절약액을 나타냅니다. 월별 청구 금액의 증가 순으로 표시됩니다. Solar API에 재무 계산을 실행하기에 충분한 정보가 없는 지역의 건물의 경우 이 필드는 비어 있습니다.