Method: buildingInsights.findClosest

ค้นหาอาคารที่ใกล้กับจุดค้นหามากที่สุด แสดงผลข้อผิดพลาดที่มีรหัส NOT_FOUND หากไม่มีสิ่งปลูกสร้างในระยะประมาณ 50 เมตรของจุดค้นหา

คำขอ HTTP

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
location

object (LatLng)

ต้องระบุ ลองจิจูดและละติจูดที่ API ค้นหาอาคารที่รู้จักซึ่งอยู่ใกล้ที่สุด

requiredQuality

enum (ImageryQuality)

ไม่บังคับ ระดับคุณภาพต่ำสุดที่อนุญาตให้ใช้ในผลลัพธ์ แต่จะไม่ส่งคืนผลลัพธ์ที่มีคุณภาพต่ำกว่า หากไม่ระบุ จะเทียบเท่ากับการจำกัดให้เป็นคุณภาพสูงเท่านั้น

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ Solar.FindClosestBuildingInsights ข้อมูลเกี่ยวกับสถานที่ตั้ง ขนาด และศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
ช่อง
name

string

ชื่อทรัพยากรอาคาร ในรูปแบบ building/<place ID>

center

object (LatLng)

จุดที่ใกล้กับศูนย์กลางของอาคาร

boundingBox

object (LatLngBox)

กรอบล้อมรอบของอาคาร

imageryDate

object (Date)

วันที่ได้รับภาพที่เกี่ยวข้อง ค่านี้เป็นค่าโดยประมาณ

imageryProcessedDate

object (Date)

เมื่อการประมวลผลภาพนี้เสร็จสมบูรณ์

postalCode

string

รหัสไปรษณีย์ (เช่น รหัสไปรษณีย์ของสหรัฐอเมริกา) ของอาคารแห่งนี้

administrativeArea

string

เขตบริหาร 1 (เช่น ในสหรัฐอเมริกา รัฐ) ที่มีอาคารนี้ เช่น ในสหรัฐอเมริกา ตัวย่ออาจเป็น "MA" หรือ "CA"

statisticalArea

string

พื้นที่ทางสถิติ (เช่น ทางเดินสำมะโนประชากรของสหรัฐฯ) อาคารนี้อยู่

regionCode

string

รหัสภูมิภาคสำหรับประเทศ (หรือภูมิภาค) ของอาคารนี้

solarPotential

object (SolarPotential)

ศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร

imageryQuality

enum (ImageryQuality)

คุณภาพของภาพที่ใช้ในการคำนวณข้อมูลสำหรับอาคารนี้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

LatLngBox

กล่องขอบเขตในพิกัดละติจูด/ลองจิจูด

การแสดง JSON
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
ช่อง
sw

object (LatLng)

มุมตะวันตกเฉียงใต้ของกล่อง

ne

object (LatLng)

มุมตะวันออกเฉียงเหนือของกล่อง

SolarPotential

ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของอาคาร จำนวนช่องในส่วนนี้มีคำจำกัดความอยู่ในส่วน "แผง" ช่อง panelCapacityWatts, panelHeightMeters และ panelWidthMeters อธิบายพารามิเตอร์ของโมเดลแผงที่ใช้ในการคำนวณเหล่านี้

