- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- ค่าเงิน
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- ลองใช้งาน
ค้นหาอาคารที่ใกล้กับจุดค้นหามากที่สุด แสดงผลข้อผิดพลาดที่มีรหัส NOT_FOUND
หากไม่มีสิ่งปลูกสร้างในระยะประมาณ 50 เมตรของจุดค้นหา
คำขอ HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
location |
ต้องระบุ ลองจิจูดและละติจูดที่ API ค้นหาอาคารที่รู้จักซึ่งอยู่ใกล้ที่สุด |
requiredQuality |
ไม่บังคับ ระดับคุณภาพต่ำสุดที่อนุญาตให้ใช้ในผลลัพธ์ แต่จะไม่ส่งคืนผลลัพธ์ที่มีคุณภาพต่ำกว่า หากไม่ระบุ จะเทียบเท่ากับการจำกัดให้เป็นคุณภาพสูงเท่านั้น |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ Solar.FindClosestBuildingInsights
ข้อมูลเกี่ยวกับสถานที่ตั้ง ขนาด และศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "name": string, "center": { object ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรอาคาร ในรูปแบบ |
center |
จุดที่ใกล้กับศูนย์กลางของอาคาร |
boundingBox |
กรอบล้อมรอบของอาคาร |
imageryDate |
วันที่ได้รับภาพที่เกี่ยวข้อง ค่านี้เป็นค่าโดยประมาณ |
imageryProcessedDate |
เมื่อการประมวลผลภาพนี้เสร็จสมบูรณ์ |
postalCode |
รหัสไปรษณีย์ (เช่น รหัสไปรษณีย์ของสหรัฐอเมริกา) ของอาคารแห่งนี้ |
administrativeArea |
เขตบริหาร 1 (เช่น ในสหรัฐอเมริกา รัฐ) ที่มีอาคารนี้ เช่น ในสหรัฐอเมริกา ตัวย่ออาจเป็น "MA" หรือ "CA" |
statisticalArea |
พื้นที่ทางสถิติ (เช่น ทางเดินสำมะโนประชากรของสหรัฐฯ) อาคารนี้อยู่ |
regionCode |
รหัสภูมิภาคสำหรับประเทศ (หรือภูมิภาค) ของอาคารนี้ |
solarPotential |
ศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร |
imageryQuality |
คุณภาพของภาพที่ใช้ในการคำนวณข้อมูลสำหรับอาคารนี้ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/cloud-platform
LatLngBox
กล่องขอบเขตในพิกัดละติจูด/ลองจิจูด
การแสดง JSON |
---|
{ "sw": { object ( |
ช่อง | |
---|---|
sw |
มุมตะวันตกเฉียงใต้ของกล่อง |
ne |
มุมตะวันออกเฉียงเหนือของกล่อง |
SolarPotential
ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร จำนวนช่องในส่วนนี้มีคำจำกัดความอยู่ในส่วน "แผง" ช่อง panelCapacityWatts
, panelHeightMeters
และ panelWidthMeters
อธิบายพารามิเตอร์ของโมเดลแผงที่ใช้ในการคำนวณเหล่านี้
การแสดง JSON |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
ช่อง | |
---|---|
maxArrayPanelsCount |
ขนาดของอาร์เรย์สูงสุด ซึ่งก็คือจำนวนสูงสุดของแผงที่สามารถวางบนหลังคาได้ |
panelCapacityWatts |
ความจุในหน่วยวัตต์ของแผงที่ใช้ในการคำนวณ |
panelHeightMeters |
ความสูงเป็นเมตรในแนวตั้งของแผงที่ใช้ในการคำนวณ |
panelWidthMeters |
ความกว้างเป็นหน่วยเมตรในการวางแนวแนวตั้งของแผงที่ใช้ในการคำนวณ |
panelLifetimeYears |
อายุการใช้งานที่คาดไว้ของแผงโซลาร์เซลล์ในหน่วยปี โดยใช้ในการคำนวณทางการเงิน |
maxArrayAreaMeters2 |
ขนาดของอาร์เรย์สูงสุด หน่วยเป็นตารางเมตร |
maxSunshineHoursPerYear |
จำนวนชั่วโมงแสงแดดที่ได้รับสูงสุดต่อปี ตามจุดใดก็ได้บนหลังคา ชั่วโมงแสงแดดเป็นหน่วยวัดปริมาณความแห้งแล้งทั้งหมด (พลังงาน) ที่ได้รับต่อปี 1 ชั่วโมงแสงแดด = 1 กิโลวัตต์-ชั่วโมงต่อ kW (โดยที่ kW หมายถึงกิโลวัตต์ของความจุภายใต้เงื่อนไขการทดสอบมาตรฐาน) |
carbonOffsetFactorKgPerMwh |
ปริมาณ CO2 ที่ผลิตต่อไฟฟ้าจากระบบโครงข่ายไฟฟ้า (CO2) เทียบเท่าในหน่วยเมกะวัตต์-ชั่วโมง นี่คือการวัดความเข้มของคาร์บอนของไฟฟ้าจากโครงข่ายไฟฟ้าที่ทดแทนด้วยไฟฟ้าพลังงานแสงอาทิตย์ |
wholeRoofStats |
ขนาดโดยรวมและควอนไทล์แสงแดดสำหรับส่วนของหลังคาที่กำหนดให้ส่วนหลังคาบางส่วน ถึงแม้ว่าจะตั้งชื่อแล้ว แต่ภาพนี้อาจไม่รวมอาคารทั้งหลัง ดู |
buildingStats |
ขนาดและควอนไทล์แสงแดดสำหรับทั้งอาคาร รวมถึงส่วนของหลังคาที่ไม่ได้กำหนดให้กับบางส่วนของหลังคา เนื่องจากการวางแนวของส่วนต่างๆ เหล่านี้มีลักษณะที่ไม่เหมาะสม การประมาณพื้นที่หลังคาจึงไม่น่าเชื่อถือ แต่การประมาณพื้นที่พื้นดินมีความน่าเชื่อถือ อาจเป็นไปได้ที่จะได้พื้นที่หลังคาของอาคารทั้งหมดที่เชื่อถือได้มากขึ้นโดยการปรับขนาดพื้นที่หลังคาจาก |
roofSegmentStats[] |
ขนาดและควอนไทล์แสงแดดสำหรับแต่ละส่วนของหลังคา |
solarPanels[] |
|
solarPanelConfigs[] |
|
financialAnalyses[] |
|
SizeAndSunshineStats
ปริมาณของควอนไทล์ขนาดและแสงแดดของหลังคาหรือส่วนหนึ่งของหลังคา
การแสดง JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
ช่อง | |
---|---|
areaMeters2 |
พื้นที่ของหลังคาหรือส่วนหลังคาในหน่วย m^2 นี่คือพื้นที่หลังคา (แสดงถึงการเอียง) ไม่ใช่พื้นที่ฟุตพริ้นท์ |
sunshineQuantiles[] |
ปริมาณของแสงแดดแบบจุดๆ กระจายทั่วทั้งพื้นที่ หากมีค่า N ค่าที่นี่ ค่านี้จะแสดง (N-1)-ile เช่น หากมี 5 ค่า ค่าเหล่านั้นจะเป็นควอไทล์ (ต่ำสุด, 25%, 50%, 75%, สูงสุด) ค่าจะอยู่ในหน่วย kWh/kW รายปี เช่น |
groundAreaMeters2 |
พื้นที่รอยเท้าพื้นซึ่งครอบคลุมโดยหลังคาหรือส่วนของหลังคาในหน่วย m^2 |
RoofSegmentSizeAndSunshineStats
ข้อมูลเกี่ยวกับขนาดและควอนไทล์ของหลังคา
การแสดง JSON |
---|
{ "stats": { object ( |
ช่อง | |
---|---|
stats |
ขนาดรวมและควอนไทล์แสงแดดของกลุ่มหลังคา |
center |
จุดที่อยู่ใกล้กับกึ่งกลางของส่วนหลังคา |
boundingBox |
กรอบล้อมรอบของส่วนหลังคา |
pitchDegrees |
มุมของส่วนหลังคาที่สัมพันธ์กับระนาบพื้นดินทางทฤษฎี 0 = ขนานกับพื้น, 90 = ตั้งฉากกับพื้น |
azimuthDegrees |
ทิศทางเข็มทิศที่ส่วนหลังคาชี้เข้ามา 0 = เหนือ, 90 = ตะวันออก, 180 = ใต้ สำหรับส่วนของหลังคาที่เป็น "แนวราบ" ( |
planeHeightAtCenterMeters |
ความสูงของระนาบส่วนหลังคาในหน่วยเมตรเหนือระดับน้ำทะเล ณ จุดที่กำหนดโดย |
SolarPanel
Solar Panel จะอธิบายตำแหน่ง การวางแนว และการผลิตแผงโซลาร์เซลล์เดี่ยว ดูข้อมูลเกี่ยวกับพารามิเตอร์ของแผงได้ที่ช่อง panelHeightMeters
, panelWidthMeters
และ panelCapacityWatts
ใน SolarPotential
การแสดง JSON |
---|
{ "center": { object ( |
ช่อง | |
---|---|
center |
กึ่งกลางของแผง |
orientation |
การวางแนวของแผง |
yearlyEnergyDcKwh |
ปริมาณแสงอาทิตย์ที่ใช้พลังงานแสงอาทิตย์ซึ่งเลย์เอาต์นี้ได้รับตลอดช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง |
segmentIndex |
ดัชนีใน |
SolarPanelOrientation
การวางแนวแผงโซลาร์เซลล์ โดยจะต้องตีความตามแอซิมัทของส่วนหลังคาที่แผงวางอยู่
Enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
ไม่พบการวางแนวแผง |
LANDSCAPE |
แผง LANDSCAPE มีขอบยาวตั้งฉากกับทิศทางแอซิมัสของส่วนหลังคาที่วางอยู่ |
PORTRAIT |
แผง PORTRAIT มีขอบยาวขนานกับทิศทางแอซิมัทของส่วนหลังคาที่วางอยู่ |
SolarPanelConfig
Solar PanelConfig จะอธิบายตำแหน่งของแผงโซลาร์เซลล์บนหลังคาโดยเฉพาะ
การแสดง JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
ช่อง | |
---|---|
panelsCount |
จำนวนแผงทั้งหมด โปรดทราบว่าค่านี้ซ้ำซ้อนกับ (ผลรวมของ) ช่องที่เกี่ยวข้องใน |
yearlyEnergyDcKwh |
ปริมาณแสงอาทิตย์ที่เลย์เอาต์นี้ได้รับตลอดช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง โดยสมมติว่าแผงที่อธิบายไว้ข้างต้น |
roofSegmentSummaries[] |
ข้อมูลเกี่ยวกับการผลิตของแต่ละส่วนหลังคาที่มีแผงอย่างน้อย 1 แผงในเลย์เอาต์นี้ |
RoofSegmentSummary
ข้อมูลเกี่ยวกับส่วนหลังคาของอาคาร โดยมีแผงบางส่วนวางอยู่บนส่วนนั้น
การแสดง JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
ช่อง | |
---|---|
panelsCount |
จํานวนแผงทั้งหมดในกลุ่มนี้ |
yearlyEnergyDcKwh |
ปริมาณพลังงานแสงอาทิตย์ของเลย์เอาต์ที่จับได้ในช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง โดยสมมติว่าแผงที่อธิบายไว้ข้างต้น |
pitchDegrees |
มุมของส่วนหลังคาที่สัมพันธ์กับระนาบพื้นดินทางทฤษฎี 0 = ขนานกับพื้น, 90 = ตั้งฉากกับพื้น |
azimuthDegrees |
ทิศทางเข็มทิศที่ส่วนหลังคาชี้เข้ามา 0 = เหนือ, 90 = ตะวันออก, 180 = ใต้ สำหรับส่วนของหลังคาที่เป็น "แนวราบ" ( |
segmentIndex |
ดัชนีใน |
FinancialAnalysis
การวิเคราะห์ต้นทุนและประโยชน์ของเลย์เอาต์พลังงานแสงอาทิตย์ที่เหมาะสมที่สุดสำหรับขนาดค่าไฟหนึ่งๆ
การแสดง JSON |
---|
{ "monthlyBill": { object ( |
ช่อง | |
---|---|
monthlyBill |
ค่าไฟรายเดือนที่การวิเคราะห์นี้ถือว่าเป็น |
defaultBill |
นี่คือขนาดใบเรียกเก็บเงินที่เลือกเป็นการเรียกเก็บเงินเริ่มต้นสำหรับพื้นที่ที่อาคารนี้อยู่ไหม |
averageKwhPerMonth |
จำนวนไฟฟ้าที่บ้านใช้ในเดือนโดยเฉลี่ย โดยคิดจากขนาดบิลและอัตราค่าไฟของท้องถิ่น |
financialDetails |
ข้อมูลทางการเงินที่มีผลบังคับใช้ไม่ว่าจะใช้วิธีการชําระเงินใดก็ตาม |
leasingSavings |
ต้นทุนและประโยชน์ของการเช่าแผงโซลาร์เซลล์ |
cashPurchaseSavings |
ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์ด้วยเงินสด |
financedPurchaseSavings |
ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์โดยการจัดหาเงินทุนในการซื้อ |
panelConfigIndex |
ดัชนีใน |
เงินทอง
แสดงจำนวนเงินพร้อมประเภทสกุลเงิน
การแสดง JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
ช่อง | |
---|---|
currencyCode |
รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217 |
units |
หน่วยทั้งหมดของจำนวนเงิน เช่น หาก |
nanos |
จำนวนหน่วยนาโน (10^-9) ของปริมาตร ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก |
FinancialDetails
รายละเอียดของการวิเคราะห์ทางการเงิน โดยรายละเอียดบางอย่างได้รับการจัดเก็บไว้ในระดับที่สูงกว่า (เช่น ค่าใช้จ่ายในกรณีที่ไม่ตรงกับการใช้งานจริง) จำนวนเงินรวมตลอดอายุการใช้งานที่กำหนดโดยช่อง panelLifetimeYears
ใน SolarPotential
หมายเหตุ: ค่าใช้จ่ายสุทธิสำหรับการซื้อแผงจะอยู่ในช่อง outOfPocketCost
ใน CashPurchaseSavings
การแสดง JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
ช่อง | |
---|---|
initialAcKwhPerYear |
มีกี่กิโลวัตต์-ชั่วโมงที่เราคิดว่าแผงโซลาร์เซลล์จะสร้างได้ในปีแรก |
remainingLifetimeUtilityBill |
ใบเรียกเก็บเงินค่าสาธารณูปโภคสำหรับไฟฟ้าที่ไม่ได้ผลิตโดยพลังงานแสงอาทิตย์ ตลอดอายุของแผงโซลาร์เซลล์ |
federalIncentive |
จำนวนเงินที่ได้รับจากสิ่งจูงใจของรัฐบาลกลาง ใช้ได้เมื่อผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีการให้ยืม) |
stateIncentive |
จำนวนเงินที่ได้รับจากสิ่งจูงใจของรัฐ เงื่อนไขนี้จะมีผลหากผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีสินเชื่อ) |
utilityIncentive |
จำนวนเงินที่ได้รับจากสิ่งจูงใจด้านสาธารณูปโภค กรณีนี้ใช้ในกรณีที่ผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีสินเชื่อ) |
lifetimeSrecTotal |
จำนวนเงินที่ผู้ใช้จะได้รับจากเครดิตพลังงานแสงอาทิตย์หมุนเวียนตลอดอายุการใช้งานของแผงโซลาร์เซลล์ ข้อมูลนี้ใช้ในกรณีที่ผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีการให้ยืม) |
costOfElectricityWithoutSolar |
ต้นทุนทั้งหมดของไฟฟ้าที่ผู้ใช้จะต้องจ่ายตลอดอายุการใช้งานหากไม่ได้ติดตั้งพลังงานแสงอาทิตย์ |
netMeteringAllowed |
อนุญาตการวัดสุทธิหรือไม่ |
solarPercentage |
เปอร์เซ็นต์ (0-100) ของพลังงานของผู้ใช้ที่ใช้พลังงานแสงอาทิตย์ ใช้ได้สำหรับปีแรก แต่จะมีความถูกต้องโดยประมาณสำหรับปีต่อๆ ไป |
percentageExportedToGrid |
เปอร์เซ็นต์ (0-100) ของการผลิตไฟฟ้าพลังงานแสงอาทิตย์ที่เราคิดว่ามีการส่งออกไปยังระบบโครงข่ายไฟฟ้า โดยอิงจากการผลิตไฟฟ้าในไตรมาสแรก ซึ่งจะส่งผลต่อการคำนวณหากไม่อนุญาตให้มีการวัดปริมาณสุทธิ |
LeasingSavings
ต้นทุนและประโยชน์ของการเช่าซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
ช่อง | |
---|---|
leasesAllowed |
อนุญาตให้ให้เช่าในเขตอำนาจศาลนี้ได้หรือไม่ (บางรัฐไม่อนุญาตให้มีการเช่าไม่ได้) หากช่องนี้เป็น "เท็จ" ระบบควรละเว้นค่าในข้อความนี้ |
leasesSupported |
เครื่องมือคำนวณทางการเงินรองรับค่าเช่าในเขตอำนาจศาลนี้หรือไม่ หากช่องนี้เป็น "เท็จ" ระบบควรละเว้นค่าในข้อความนี้ ซึ่งไม่เกี่ยวข้องกับ |
annualLeasingCost |
ค่าเช่ารายปีโดยประมาณ |
savings |
จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน |
SavingsOverTime
ข้อมูลทางการเงินที่แชร์ระหว่างวิธีการชําระเงินต่างๆ
การแสดง JSON |
---|
{ "savingsYear1": { object ( |
ช่อง | |
---|---|
savingsYear1 |
ค่าใช้จ่ายที่ประหยัดได้ในปีแรกหลังการติดตั้งแผง |
savingsYear20 |
ค่าใช้จ่ายที่ประหยัดได้ในช่วง 20 ปีแรกหลังจากการติดตั้งแผง |
presentValueOfSavingsYear20 |
เมื่อใช้อัตราส่วนลดที่คาดไว้ มูลค่าปัจจุบันของเงินออมสะสมในระยะเวลา 20 ปีคือเท่าใด |
savingsLifetime |
ค่าใช้จ่ายที่ประหยัดได้ตลอดอายุการใช้งานของแผง |
presentValueOfSavingsLifetime |
หากใช้อัตราส่วนลดที่คาดไว้ มูลค่าปัจจุบันของเงินออมสะสมตลอดอายุการใช้งานจะเป็นเท่าใด |
financiallyViable |
ระบุว่าสถานการณ์นี้มีโอกาสทางการเงินหรือไม่ เป็นเท็จในกรณีที่มีสถานะทางการเงินไม่ดี (เช่น มีภาวะเงินสูญหาย) |
CashPurchaseSavings
ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าแบบเจาะจง
การแสดง JSON |
---|
{ "outOfPocketCost": { object ( |
ช่อง | |
---|---|
outOfPocketCost |
ค่าใช้จ่ายเริ่มต้นก่อนสิ่งจูงใจทางภาษี: จำนวนที่ต้องชำระทันที ตรงข้ามกับ |
upfrontCost |
ค่าใช้จ่ายเริ่มต้นหลังสิ่งจูงใจทางภาษี: จำนวนนี้ต้องชำระในปีแรก ตรงข้ามกับ |
rebateValue |
มูลค่าของส่วนลดภาษีทั้งหมด |
savings |
จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน |
paybackYears |
จำนวนปีก่อนที่จะเกิดการคืนทุน ค่าติดลบหมายถึงการคืนทุนจะไม่เกิดขึ้นภายในตลอดอายุการใช้งาน |
FinancedPurchaseSavings
ต้นทุนและประโยชน์ของการใช้เงินกู้เพื่อซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "annualLoanPayment": { object ( |
ช่อง | |
---|---|
annualLoanPayment |
การชำระสินเชื่อรายปี |
rebateValue |
มูลค่าของส่วนลดภาษีทั้งหมด (รวมถึง Federal Investment Tax Credit (ITC)) |
loanInterestRate |
อัตราดอกเบี้ยสินเชื่อที่สันนิษฐานในการคำนวณชุดนี้ |
savings |
จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน |