Package google.maps.solar.v1

ดัชนี

• Solar (อินเทอร์เฟซ)
• BuildingInsights (ข้อความ)
• CashPurchaseSavings (ข้อความ)
• DataLayerView (enum)
• DataLayers (ข้อความ)
• FinancedPurchaseSavings (ข้อความ)
• FinancialAnalysis (ข้อความ)
• FinancialDetails (ข้อความ)
• FindClosestBuildingInsightsRequest (ข้อความ)
• GetDataLayersRequest (ข้อความ)
• GetGeoTiffRequest (ข้อความ)
• ImageryQuality (enum)
• LatLngBox (ข้อความ)
• LeasingSavings (ข้อความ)
• RoofSegmentSizeAndSunshineStats (ข้อความ)
• RoofSegmentSummary (ข้อความ)
• SavingsOverTime (ข้อความ)
• SizeAndSunshineStats (ข้อความ)
• SolarPanel (ข้อความ)
• SolarPanelConfig (ข้อความ)
• SolarPanelOrientation (enum)
• SolarPotential (ข้อความ)

พลังงานแสงอาทิตย์

คําจํากัดความของบริการสําหรับ Solar API

FindClosestBuildingInsights
rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights) ค้นหาอาคารที่มีจุดศูนย์กลางอยู่ใกล้กับจุดค้นหามากที่สุด แสดงข้อผิดพลาดที่มีรหัส NOT_FOUND หากไม่มีอาคารภายในระยะประมาณ 50 เมตรจากจุดค้นหา ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต 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) แสดงผลรูปภาพตามรหัส ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต 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

ชุดข้อมูลย่อยของข้อมูลดวงอาทิตย์ที่จะแสดง

Enum
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 มี URL ที่ใช้ดึงข้อมูล GeoTIFF ที่เกี่ยวข้องได้ URL เหล่านี้จะใช้งานได้เป็นเวลา 2-3 ชั่วโมงหลังจากสร้าง ไฟล์ GeoTIFF ส่วนใหญ่มีความละเอียด 0.1 ม./พิกเซล แต่ไฟล์การแผ่รังสีรายเดือนมีความละเอียด 0.5 ม./พิกเซล และไฟล์เงารายชั่วโมงมีความละเอียด 1 ม./พิกเซล หากระบุค่า pixel_size_meters ใน GetDataLayersRequest ความละเอียดขั้นต่ำในไฟล์ GeoTIFF จะเป็นค่านั้น

