색인
Solar
(인터페이스)BuildingInsights
(메시지)CashPurchaseSavings
(메시지)DataLayerView
(열거형)DataLayers
(메시지)FinancedPurchaseSavings
(메시지)FinancialAnalysis
(메시지)FinancialDetails
(메시지)FindClosestBuildingInsightsRequest
(메시지)GetDataLayersRequest
(메시지)GetGeoTiffRequest
(메시지)ImageryQuality
(열거형)LatLngBox
(메시지)LeasingSavings
(메시지)RoofSegmentSizeAndSunshineStats
(메시지)RoofSegmentSummary
(메시지)SavingsOverTime
(메시지)SizeAndSunshineStats
(메시지)SolarPanel
(메시지)SolarPanelConfig
(메시지)SolarPanelOrientation
(열거형)SolarPotential
(메시지)
태양광
Solar API의 서비스 정의입니다.
FindClosestBuildingInsights |
---|
중심점이 쿼리 지점에 가장 가까운 건물을 찾습니다. 쿼리 지점으로부터 약 50m 이내에 건물이 없으면 코드
|
GetDataLayers |
---|
위치 주변 지역의 태양광 정보를 가져옵니다. 위치가 서비스 지역 외부에 있는 경우 코드
|
GetGeoTiff |
---|
ID별로 이미지를 반환합니다.
|
BuildingInsights
Solar.FindClosestBuildingInsights
의 응답 메시지입니다. 건물의 위치, 크기, 태양광 발전 가능성에 관한 정보입니다.
필드 | |
---|---|
name |
건물의 리소스 이름으로, |
center |
건물 중앙 근처의 지점 |
bounding_box |
건물의 경계 상자입니다. |
imagery_date |
기본 이미지가 획득된 날짜입니다. 이는 대략적인 수치입니다. |
imagery_processed_date |
이 이미지의 처리가 완료된 시간입니다. |
postal_code |
우편번호 (예: 미국 우편번호)를 포함합니다. |
administrative_area |
이 건물이 있는 행정 구역 1 (예: 미국의 경우 주)입니다. 예를 들어 미국에서는 'MA' 또는 'CA'가 약어일 수 있습니다. |
statistical_area |
통계 지역 (예: 건물이 위치한 미국 인구조사 구역)을 입력합니다. |
region_code |
건물이 있는 국가 (또는 지역)의 지역 코드입니다. |
solar_potential |
건물의 태양광 잠재 발전량 |
imagery_quality |
이 건물의 데이터를 계산하는 데 사용된 이미지의 품질입니다. |
CashPurchaseSavings
특정 전기 사용량으로 특정 구성의 태양광 패널을 일괄 구매할 때의 비용과 이점
필드 | |
---|---|
out_of_pocket_cost |
세금 인센티브 전 초기 비용: 본인이 직접 지불해야 하는 금액입니다. 세금 인센티브를 적용한 |
upfront_cost |
세금 인센티브 후 초기 비용: 첫해에 지불해야 하는 금액입니다. 세금 인센티브 이전의 |
rebate_value |
모든 세금 환급 금액입니다. |
savings |
전체 기간 동안 절약되는 금액입니다. |
payback_years |
투자 회수가 발생할 때까지의 년 수입니다. 음수 값은 전체 기간 내에 투자 회수가 발생하지 않음을 의미합니다. |
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/픽셀입니다. GetDataLayersRequest
에 pixel_size_meters
값이 지정된 경우 GeoTIFF 파일의 최소 해상도는 이 값이 됩니다.
필드 | |
---|---|
imagery_date |
이 지역의 소스 이미지 (다른 모든 데이터가 파생됨)가 촬영된 날짜입니다. 이미지가 2일 이상에 걸쳐 촬영되었을 수 있으므로 이 수치는 다소 근사치입니다. |
imagery_processed_date |
이 이미지의 처리가 완료된 시간입니다. |
dsm_url |
해당 지역의 DSM (디지털 표면 모델) 이미지의 URL입니다. 값은 EGM96 지오이드 (해수면) 위의 미터입니다. 잘못된 위치 (데이터가 없는 위치)는 -9999로 저장됩니다. |
rgb_url |
해당 지역의 RGB 데이터 이미지 (항공 사진)의 URL입니다. |
mask_url |
건물 마스크 이미지의 URL입니다. 픽셀당 1비트로, 해당 픽셀이 옥상의 일부로 간주되는지 여부를 나타냅니다. |
annual_flux_url |
해당 지역의 연간 플럭스 지도 (지붕에 비치는 연간 일조량)의 URL입니다. 값은 kWh/kW/년입니다. 이는 마스크 해제된 플럭스입니다. 플럭스는 건물 옥상뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치는 -9999로 저장됩니다. 서비스 지역 외부의 위치는 잘못된 위치로 간주되며, 서비스 지역 내에서 플럭스를 계산할 수 없는 일부 위치도 잘못된 위치로 간주됩니다. |
monthly_flux_url |
해당 지역의 월별 플럭스 지도 (지붕에 비치는 일조량, 월별 분류)의 URL입니다. 값은 kWh/kW/년입니다. 이 URL이 가리키는 GeoTIFF에는 1월부터 12월까지 순서대로 12개의 밴드가 포함됩니다. |
hourly_shade_urls[] |
1월부터 12월까지 시간별 음영에 해당하는 12개의 URL입니다(순서대로). 각 GeoTIFF에는 하루 24시간에 해당하는 24개의 대역이 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 날짜, 해당 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다. 음수이므로 비트 31이 설정되며, 유효한 값은 비트 31을 설정할 수 없습니다 (32일째에 해당하기 때문). 예를 들어 보겠습니다. 6월 22일 오후 4시에 (픽셀 위치 (x, y)의) 지점에서 태양이 보였는지 확인하려면 다음을 실행합니다.
더 엄밀히 말하자면
여기서 |
imagery_quality |
결과 이미지의 품질입니다. |
FinancedPurchaseSavings
특정 전기 사용량으로 특정 구성의 태양광 패널을 구매하는 데 융자를 사용하는 비용과 이점
필드 | |
---|---|
annual_loan_payment |
연간 대출 상환액 |
rebate_value |
모든 세금 환급 금액 (연방 투자 세금 공제 (ITC) 포함) |
loan_interest_rate |
이 계산에서 가정된 대출 금리입니다. |
savings |
전체 기간 동안 절약되는 금액입니다. |
FinancialAnalysis
특정 전기 요금 규모에 적합한 태양광 배치의 비용과 이점을 분석합니다.
필드 | |
---|---|
monthly_bill |
이 분석에서 가정하는 월별 전기 요금입니다. |
default_bill |
이 건물이 위치한 지역의 기본 청구서 크기로 선택된 청구서 크기입니다. |
average_kwh_per_month |
청구서 금액과 현지 전기 요금을 기준으로 한 집에서 한 달에 평균적으로 사용하는 전기의 양입니다. |
financial_details |
사용한 파이낸싱 방법과 관계없이 적용되는 금융 정보입니다. |
leasing_savings |
태양광 패널 임대의 비용 및 이점 |
cash_purchase_savings |
현금으로 태양광 패널을 구매하는 비용과 이점 |
financed_purchase_savings |
구매 자금 조달을 통해 태양광 패널을 구매하는 데 드는 비용과 이점 |
panel_config_index |
이 청구서 크기에 적합한 최적의 태양광 레이아웃의 |
FinancialDetails
재무 분석의 세부정보입니다. 이러한 세부정보 중 일부는 이미 상위 수준 (예: 본인 부담 비용)에 저장되어 있습니다. 총 금액은 SolarPotential
의 panel_lifetime_years
필드에 의해 정의된 전체 기간 동안의 금액입니다. 참고: 패널 구매 시 지출한 비용은 CashPurchaseSavings
의 out_of_pocket_cost
필드에 표시됩니다.
필드 | |
---|---|
initial_ac_kwh_per_year |
태양광 패널이 첫해에 생산할 것으로 예상되는 AC kWh입니다. |
remaining_lifetime_utility_bill |
태양광으로 생산되지 않은 전기에 대한 공공요금(패널의 전체 기간 동안) |
federal_incentive |
연방 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다. |
state_incentive |
주 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다. |
utility_incentive |
공공 서비스 인센티브에서 사용할 수 있는 금액입니다. 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다. |
lifetime_srec_total |
사용자가 패널의 전체 기간 동안 태양광 재생에너지 크레딧으로 받을 금액입니다. 이는 사용자가 대출 유무와 관계없이 패널을 구매하는 경우에 적용됩니다. |
cost_of_electricity_without_solar |
사용자가 태양광을 설치하지 않은 경우 전체 기간 동안 지불했을 총 전기 요금입니다. |
net_metering_allowed |
상계거래가 허용되는지 여부입니다. |
solar_percentage |
태양열로 공급되는 사용자 전원의 비율 (0~100)입니다. 첫해에는 유효하지만 향후 몇 년 동안은 대략적으로 정확합니다. |
percentage_exported_to_grid |
1분기 생산량을 기준으로 그리드로 수출되었다고 가정된 태양광 발전의 비율 (0~100%)입니다. 상계거래가 허용되지 않는 경우 계산에 영향을 미칩니다. |
FindClosestBuildingInsightsRequest
Solar.FindClosestBuildingInsights
에 대한 요청 메시지입니다.
필드 | |
---|---|
location |
필수입니다. API가 가장 가까운 알려진 건물을 찾는 위도 및 경도입니다. |
required_quality |
선택사항입니다. 결과에서 허용되는 최소 품질 수준입니다. 이보다 낮은 품질의 결과는 반환되지 않습니다. 이 옵션을 지정하지 않으면 HIGH 품질로만 제한하는 것과 같습니다. |
GetDataLayersRequest
Solar.GetDataLayers
에 대한 요청 메시지입니다.
필드 | |
---|---|
location |
필수입니다. 데이터를 가져올 지역 중심의 경도 및 위도입니다. |
radius_meters |
필수입니다. 데이터를 반환해야 하는 중심점을 둘러싼 영역을 정의하는 반경(미터)입니다. 이 값의 제한사항은 다음과 같습니다.
|
view |
선택사항입니다. 반환할 데이터의 원하는 하위 집합입니다. |
required_quality |
선택사항입니다. 결과에서 허용되는 최소 품질 수준입니다. 이보다 낮은 품질의 결과는 반환되지 않습니다. 이 옵션을 지정하지 않으면 HIGH 품질로만 제한하는 것과 같습니다. |
pixel_size_meters |
선택사항입니다. 반환할 데이터의 최소 배율(미터/픽셀)입니다. 0.1 (이 필드가 명시적으로 설정되지 않은 경우의 기본값), 0.25, 0.5, 1.0 값이 지원됩니다. 일반 해상도가 |
exact_quality_required |
선택사항입니다. 이미지의 정확한 품질이 필요한지 여부입니다. false로 설정하면 |
GetGeoTiffRequest
Solar.GetGeoTiff
에 대한 요청 메시지입니다.
필드 | |
---|---|
id |
필수입니다. 요청된 저작물의 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
위도/경도 좌표의 경계 상자입니다.
LeasingSavings
특정 전기 사용량으로 특정 구성의 태양광 패널을 임대하는 데 드는 비용과 이점
필드 | |
---|---|
leases_allowed |
이 관할권에서 임대가 허용되는지 여부 (일부 주에서는 임대가 허용되지 않음). 이 필드가 false인 경우 이 메시지의 값은 무시해야 할 가능성이 높습니다. |
leases_supported |
이 관할권에서 금융 계산 엔진이 임대를 지원하는지 여부입니다. 이 필드가 false인 경우 이 메시지의 값은 무시해야 할 가능성이 높습니다. 이는 |
annual_leasing_cost |
예상 연간 임대료입니다. |
savings |
전체 기간 동안 절약되는 금액입니다. |
RoofSegmentSizeAndSunshineStats
지붕 세그먼트의 크기 및 일조량 분위수에 관한 정보입니다.
필드 | |
---|---|
stats |
지붕 구간의 총 크기 및 일조량 분위수입니다. |
center |
지붕 구간의 중앙 근처에 있는 점입니다. |
bounding_box |
지붕 구간의 경계 상자입니다. |
pitch_degrees |
이론적 지상 평면을 기준으로 한 지붕 세그먼트의 각도입니다. 0 = 지면과 평행, 90 = 지면과 수직 |
azimuth_degrees |
지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북, 90 = 동, 180 = 남 '평평한' 지붕 세그먼트 ( |
plane_height_at_center_meters |
|
RoofSegmentSummary
건물의 지붕 세그먼트에 관한 정보로, 지붕에 패널이 여러 개 배치되어 있습니다.
필드 | |
---|---|
panels_count |
이 세그먼트의 총 패널 수입니다. |
yearly_energy_dc_kwh |
위에 설명된 패널을 가정할 때 레이아웃의 이 부분이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다. |
pitch_degrees |
이론적 지상 평면을 기준으로 한 지붕 세그먼트의 각도입니다. 0 = 지면과 평행, 90 = 지면과 수직 |
azimuth_degrees |
지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북, 90 = 동, 180 = 남 '평평한' 지붕 세그먼트 ( |
segment_index |
해당 |
SavingsOverTime
다양한 파이낸싱 방법 간에 공유되는 금융 정보
필드 | |
---|---|
savings_year1 |
패널 설치 후 첫해에 발생한 절감액입니다. |
savings_year20 |
패널 설치 후 처음 20년 동안의 절약액입니다. |
present_value_of_savings_year20 |
가정된 할인율을 사용하면 20년간 누적된 절감액의 현재 가치는 얼마인가요? |
savings_lifetime |
전체 패널 수명 주기 동안의 절감액입니다. |
present_value_of_savings_lifetime |
가정된 할인율을 사용하면 누적 전체 기간 절감액의 현재 가치는 얼마인가요? |
financially_viable |
이 시나리오가 재무적으로 실행 가능한지 여부를 나타냅니다. 재정 건정성이 좋지 않은 시나리오 (예: 손실 발생)에서는 false입니다. |
SizeAndSunshineStats
지붕 또는 지붕 일부의 크기 및 일조량 분위수입니다.
필드 | |
---|---|
area_meters2 |
지붕 또는 지붕 세그먼트의 면적(m^2)입니다. 지상 면적은 아니며 지붕 면적 (경사 고려)입니다. |
sunshine_quantiles[] |
지역 전체의 지점별 일조량 값의 중앙값입니다. 여기에 N개의 값이 있으면 (N-1)-iles을 나타냅니다. 예를 들어 값이 5개인 경우 값은 분위수 (최솟값, 25%, 50%, 75%, 최대값)입니다. 값은 |
ground_area_meters2 |
지붕 또는 지붕 세그먼트가 차지하는 지상 면적(m^2)입니다. |
SolarPanel
SolarPanel은 단일 태양광 패널의 위치, 방향, 생산량을 설명합니다. 패널의 매개변수에 관한 자세한 내용은 SolarPotential
의 panel_height_meters
, panel_width_meters
, panel_capacity_watts
필드를 참고하세요.
필드 | |
---|---|
center |
패널의 중앙 |
orientation |
패널의 방향입니다. |
yearly_energy_dc_kwh |
이 레이아웃이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다. |
segment_index |
이 패널이 배치된 지붕 세그먼트에 해당하는 |
SolarPanelConfig
SolarPanelConfig는 지붕에 태양광 패널을 배치하는 특정 방법을 설명합니다.
필드 | |
---|---|
panels_count |
총 패널 수입니다. 이는 |
yearly_energy_dc_kwh |
위에서 설명한 패널을 가정할 때 이 레이아웃이 1년 동안 캡처하는 태양광 에너지(DC kWh)입니다. |
roof_segment_summaries[] |
이 레이아웃에서 패널을 1개 이상 탑재하는 각 지붕 구간의 제작에 관한 정보입니다. |
SolarPanelOrientation
태양광 패널의 방향입니다. 이는 패널이 배치된 지붕 세그먼트의 방위각을 기준으로 해석해야 합니다.
열거형 | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
알려진 패널 방향이 없습니다. |
LANDSCAPE |
LANDSCAPE 패널의 긴 모서리는 패널이 배치된 지붕 세그먼트의 방위각 방향에 수직입니다. |
PORTRAIT |
PORTRAIT 패널의 긴 모서리는 패널이 배치된 지붕 세그먼트의 방위각 방향과 평행합니다. |
SolarPotential
건물의 태양광 발전 가능성에 관한 정보입니다. 여기의 여러 필드는 '패널'이라는 용어로 정의됩니다. panel_capacity_watts
, panel_height_meters
, panel_width_meters
필드는 이러한 계산에 사용되는 패널 모델의 매개변수를 설명합니다.
필드 | |
---|---|
max_array_panels_count |
최대 배열 크기: 지붕에 장착할 수 있는 최대 패널 수입니다. |
panel_capacity_watts |
계산에 사용된 패널의 용량(와트)입니다. |
panel_height_meters |
계산에 사용된 패널의 높이(세로 모드 방향, 미터)입니다. |
panel_width_meters |
계산에 사용된 패널의 너비(세로 방향, 미터)입니다. |
panel_lifetime_years |
태양광 패널의 예상 수명(년)입니다. 이는 재무 계산에 사용됩니다. |
max_array_area_meters2 |
최대 배열의 크기(m2)입니다. |
max_sunshine_hours_per_year |
옥상의 모든 지점에서 연간 최대 일조량입니다. 일조량은 연간 수신되는 총 일조량 (에너지)을 측정한 값입니다. 일조 시간 1시간 = kW당 1kWh (여기서 kW는 표준 테스트 조건에서의 용량을 나타냄) |
carbon_offset_factor_kg_per_mwh |
그리드 전기 1MWh당 발생하는 CO2의 양입니다. 태양광 전력으로 대체된 전력망 전기의 탄소 집약도를 나타냅니다. |
whole_roof_stats |
일부 지붕 구간에 할당된 지붕 부분의 총 크기 및 일조량 분위수입니다. 이름과 달리 건물 전체가 포함되지 않을 수도 있습니다. |
building_stats |
일부 지붕 구간에 할당되지 않은 지붕 부분을 포함하여 전체 건물의 크기 및 일조량 분위수입니다. 이러한 부분의 방향은 잘 특성화되지 않으므로 지붕 면적 추정치는 신뢰할 수 없지만 지상 면적 추정치는 신뢰할 수 있습니다. |
roof_segment_stats[] |
각 지붕 세그먼트의 크기 및 일조량 분위수입니다. |
solar_panels[] |
각 |
solar_panel_configs[] |
각 |
financial_analyses[] |
|