การแสดง JSON
{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
ช่อง
maxArrayPanelsCount

integer

ขนาดของอาร์เรย์สูงสุด ซึ่งก็คือจำนวนสูงสุดของแผงที่สามารถวางบนหลังคาได้

panelCapacityWatts

number

ความจุในหน่วยวัตต์ของแผงที่ใช้ในการคำนวณ

panelHeightMeters

number

ความสูงเป็นเมตรในแนวตั้งของแผงที่ใช้ในการคำนวณ

panelWidthMeters

number

ความกว้างเป็นหน่วยเมตรในการวางแนวแนวตั้งของแผงที่ใช้ในการคำนวณ

panelLifetimeYears

integer

อายุการใช้งานที่คาดไว้ของแผงโซลาร์เซลล์ในหน่วยปี โดยใช้ในการคำนวณทางการเงิน

maxArrayAreaMeters2

number

ขนาดของอาร์เรย์สูงสุด หน่วยเป็นตารางเมตร

maxSunshineHoursPerYear

number

จำนวนชั่วโมงแสงแดดที่ได้รับสูงสุดต่อปี ตามจุดใดก็ได้บนหลังคา ชั่วโมงแสงแดดเป็นหน่วยวัดปริมาณความแห้งแล้งทั้งหมด (พลังงาน) ที่ได้รับต่อปี 1 ชั่วโมงแสงแดด = 1 กิโลวัตต์-ชั่วโมงต่อ kW (โดยที่ kW หมายถึงกิโลวัตต์ของความจุภายใต้เงื่อนไขการทดสอบมาตรฐาน)

carbonOffsetFactorKgPerMwh

number

ปริมาณ CO2 ที่ผลิตต่อไฟฟ้าจากระบบโครงข่ายไฟฟ้า (CO2) เทียบเท่าในหน่วยเมกะวัตต์-ชั่วโมง นี่คือการวัดความเข้มของคาร์บอนของไฟฟ้าจากโครงข่ายไฟฟ้าที่ทดแทนด้วยไฟฟ้าพลังงานแสงอาทิตย์

wholeRoofStats

object (SizeAndSunshineStats)

ขนาดโดยรวมและควอนไทล์แสงแดดสำหรับส่วนของหลังคาที่กำหนดให้ส่วนหลังคาบางส่วน ถึงแม้ว่าจะตั้งชื่อแล้ว แต่ภาพนี้อาจไม่รวมอาคารทั้งหลัง ดูbuildingStats

buildingStats

object (SizeAndSunshineStats)

ขนาดและควอนไทล์แสงแดดสำหรับทั้งอาคาร รวมถึงส่วนของหลังคาที่ไม่ได้กำหนดให้กับบางส่วนของหลังคา เนื่องจากการวางแนวของส่วนต่างๆ เหล่านี้มีลักษณะที่ไม่เหมาะสม การประมาณพื้นที่หลังคาจึงไม่น่าเชื่อถือ แต่การประมาณพื้นที่พื้นดินมีความน่าเชื่อถือ อาจเป็นไปได้ที่จะได้พื้นที่หลังคาของอาคารทั้งหมดที่เชื่อถือได้มากขึ้นโดยการปรับขนาดพื้นที่หลังคาจาก wholeRoofStats ตามอัตราส่วนพื้นที่พื้นดินของ buildingStats กับ wholeRoofStats

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

ขนาดและควอนไทล์แสงแดดสำหรับแต่ละส่วนของหลังคา

solarPanels[]

object (SolarPanel)

SolarPanel แต่ละอันอธิบายแผงโซลาร์เซลล์ 1 แผง แท็กเหล่านี้จะแสดงตามลำดับที่อัลกอริทึมเลย์เอาต์ของแผงวางไว้ ซึ่งโดยปกติมักจะเป็นปริมาณการผลิตพลังงานต่อปีที่ลดน้อยลง

solarPanelConfigs[]

object (SolarPanelConfig)

SolarPanelConfig แต่ละชิ้นอธิบายการจัดเรียงแผงโซลาร์เซลล์บนหลังคาที่แตกต่างกัน โดยจะมีจำนวนแผงมากขึ้นเรื่อยๆ SolarPanelConfig ที่มี panelsCount=N จะอิงตามแผงแรก N ในรายการ solarPanels ช่องนี้จะแสดงข้อมูลเฉพาะเมื่อมีอย่างน้อย 4 แผงติดตั้งบนหลังคาได้

financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis จะช่วยประหยัดค่าใช้จ่ายจากการใช้พลังงานแสงอาทิตย์โดยผ่านการเรียกเก็บเงินรายเดือนและผู้ให้บริการไฟฟ้ารายหนึ่งๆ โดยเรียงตามลำดับของจำนวนเงินที่เรียกเก็บรายเดือน ช่องนี้จะว่างเปล่าสำหรับอาคารในพื้นที่ที่ Solar API มีข้อมูลไม่เพียงพอที่จะคำนวณทางการเงิน

SizeAndSunshineStats

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

การแสดง JSON
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
ช่อง
areaMeters2

number

พื้นที่ของหลังคาหรือส่วนหลังคาในหน่วย m^2 นี่คือพื้นที่หลังคา (แสดงถึงการเอียง) ไม่ใช่พื้นที่ฟุตพริ้นท์

sunshineQuantiles[]

number

ปริมาณของแสงแดดแบบจุดๆ กระจายทั่วทั้งพื้นที่ หากมีค่า N ค่าที่นี่ ค่านี้จะแสดง (N-1)-ile เช่น หากมี 5 ค่า ค่าเหล่านั้นจะเป็นควอไทล์ (ต่ำสุด, 25%, 50%, 75%, สูงสุด) ค่าจะอยู่ในหน่วย kWh/kW รายปี เช่น maxSunshineHoursPerYear

groundAreaMeters2

number

พื้นที่รอยเท้าพื้นซึ่งครอบคลุมโดยหลังคาหรือส่วนของหลังคาในหน่วย m^2

RoofSegmentSizeAndSunshineStats

ข้อมูลเกี่ยวกับขนาดและควอนไทล์ของหลังคา

การแสดง JSON
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
ช่อง
stats

object (SizeAndSunshineStats)

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

center

object (LatLng)

จุดที่อยู่ใกล้กับกึ่งกลางของส่วนหลังคา

boundingBox

object (LatLngBox)

กรอบล้อมรอบของส่วนหลังคา

pitchDegrees

number

มุมของส่วนหลังคาที่สัมพันธ์กับระนาบพื้นดินทางทฤษฎี 0 = ขนานกับพื้น, 90 = ตั้งฉากกับพื้น

azimuthDegrees

number

ทิศทางเข็มทิศที่ส่วนหลังคาชี้เข้ามา 0 = เหนือ, 90 = ตะวันออก, 180 = ใต้ สำหรับส่วนของหลังคาที่เป็น "แนวราบ" (pitchDegrees ใกล้ 0 มาก) แอซิมัทไม่ใช่การกำหนดที่ดี ดังนั้นเพื่อความสอดคล้อง เราจึงกำหนดให้เป็น 0 (เหนือ)

planeHeightAtCenterMeters

number

ความสูงของระนาบส่วนหลังคาในหน่วยเมตรเหนือระดับน้ำทะเล ณ จุดที่กำหนดโดย center เมื่อใช้ร่วมกับระดับเสียง แอซิมัท และตำแหน่งศูนย์กลาง สิ่งนี้ก็จะกำหนดระนาบส่วนหลังคาได้เต็มที่

SolarPanel

Solar Panel จะอธิบายตำแหน่ง การวางแนว และการผลิตแผงโซลาร์เซลล์เดี่ยว ดูข้อมูลเกี่ยวกับพารามิเตอร์ของแผงได้ที่ช่อง panelHeightMeters, panelWidthMeters และ panelCapacityWatts ใน SolarPotential

การแสดง JSON
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
ช่อง
center

object (LatLng)

กึ่งกลางของแผง

orientation

enum (SolarPanelOrientation)

การวางแนวของแผง

yearlyEnergyDcKwh

number

ปริมาณแสงอาทิตย์ที่ใช้พลังงานแสงอาทิตย์ซึ่งเลย์เอาต์นี้ได้รับตลอดช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง

segmentIndex

integer

ดัชนีใน roofSegmentStats ของ RoofSegmentSizeAndSunshineStats ซึ่งตรงกับส่วนหลังคาที่แผงนี้วางอยู่

SolarPanelOrientation

การวางแนวแผงโซลาร์เซลล์ โดยจะต้องตีความตามแอซิมัทของส่วนหลังคาที่แผงวางอยู่

Enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED ไม่พบการวางแนวแผง
LANDSCAPE แผง LANDSCAPE มีขอบยาวตั้งฉากกับทิศทางแอซิมัสของส่วนหลังคาที่วางอยู่
PORTRAIT แผง PORTRAIT มีขอบยาวขนานกับทิศทางแอซิมัทของส่วนหลังคาที่วางอยู่

SolarPanelConfig

Solar PanelConfig จะอธิบายตำแหน่งของแผงโซลาร์เซลล์บนหลังคาโดยเฉพาะ

การแสดง JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
ช่อง
panelsCount

integer

จำนวนแผงทั้งหมด โปรดทราบว่าค่านี้ซ้ำซ้อนกับ (ผลรวมของ) ช่องที่เกี่ยวข้องใน roofSegmentSummaries

yearlyEnergyDcKwh

number

ปริมาณแสงอาทิตย์ที่เลย์เอาต์นี้ได้รับตลอดช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง โดยสมมติว่าแผงที่อธิบายไว้ข้างต้น

roofSegmentSummaries[]

object (RoofSegmentSummary)

ข้อมูลเกี่ยวกับการผลิตของแต่ละส่วนหลังคาที่มีแผงอย่างน้อย 1 แผงในเลย์เอาต์นี้ roofSegmentSummaries[i] อธิบายส่วนของหลังคาที่ i รวมถึงขนาด การผลิต และการวางแนวที่คาดไว้

RoofSegmentSummary

ข้อมูลเกี่ยวกับส่วนหลังคาของอาคาร โดยมีแผงบางส่วนวางอยู่บนส่วนนั้น

การแสดง JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
ช่อง
panelsCount

integer

จํานวนแผงทั้งหมดในกลุ่มนี้

yearlyEnergyDcKwh

number

ปริมาณพลังงานแสงอาทิตย์ของเลย์เอาต์ที่จับได้ในช่วง 1 ปีในหน่วย DC กิโลวัตต์-ชั่วโมง โดยสมมติว่าแผงที่อธิบายไว้ข้างต้น

pitchDegrees

number

มุมของส่วนหลังคาที่สัมพันธ์กับระนาบพื้นดินทางทฤษฎี 0 = ขนานกับพื้น, 90 = ตั้งฉากกับพื้น

azimuthDegrees

number

ทิศทางเข็มทิศที่ส่วนหลังคาชี้เข้ามา 0 = เหนือ, 90 = ตะวันออก, 180 = ใต้ สำหรับส่วนของหลังคาที่เป็น "แนวราบ" (pitchDegrees ใกล้ 0 มาก) แอซิมัทไม่ใช่การกำหนดที่ดี ดังนั้นเพื่อความสอดคล้อง เราจึงกำหนดให้เป็น 0 (เหนือ)

segmentIndex

integer

ดัชนีใน roofSegmentStats ของ RoofSegmentSizeAndSunshineStats ที่เกี่ยวข้อง

FinancialAnalysis

การวิเคราะห์ต้นทุนและประโยชน์ของเลย์เอาต์พลังงานแสงอาทิตย์ที่เหมาะสมที่สุดสำหรับขนาดค่าไฟหนึ่งๆ

การแสดง JSON
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
ช่อง
monthlyBill

object (Money)

ค่าไฟรายเดือนที่การวิเคราะห์นี้ถือว่าเป็น

defaultBill

boolean

นี่คือขนาดใบเรียกเก็บเงินที่เลือกเป็นการเรียกเก็บเงินเริ่มต้นสำหรับพื้นที่ที่อาคารนี้อยู่ไหม FinancialAnalysis 1 รายการใน BuildingSolarPotential ควรมีการตั้งค่า defaultBill

averageKwhPerMonth

number

จำนวนไฟฟ้าที่บ้านใช้ในเดือนโดยเฉลี่ย โดยคิดจากขนาดบิลและอัตราค่าไฟของท้องถิ่น

financialDetails

object (FinancialDetails)

ข้อมูลทางการเงินที่มีผลบังคับใช้ไม่ว่าจะใช้วิธีการชําระเงินใดก็ตาม

leasingSavings

object (LeasingSavings)

ต้นทุนและประโยชน์ของการเช่าแผงโซลาร์เซลล์

cashPurchaseSavings

object (CashPurchaseSavings)

ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์ด้วยเงินสด

financedPurchaseSavings

object (FinancedPurchaseSavings)

ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์โดยการจัดหาเงินทุนในการซื้อ

panelConfigIndex

integer

ดัชนีใน solarPanelConfigs ของเลย์เอาต์พลังงานแสงอาทิตย์ที่เหมาะสมที่สุดสําหรับขนาดใบเรียกเก็บเงินนี้ อาจเป็น -1 ซึ่งหมายความว่าไม่มีเลย์เอาต์ ในกรณีนี้ ระบบจะละเว้นข้อความย่อยที่เหลือ

เงินทอง

แสดงจำนวนเงินพร้อมประเภทสกุลเงิน

การแสดง JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
ช่อง
currencyCode

string

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217

units

string (int64 format)

หน่วยทั้งหมดของจำนวนเงิน เช่น หาก currencyCode คือ "USD" ก็ให้ 1 หน่วยเป็น 1 ดอลลาร์สหรัฐ

nanos

integer

จำนวนหน่วยนาโน (10^-9) ของปริมาตร ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก units เป็นค่าบวก nanos ต้องเป็นค่าบวกหรือ 0 หาก units เป็น 0 ค่า nanos อาจเป็นค่าบวก 0 หรือค่าลบก็ได้ หาก units เป็นค่าลบ nanos ต้องเป็นค่าลบหรือ 0 เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000

FinancialDetails

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

การแสดง JSON
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
ช่อง
initialAcKwhPerYear

number

มีกี่กิโลวัตต์-ชั่วโมงที่เราคิดว่าแผงโซลาร์เซลล์จะสร้างได้ในปีแรก

remainingLifetimeUtilityBill

object (Money)

ใบเรียกเก็บเงินค่าสาธารณูปโภคสำหรับไฟฟ้าที่ไม่ได้ผลิตโดยพลังงานแสงอาทิตย์ ตลอดอายุของแผงโซลาร์เซลล์

federalIncentive

object (Money)

จำนวนเงินที่ได้รับจากสิ่งจูงใจของรัฐบาลกลาง ใช้ได้เมื่อผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีการให้ยืม)

