- คำขอ 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
ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร จำนวนช่องในส่วนนี้จะกำหนดไว้เป็น "panels" ช่อง 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 กิโลวัตต์ชั่วโมงต่อกิโลวัตต์ (โดยที่กิโลวัตต์หมายถึง กิโลวัตต์ของความจุภายใต้เงื่อนไขการทดสอบมาตรฐาน) |
carbonOffsetFactorKgPerMwh |
ปริมาณ CO2 ที่ผลิตได้เทียบเท่าต่อ MWh ของไฟฟ้าจากระบบโครงข่าย นี่คือการวัดความเข้มคาร์บอนของไฟฟ้าจากระบบโครงข่ายไฟฟ้าที่ใช้พลังงานแสงอาทิตย์แทน |
wholeRoofStats |
ขนาดและควอนไทล์แสงอาทิตย์ทั้งหมดของส่วนของหลังคาที่กําหนดให้กับส่วนของหลังคาบางส่วน แม้จะมีชื่อสถานที่ แต่อาจไม่ครอบคลุมทั้งอาคาร ดู |
buildingStats |
ขนาดและควอนไทล์แสงของแสงแดดสำหรับทั้งอาคาร รวมถึงบางส่วนของหลังคาที่ไม่ได้กำหนดให้เป็นส่วนของหลังคาบางส่วน เนื่องจากการวางแนวของชิ้นส่วนเหล่านี้มีลักษณะที่ไม่ดี การประมาณพื้นที่หลังคาจึงไม่น่าเชื่อถือ แต่การประมาณพื้นที่ภาคพื้นดินเชื่อถือได้ อาจเป็นได้ว่าพื้นที่หลังคาของอาคารทั้งหมดมีความน่าเชื่อถือมากกว่าด้วยการปรับขนาดพื้นที่หลังคาจาก |
roofSegmentStats[] |
ขนาดและควอนไทล์แสงของแสงอาทิตย์สำหรับแต่ละส่วนบนหลังคา |
solarPanels[] |
|
solarPanelConfigs[] |
|
financialAnalyses[] |
|
SizeAndSunshineStats
ขนาดและสัดส่วนของหลังคาหรือส่วนของหลังคา
การแสดง JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
ช่อง | |
---|---|
areaMeters2 |
พื้นที่ของหลังคาหรือส่วนของหลังคา หน่วยเป็น m^2 นี่คือพื้นที่หลังคา (สําหรับการเอียง) ไม่ใช่พื้นที่รอยเท้าพื้น |
sunshineQuantiles[] |
ปริมาณของจุดสลับคำในพื้นที่ หากมีค่า N ค่าที่นี่ ค่านี้จะแสดงรายการ (N-1) เช่น หากมี 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
Solarpanel อธิบายตำแหน่ง การวางแนว และการผลิตแผงโซลาร์เซลล์เดียว ดูข้อมูลเกี่ยวกับพารามิเตอร์ของแผงที่ช่อง 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 kWh โดยพิจารณาจากแผงที่อธิบายไว้ข้างต้น |
roofSegmentSummaries[] |
ข้อมูลเกี่ยวกับการผลิตส่วนของหลังคาแต่ละส่วนที่แสดงแผงอย่างน้อย 1 แผงในเลย์เอาต์นี้ |
RoofSegmentSummary
ข้อมูลเกี่ยวกับส่วนของหลังคาในอาคาร ซึ่งมีแผงบางส่วนวางอยู่บนส่วนนั้น
การแสดง JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
ช่อง | |
---|---|
panelsCount |
จำนวนแผงทั้งหมดในกลุ่มนี้ |
yearlyEnergyDcKwh |
ปริมาณพลังงานแสงอาทิตย์ที่บางส่วนของเลย์เอาต์นี้เก็บในช่วง 1 ปี โดยคิดเป็น DC kWh โดยพิจารณาจากแผงที่อธิบายไว้ข้างต้น |
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 |
จำนวน AC kWh ที่เราคิดว่าแผงโซลาร์เซลล์จะผลิตได้ในปีแรก |
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 |
ประหยัดได้เท่าใด (หรือไม่ได้) ตลอดอายุการใช้งาน |