ช่อง
imagery_date	Date เวลาที่ถ่ายภาพต้นฉบับ (ซึ่งเป็นแหล่งที่มาของข้อมูลอื่นๆ ทั้งหมด) ในภูมิภาคนี้ ข้อมูลนี้เป็นเพียงค่าโดยประมาณเนื่องจากรูปภาพอาจถ่ายทำในช่วงเวลามากกว่า 1 วัน
imagery_processed_date	Date เมื่อประมวลผลภาพนี้เสร็จแล้ว
dsm_url	string URL ของรูปภาพ DSM (Digital Surface Model) ของภูมิภาค ค่าเป็นเมตรเหนือระดับน้ำทะเลตามรูปแบบ EGM96 (ระดับน้ำทะเล) ระบบจะจัดเก็บสถานที่ที่ไม่ถูกต้อง (ที่เราไม่มีข้อมูล) เป็น -9999
rgb_url	string URL ของรูปภาพข้อมูล RGB (ภาพถ่ายทางอากาศ) ของภูมิภาค
mask_url	string URL ของภาพมาสก์อาคาร: 1 บิตต่อพิกเซลที่ระบุว่าระบบถือว่าพิกเซลนั้นเป็นส่วนหนึ่งของหลังคาหรือไม่
annual_flux_url	string URL ของแผนที่ฟลักซ์รายปี (แสงแดดบนหลังคารายปี) ของภูมิภาค ค่าคือ kWh/kW/ปี นี่คือฟลักซ์ที่ไม่มีการปกปิด: ระบบจะคํานวณฟลักซ์สําหรับทุกตําแหน่ง ไม่ใช่แค่บนหลังคาอาคาร ระบบจะจัดเก็บตำแหน่งที่ไม่ถูกต้องเป็น -9999: ตำแหน่งที่อยู่นอกพื้นที่ให้บริการของเราจะเป็นค่าที่ไม่ถูกต้อง และบางตำแหน่งภายในพื้นที่ให้บริการที่เราคำนวณฟลักซ์ไม่ได้ก็จะเป็นค่าที่ไม่ถูกต้องเช่นกัน
monthly_flux_url	string URL สำหรับแผนที่การแผ่รังสีรายเดือน (แสงแดดส่องบนหลังคา โดยแยกตามเดือน) ของภูมิภาค ค่าคือ kWh/kW/ปี GeoTIFF ที่ URL นี้ชี้จะมีแถบ 12 แถบ ซึ่งสอดคล้องกับเดือนมกราคม...ธันวาคมตามลำดับ
hourly_shade_urls[]	string URL 12 รายการสำหรับแสงแดดรายชั่วโมง ซึ่งตรงกับเดือนมกราคม...ธันวาคมตามลำดับ GeoTIFF แต่ละไฟล์จะมี 24 ย่านความถี่ ซึ่งสอดคล้องกับ 24 ชั่วโมงของวัน พิกเซลแต่ละพิกเซลคือจำนวนเต็ม 32 บิต ซึ่งสอดคล้องกับ (สูงสุด) 31 วันของเดือนนั้นๆ โดย 1 บิตหมายความว่าสถานที่ที่เกี่ยวข้องสามารถมองเห็นดวงอาทิตย์ในวันนั้นๆ ของชั่วโมงนั้นๆ ของเดือนนั้นๆ ระบบจะจัดเก็บสถานที่ที่ไม่ถูกต้องเป็น -9999 (เนื่องจากค่านี้เป็นค่าลบ จึงมีการตั้งค่าบิต 31 และค่าที่ถูกต้องจะไม่มีการตั้งค่าบิต 31 เนื่องจากจะตรงกับวันที่ 32 ของเดือน) ตัวอย่างอาจมีประโยชน์ หากต้องการทราบว่าจุดหนึ่งๆ (ที่ตำแหน่งพิกเซล (x, y)) เห็นดวงอาทิตย์ตอน 16:00 น. ของวันที่ 22 มิถุนายนหรือไม่ คุณจะทำดังนี้ ดึงข้อมูล URL ที่ 6 ในรายการนี้ (สอดคล้องกับเดือนมิถุนายน) ค้นหาช่องที่ 17 (ตรงกับเวลา 16:00 น.) อ่านค่า 32 บิตที่ (x, y) อ่านบิตที่ 21 ของค่า (ซึ่งสอดคล้องกับวันที่ 22 ของเดือน) หากบิตนั้นเป็น 1 แสดงว่าจุดนั้นเห็นดวงอาทิตย์ตอน 16:00 น. ของวันที่ 22 มิถุนายน ในรูปแบบทางการมากขึ้น: เมื่อทราบ month (1-12), day (1...เดือนสูงสุด; กุมภาพันธ์มี 28 วัน) และ hour (0-23) ร่มเงา/แดดของเดือน/วัน/ชั่วโมงนั้นๆ ในตําแหน่ง (x, y) คือบิต (hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1)) โดยที่ (x, y) คือการจัดทําดัชนีเชิงพื้นที่, [month - 1] หมายถึงการดึงข้อมูล URL month - 1 รายการแรก (การจัดทําดัชนีจาก 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 เลือกขนาดการเรียกเก็บเงินนี้เป็นค่าเริ่มต้นสำหรับการเรียกเก็บเงินในพื้นที่ที่มีอาคารนี้หรือไม่ FinancialAnalysis ใน BuildingSolarPotential ควรมีการตั้งค่า default_bill เพียง 1 รายการเท่านั้น
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

รายละเอียดการวิเคราะห์ทางการเงิน รายละเอียดบางอย่างเหล่านี้จัดเก็บไว้ในระดับที่สูงขึ้นแล้ว (เช่น ค่าใช้จ่ายที่ต้องจ่ายเอง) จํานวนเงินทั้งหมดเป็นระยะเวลาตลอดอายุการใช้งานที่กําหนดโดยช่อง panel_lifetime_years ใน SolarPotential หมายเหตุ: ค่าใช้จ่ายที่ต้องจ่ายเองสำหรับการซื้อแผงจะระบุไว้ในช่อง out_of_pocket_cost ใน CashPurchaseSavings

ช่อง
initial_ac_kwh_per_year	float จำนวน kWh AC ที่เราคิดว่าแผงโซลาร์เซลล์จะผลิตในปีแรก
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 เปอร์เซ็นต์ (0-100) ของการผลิตไฟฟ้าจากแสงอาทิตย์ที่เราคาดว่าส่งไปยังระบบโครงข่ายไฟฟ้า โดยอิงจากการผลิตในไตรมาสแรก ซึ่งจะส่งผลต่อการคำนวณหากไม่อนุญาตให้ใช้การวัดผลสุทธิ

FindClosestBuildingInsightsRequest

คำขอข้อความสำหรับ Solar.FindClosestBuildingInsights

ช่อง
location	LatLng ต้องระบุ ลองจิจูดและละติจูดที่ API จะใช้ค้นหาอาคารที่รู้จักซึ่งอยู่ใกล้ที่สุด
required_quality	ImageryQuality ไม่บังคับ ระดับคุณภาพขั้นต่ำที่อนุญาตในผลการค้นหา ระบบจะไม่แสดงผลลัพธ์ที่มีคุณภาพต่ำกว่านี้ การไม่ระบุค่านี้เทียบเท่ากับการจำกัดคุณภาพไว้ที่สูงเท่านั้น

GetDataLayersRequest

คำขอข้อความสำหรับ Solar.GetDataLayers

ช่อง
location	LatLng ต้องระบุ ลองจิจูดและละติจูดของศูนย์กลางภูมิภาคที่จะรับข้อมูล
radius_meters	float ต้องระบุ รัศมี (หน่วยเป็นเมตร) ที่กําหนดขอบเขตพื้นที่รอบจุดศูนย์กลางที่ควรแสดงข้อมูล ข้อจํากัดของค่านี้คือ คุณสามารถระบุค่าใดก็ได้สูงสุด 100 ล้าน คุณสามารถระบุค่าที่มากกว่า 100 ล้านได้ ตราบใดที่ radius_meters <= pixel_size_meters * 1000 อย่างไรก็ตาม สำหรับค่าที่มากกว่า 175 เมตร DataLayerView ในคำขอต้องไม่รวมฟลักซ์รายเดือนหรือร่มเงารายชั่วโมง
view	DataLayerView ไม่บังคับ ชุดข้อมูลย่อยที่ต้องการแสดงผล
required_quality	ImageryQuality ไม่บังคับ ระดับคุณภาพขั้นต่ำที่อนุญาตในผลการค้นหา ระบบจะไม่แสดงผลลัพธ์ที่มีคุณภาพต่ำกว่านี้ การไม่ระบุค่านี้เทียบเท่ากับการจำกัดคุณภาพไว้ที่สูงเท่านั้น
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 ไม่บังคับ กำหนดคุณภาพของภาพให้ตรงกันทุกประการหรือไม่ หากตั้งค่าเป็นเท็จ ระบบจะตีความช่อง required_quality เป็นคุณภาพขั้นต่ำที่ต้องการ เช่น ระบบอาจแสดงภาพคุณภาพสูงเมื่อตั้งค่า required_quality เป็นปานกลาง หากตั้งค่าเป็น "จริง" ระบบจะตีความ required_quality เป็นคุณภาพที่ต้องการอย่างเจาะจง และระบบจะแสดงเฉพาะภาพคุณภาพ MEDIUM หากตั้งค่า required_quality เป็น MEDIUM

GetGeoTiffRequest

คำขอข้อความสำหรับ Solar.GetGeoTiff

ช่อง
id	string ต้องระบุ รหัสของเนื้อหาที่ขอ

ImageryQuality

คุณภาพของภาพที่ใช้คํานวณผลลัพธ์ API บางรายการ

หมายเหตุ: ไม่ว่าภาพจะมีคุณภาพระดับใดก็ตาม เอาต์พุต DSM จะมีความละเอียด 0.1 ม./พิกเซลเสมอ เอาต์พุตฟลักซ์รายเดือนจะมีความละเอียด 0.5 ม./พิกเซลเสมอ และเอาต์พุตเงารายชั่วโมงจะมีความละเอียด 1 ม./พิกเซลเสมอ

Enum
IMAGERY_QUALITY_UNSPECIFIED	ไม่ทราบคุณภาพ
HIGH	ข้อมูลแสงอาทิตย์มาจากภาพถ่ายทางอากาศที่ถ่ายในระดับความสูงต่ำและประมวลผลที่ 0.1 ม./พิกเซล
MEDIUM	ข้อมูลแสงอาทิตย์มาจากภาพถ่ายทางอากาศที่ปรับปรุงแล้วซึ่งถ่ายที่ระดับความสูงและประมวลผลที่ 0.25 ม./พิกเซล
LOW	ข้อมูลแสงอาทิตย์มาจากภาพถ่ายจากดาวเทียมที่ปรับปรุงแล้วซึ่งประมวลผลที่ 0.25 ม./พิกเซล
BASE	ข้อมูลแสงอาทิตย์มาจากภาพถ่ายจากดาวเทียมที่ปรับปรุงแล้วซึ่งประมวลผลที่ 0.25 ม./พิกเซล

LatLngBox

กรอบล้อมรอบในพิกัดละติจูด/ลองจิจูด

ช่อง
sw	LatLng มุมตะวันตกเฉียงใต้ของกล่อง
ne	LatLng มุมตะวันออกเฉียงเหนือของกล่อง

LeasingSavings

ต้นทุนและประโยชน์ของการเช่าแผงโซลาร์เซลล์ที่มีการกำหนดค่าหนึ่งๆ ที่มีการใช้ไฟฟ้าหนึ่งๆ

ช่อง
leases_allowed	bool อนุญาตให้เช่าในเขตอำนาจศาลนี้หรือไม่ (บางรัฐไม่อนุญาตให้เช่า) หากช่องนี้เป็นเท็จ ระบบอาจไม่สนใจค่าในข้อความนี้
leases_supported	bool เครื่องมือคำนวณทางการเงินรองรับสัญญาเช่าในเขตอำนาจศาลนี้หรือไม่ หากช่องนี้เป็นเท็จ ระบบอาจไม่สนใจค่าในข้อความนี้ ข้อมูลนี้ไม่เกี่ยวข้องกับ 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 ปริมาณพลังงานแสงอาทิตย์ที่ผังส่วนนี้ได้รับตลอดทั้งปีในหน่วย DC kWh โดยสมมติว่าใช้แผงตามที่อธิบายไว้ข้างต้น
pitch_degrees	float มุมของส่วนหลังคาสัมพันธ์กับระนาบพื้นตามทฤษฎี 0 = ขนานกับพื้น 90 = ตั้งฉากกับพื้น
azimuth_degrees	float ทิศทางของเข็มทิศที่กลุ่มหลังคาชี้ไป 0 = เหนือ, 90 = ตะวันออก, 180 = ใต้ สำหรับส่วนของหลังคา "แบน" (pitch_degrees ใกล้เคียงกับ 0 มาก) มุมอาซิมุทจะกำหนดได้ไม่ชัดเจน ดังนั้นเราจึงกำหนดให้ค่านี้เป็น 0 (เหนือ) โดยพลการเพื่อให้สอดคล้องกัน
segment_index	int32 ดัชนีใน roof_segment_stats ของ RoofSegmentSizeAndSunshineStats ที่เกี่ยวข้อง

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 ระบุว่าสถานการณ์นี้มีความเป็นไปได้ทางการเงินหรือไม่ จะเท่ากับเท็จสำหรับสถานการณ์ที่มีความมั่นคงทางการเงินไม่ดี (เช่น ขาดทุน)

SizeAndSunshineStats

ขนาดและควอร์ไทล์ความสว่างของหลังคาหรือส่วนหนึ่งของหลังคา

ช่อง
area_meters2	float พื้นที่ของหลังคาหรือกลุ่มหลังคาเป็น m^2 พื้นที่นี้คือพื้นที่หลังคา (พิจารณาความลาดเอียง) ไม่ใช่พื้นที่บนพื้น
sunshine_quantiles[]	float ควอไทล์ของจุดที่มีแดดทั่วทั้งพื้นที่ หากมี N ค่าที่นี่ ค่านี้จะแสดงถึง (N-1)-iles เช่น หากมี 5 ค่า ค่าดังกล่าวจะเป็นควอไทล์ (ต่ำสุด 25% 50% 75% สูงสุด) ค่าเป็น kWh/kW รายปี เช่น max_sunshine_hours_per_year
ground_area_meters2	float พื้นที่บนพื้นดินที่หลังคาหรือส่วนหลังคาปกคลุมในหน่วย m^2

SolarPanel

SolarPanel อธิบายตำแหน่ง การวางแนว และการผลิตของแผงโซลาร์เซลล์เดียว ดูข้อมูลเกี่ยวกับพารามิเตอร์ของแผงในช่อง panel_height_meters, panel_width_meters และ panel_capacity_watts ใน SolarPotential

ช่อง
center	LatLng ตรงกลางของแผง
orientation	SolarPanelOrientation การวางแนวของแผง
yearly_energy_dc_kwh	float ปริมาณพลังงานแสงอาทิตย์ที่ผังนี้ได้รับตลอดทั้งปีในหน่วย DC kWh
segment_index	int32 ดัชนีใน roof_segment_stats ของ RoofSegmentSizeAndSunshineStats ซึ่งสอดคล้องกับส่วนของหลังคาที่ติดตั้งแผงนี้

SolarPanelConfig

SolarPanelConfig อธิบายตําแหน่งการวางแผงโซลาร์เซลล์บนหลังคา

ช่อง
panels_count	int32 จํานวนแผงทั้งหมด โปรดทราบว่าค่านี้ซ้ำซ้อนกับ (ผลรวมของ) ฟิลด์ที่เกี่ยวข้องใน roof_segment_summaries
yearly_energy_dc_kwh	float ปริมาณพลังงานแสงอาทิตย์ที่รูปแบบนี้รับได้ตลอดทั้งปีในหน่วย DC kWh โดยสมมติว่าใช้แผงตามที่อธิบายไว้ข้างต้น
roof_segment_summaries[]	RoofSegmentSummary ข้อมูลเกี่ยวกับการผลิตของส่วนหลังคาแต่ละส่วนที่มีแผงอย่างน้อย 1 แผงในเลย์เอาต์นี้ roof_segment_summaries[i] อธิบายส่วนของหลังคาที่ i ซึ่งรวมถึงขนาด การผลิตที่คาดไว้ และการวางแนว

SolarPanelOrientation

การวางแนวของแผงโซลาร์เซลล์ ซึ่งต้องตีความตามแนวราบของส่วนหลังคาที่วางแผง

Enum
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 ขนาดของอาร์เรย์สูงสุดเป็นตารางเมตร
max_sunshine_hours_per_year	float จำนวนชั่วโมงที่รับแสงแดดสูงสุดต่อปี ณ จุดใดก็ได้บนหลังคา ชั่วโมงที่แสงอาทิตย์ส่องถึงเป็นการวัดปริมาณการแผ่รังสีดวงอาทิตย์ (พลังงาน) ที่ได้รับต่อปี 1 ชั่วโมงที่แสงอาทิตย์ส่องถึง = 1 kWh ต่อ kW (โดยที่ kW หมายถึงความจุ kW ภายใต้สภาพการทดสอบมาตรฐาน)
carbon_offset_factor_kg_per_mwh	float ปริมาณ CO2 ที่เทียบเท่าซึ่งเกิดจากไฟฟ้าในระบบโครงข่ายจ่ายไฟฟ้า 1 เมกะวัตต์-ชั่วโมง ค่านี้เป็นมาตรวัดความเข้มของคาร์บอนจากไฟฟ้าในระบบกริดที่แทนที่ด้วยไฟฟ้าจากแสงอาทิตย์
whole_roof_stats	SizeAndSunshineStats ขนาดทั้งหมดและจำนวนแสงอาทิตย์ที่รับได้สำหรับส่วนของหลังคาที่กำหนดให้กับกลุ่มหลังคาบางกลุ่ม แม้ว่าชื่อจะระบุว่าเป็นอาคาร แต่อาจไม่ได้รวมทั้งอาคาร ดูbuilding_stats
building_stats	SizeAndSunshineStats ขนาดและควอร์ไทล์แสงอาทิตย์ของทั้งอาคาร รวมถึงส่วนต่างๆ ของหลังคาที่ไม่ได้กำหนดให้กับกลุ่มหลังคาบางกลุ่ม เนื่องจากการวางแนวของส่วนเหล่านี้ไม่ชัดเจน ค่าประมาณพื้นที่หลังคาจึงไม่น่าเชื่อถือ แต่ค่าประมาณพื้นที่ชั้นล่างน่าเชื่อถือ คุณอาจได้รับพื้นที่หลังคาของทั้งอาคารที่เชื่อถือได้มากขึ้นโดยการปรับขนาดพื้นที่หลังคาจาก whole_roof_stats ตามสัดส่วนพื้นที่ชั้นล่างของ building_stats และ whole_roof_stats
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats ขนาดและควอร์ไทล์แสงอาทิตย์สำหรับแต่ละส่วนของหลังคา
solar_panels[]	SolarPanel SolarPanel แต่ละรายการอธิบายแผงโซลาร์เซลล์ 1 แผง โดยจะแสดงตามลำดับที่อัลกอริทึมการจัดวางแผงวางไว้ โดยปกติแล้ว (แต่ก็ไม่เสมอไป) ข้อมูลนี้จะเรียงตามลำดับการผลิตพลังงานรายปีจากน้อยไปมาก
solar_panel_configs[]	SolarPanelConfig SolarPanelConfig แต่ละรายการแสดงการจัดเรียงแผงโซลาร์เซลล์บนหลังคาที่แตกต่างกัน โดยเรียงตามจํานวนแผงที่เพิ่มขึ้น SolarPanelConfig ที่มี panels_count=N จะอิงตามแผง N แผงแรกในรายการ solar_panels ระบบจะป้อนข้อมูลในช่องนี้เฉพาะในกรณีที่ติดตั้งแผงบนหลังคาได้อย่างน้อย 4 แผง
financial_analyses[]	FinancialAnalysis FinancialAnalysis แสดงการประหยัดจากการใช้พลังงานแสงอาทิตย์โดยอิงตามค่าไฟฟ้ารายเดือนและผู้ให้บริการไฟฟ้ารายหนึ่งๆ โดยเรียงตามลำดับจากน้อยไปมากของจำนวนเงินที่เรียกเก็บรายเดือน ช่องนี้จะว่างเปล่าสำหรับอาคารในพื้นที่ที่ Solar API มีข้อมูลไม่เพียงพอที่จะคำนวณทางการเงิน