stateIncentive

object (Money)

จำนวนเงินที่ได้รับจากสิ่งจูงใจของรัฐ เงื่อนไขนี้จะมีผลหากผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีสินเชื่อ)

utilityIncentive

object (Money)

จำนวนเงินที่ได้รับจากสิ่งจูงใจด้านสาธารณูปโภค กรณีนี้ใช้ในกรณีที่ผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีสินเชื่อ)

lifetimeSrecTotal

object (Money)

จำนวนเงินที่ผู้ใช้จะได้รับจากเครดิตพลังงานแสงอาทิตย์หมุนเวียนตลอดอายุการใช้งานของแผงโซลาร์เซลล์ ข้อมูลนี้ใช้ในกรณีที่ผู้ใช้ซื้อแผง (โดยที่มีหรือไม่มีการให้ยืม)

costOfElectricityWithoutSolar

object (Money)

ต้นทุนทั้งหมดของไฟฟ้าที่ผู้ใช้จะต้องจ่ายตลอดอายุการใช้งานหากไม่ได้ติดตั้งพลังงานแสงอาทิตย์

netMeteringAllowed

boolean

อนุญาตการวัดสุทธิหรือไม่

solarPercentage

number

เปอร์เซ็นต์ (0-100) ของพลังงานของผู้ใช้ที่ใช้พลังงานแสงอาทิตย์ ใช้ได้สำหรับปีแรก แต่จะมีความถูกต้องโดยประมาณสำหรับปีต่อๆ ไป

