Method: buildingInsights.findClosest

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

คำขอ HTTP

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

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

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

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

object (LatLng)

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

enum (ImageryQuality)

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

boolean

ไม่บังคับ ว่าจะกำหนดให้ใช้คุณภาพที่แน่นอนของภาพหรือไม่ หากตั้งค่าเป็น "เท็จ" ระบบจะตีความฟิลด์ requiredQuality เป็นคุณภาพขั้นต่ำที่จำเป็น เพื่อให้ระบบอาจแสดงภาพที่มีคุณภาพสูงเมื่อตั้งค่า requiredQuality เป็น "ปานกลาง" หากตั้งค่าเป็น "จริง" ระบบจะตีความ requiredQuality เป็นคุณภาพที่ต้องการอย่างแน่นอน และจะแสดงผลภาพที่มีคุณภาพ MEDIUM เท่านั้นหากตั้งค่า requiredQuality เป็น MEDIUM
experiments[]

enum (Experiment)

ไม่บังคับ ระบุการทดสอบก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปที่จะเปิดใช้ คำขอที่ใช้ฟิลด์นี้จะถือเป็นข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูรายละเอียดเพิ่มเติมได้ที่คำอธิบายเกี่ยวกับระยะการเปิดตัว
additionalInsights[]

enum (AdditionalInsights)

ไม่บังคับ รายการ additionalInsights ที่จะรวมไว้ในการตอบกลับ

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

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

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

ข้อความตอบกลับสำหรับ 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),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
ช่อง
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)

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

object (DetectedArrays)

ตรวจพบแผงโซลาร์เซลล์บนอาคาร ฟิลด์นี้จะสร้างขึ้นก็ต่อเมื่อมี DETECTED_ARRAYS รวมอยู่ใน FindClosestBuildingInsightsRequest.additional_insights ของคำขอ

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

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

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

AdditionalInsights

ข้อมูลอาคารเพิ่มเติม เช่น รูปทรงหลังคาและอาร์เรย์แผงโซลาร์เซลล์ที่ส่งคืนได้ใน BuildingInsights

Enum
ADDITIONAL_INSIGHTS_UNSPECIFIED ค่าเริ่มต้น ระบบจะแสดง BuildingInsights เริ่มต้น
DETECTED_ARRAYS

กำหนดว่าการตอบกลับจะมีอาร์เรย์ที่ตรวจพบหรือไม่

หากระบุไว้ ระบบจะกรอกข้อมูลในช่อง detectedArrays ในการตอบกลับ

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 กิโลวัตต์ชั่วโมงต่อกิโลวัตต์ (โดยกิโลวัตต์หมายถึงกิโลวัตต์ของความจุภายใต้สภาวะการทดสอบมาตรฐาน)
carbonOffsetFactorKgPerMwh

number

ปริมาณ CO2 เทียบเท่าที่ผลิตต่อ MWh ของไฟฟ้าในกริด ซึ่งเป็นการวัดความเข้มของคาร์บอนจากไฟฟ้าในโครงข่ายที่ถูกแทนที่ด้วยไฟฟ้าจากพลังงานแสงอาทิตย์
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) เช่น หากมีค่า 5 ค่า ค่าเหล่านั้นจะเป็นควอไทล์ (ต่ำสุด 25%, 50%, 75%, สูงสุด) ค่าอยู่ในหน่วยกิโลวัตต์ชั่วโมง/กิโลวัตต์ต่อปี เช่น 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
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 โดยสมมติว่าใช้แผงตามที่อธิบายไว้ข้างต้น
roofSegmentSummaries[]

object (RoofSegmentSummary)

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

RoofSegmentSummary

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

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

integer

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

number

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

เราคิดว่าแผงโซลาร์เซลล์จะผลิตไฟฟ้ากระแสสลับได้กี่กิโลวัตต์ชั่วโมงในปีแรก
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)

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

DetectedArrays

ข้อมูลเกี่ยวกับอาร์เรย์พลังงานแสงอาทิตย์ที่ตรวจพบในอาคาร

การแสดง JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
ช่อง
detectionStatus

enum (DetectionStatus)

ระบุสถานะการตรวจจับแผงโซลาร์เซลล์สำหรับอาคารนี้
latestCaptureDate

object (Date)

วันที่ที่ระบุเวลาที่บันทึกข้อมูลอาร์เรย์พลังงานแสงอาทิตย์ล่าสุด

DetectionStatus

ระบุสถานะการตรวจจับอาร์เรย์พลังงานแสงอาทิตย์สำหรับอาคารนี้

Enum
DETECTION_STATUS_UNSPECIFIED สถานะที่ไม่ได้ระบุ
DETECTION_STATUS_DATA_UNAVAILABLE ไม่มีข้อมูลอาร์เรย์พลังงานแสงอาทิตย์ที่ตรวจพบสำหรับอาคารนี้
DETECTION_STATUS_ARRAYS_DETECTED ตรวจพบแผงโซลาร์เซลล์อย่างน้อย 1 ชุดสำหรับอาคารนี้
DETECTION_STATUS_NO_ARRAYS_DETECTED ไม่พบอาร์เรย์พลังงานแสงอาทิตย์สำหรับอาคารนี้