Method: buildingInsights.findClosest

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

คำขอ HTTP

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

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

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

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

object (LatLng)

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

enum (ImageryQuality)

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

enum (Experiment)

ไม่บังคับ ระบุฟีเจอร์ก่อน GA ที่จะเปิดใช้

เนื้อความของคำขอ

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

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

ข้อความตอบกลับสำหรับ 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

ชื่อทรัพยากรของอาคารในรูปแบบ buildings/{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 kWh ต่อ kW (โดยที่ kW หมายถึงความจุ kW ภายใต้สภาพการทดสอบมาตรฐาน)
carbonOffsetFactorKgPerMwh

number

ปริมาณ CO2 ที่เทียบเท่าซึ่งเกิดจากไฟฟ้าในระบบโครงข่ายจ่ายไฟฟ้า 1 เมกะวัตต์ชั่วโมง ค่านี้เป็นมาตรวัดความหนาแน่นของคาร์บอนจากไฟฟ้าในระบบกริดที่แทนที่ด้วยไฟฟ้าจากแสงอาทิตย์
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)-iles เช่น หากมี 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

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

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

object (LatLng)

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

enum (SolarPanelOrientation)

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

number

ปริมาณพลังงานแสงอาทิตย์ที่ผังนี้ได้รับตลอดทั้งปีเป็นหน่วย DC kWh
segmentIndex

integer

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

SolarPanelOrientation

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

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

SolarPanelConfig

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

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

integer

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

number

ปริมาณพลังงานแสงอาทิตย์ที่รูปแบบนี้รับได้ตลอดทั้งปีในหน่วย DC kWh โดยสมมติว่าใช้แผงตามที่อธิบายไว้ข้างต้น
roofSegmentSummaries[]

object (RoofSegmentSummary)

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

RoofSegmentSummary

ข้อมูลเกี่ยวกับส่วนหลังคาของอาคารที่มีแผงวางอยู่จำนวนหนึ่ง

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

integer

จํานวนแผงทั้งหมดในส่วนนี้
yearlyEnergyDcKwh

number

ปริมาณพลังงานแสงอาทิตย์ที่ผังส่วนนี้ได้รับตลอดทั้งปีในหน่วย DC kWh โดยสมมติว่าใช้แผงตามที่อธิบายไว้ข้างต้น
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 ใน BuildingSolarPotential ควรมีการตั้งค่า defaultBill เพียง 1 รายการเท่านั้น
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

จำนวน kWh AC ที่เราคิดว่าแผงโซลาร์เซลล์จะผลิตในปีแรก
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)

มูลค่าของเงินคืนภาษีทั้งหมด (รวมถึงเครดิตภาษีเงินลงทุนของรัฐบาลกลาง (ITC))
loanInterestRate

number

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

object (SavingsOverTime)

ประหยัดค่าใช้จ่ายได้เท่าใด (หรือไม่ประหยัด) ตลอดระยะเวลาการใช้งาน