percentageExportedToGrid

number

เปอร์เซ็นต์ (0-100) ของการผลิตไฟฟ้าพลังงานแสงอาทิตย์ที่เราคิดว่ามีการส่งออกไปยังระบบโครงข่ายไฟฟ้า โดยอิงจากการผลิตไฟฟ้าในไตรมาสแรก ซึ่งจะส่งผลต่อการคำนวณหากไม่อนุญาตให้มีการวัดปริมาณสุทธิ

LeasingSavings

ต้นทุนและประโยชน์ของการเช่าซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าที่เฉพาะเจาะจง

การแสดง JSON
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
ช่อง
leasesAllowed

boolean

อนุญาตให้ให้เช่าในเขตอำนาจศาลนี้ได้หรือไม่ (บางรัฐไม่อนุญาตให้มีการเช่าไม่ได้) หากช่องนี้เป็น "เท็จ" ระบบควรละเว้นค่าในข้อความนี้

leasesSupported

boolean

เครื่องมือคำนวณทางการเงินรองรับค่าเช่าในเขตอำนาจศาลนี้หรือไม่ หากช่องนี้เป็น "เท็จ" ระบบควรละเว้นค่าในข้อความนี้ ซึ่งไม่เกี่ยวข้องกับ leasesAllowed: บางพื้นที่มีการให้เช่าได้ แต่อยู่ภายใต้เงื่อนไขที่ไม่ได้จัดการโดยโมเดลทางการเงิน

annualLeasingCost

object (Money)

ค่าเช่ารายปีโดยประมาณ

savings

object (SavingsOverTime)

จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน

SavingsOverTime

ข้อมูลทางการเงินที่แชร์ระหว่างวิธีการชําระเงินต่างๆ

การแสดง JSON
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
ช่อง
savingsYear1

object (Money)

ค่าใช้จ่ายที่ประหยัดได้ในปีแรกหลังการติดตั้งแผง

savingsYear20

object (Money)

ค่าใช้จ่ายที่ประหยัดได้ในช่วง 20 ปีแรกหลังจากการติดตั้งแผง

presentValueOfSavingsYear20

object (Money)

เมื่อใช้อัตราส่วนลดที่คาดไว้ มูลค่าปัจจุบันของเงินออมสะสมในระยะเวลา 20 ปีคือเท่าใด

savingsLifetime

object (Money)

ค่าใช้จ่ายที่ประหยัดได้ตลอดอายุการใช้งานของแผง

presentValueOfSavingsLifetime

object (Money)

หากใช้อัตราส่วนลดที่คาดไว้ มูลค่าปัจจุบันของเงินออมสะสมตลอดอายุการใช้งานจะเป็นเท่าใด

financiallyViable

boolean

ระบุว่าสถานการณ์นี้มีโอกาสทางการเงินหรือไม่ เป็นเท็จในกรณีที่มีสถานะทางการเงินไม่ดี (เช่น มีภาวะเงินสูญหาย)

CashPurchaseSavings

ต้นทุนและประโยชน์ของการซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าแบบเจาะจง

การแสดง JSON
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
ช่อง
outOfPocketCost

object (Money)

ค่าใช้จ่ายเริ่มต้นก่อนสิ่งจูงใจทางภาษี: จำนวนที่ต้องชำระทันที ตรงข้ามกับ upfrontCost ซึ่งอยู่หลังสิ่งจูงใจทางภาษี

upfrontCost

object (Money)

ค่าใช้จ่ายเริ่มต้นหลังสิ่งจูงใจทางภาษี: จำนวนนี้ต้องชำระในปีแรก ตรงข้ามกับ outOfPocketCost ซึ่งอยู่ก่อนสิ่งจูงใจทางภาษี

rebateValue

object (Money)

มูลค่าของส่วนลดภาษีทั้งหมด

savings

object (SavingsOverTime)

จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน

paybackYears

number

จำนวนปีก่อนที่จะเกิดการคืนทุน ค่าติดลบหมายถึงการคืนทุนจะไม่เกิดขึ้นภายในตลอดอายุการใช้งาน

FinancedPurchaseSavings

ต้นทุนและประโยชน์ของการใช้เงินกู้เพื่อซื้อแผงโซลาร์เซลล์ที่มีการใช้พลังงานไฟฟ้าที่เฉพาะเจาะจง

การแสดง JSON
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
ช่อง
annualLoanPayment

object (Money)

การชำระสินเชื่อรายปี

rebateValue

object (Money)

มูลค่าของส่วนลดภาษีทั้งหมด (รวมถึง Federal Investment Tax Credit (ITC))

loanInterestRate

number

อัตราดอกเบี้ยสินเชื่อที่สันนิษฐานในการคำนวณชุดนี้

savings

object (SavingsOverTime)

จำนวนเงินที่ประหยัด (หรือไม่บันทึก) ตลอดอายุการใช้งาน