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 kWh ต่อ kW (โดย kW หมายถึง kW ของความจุภายใต้เงื่อนไขการทดสอบมาตรฐาน)
carbonOffsetFactorKgPerMwh

number

ปริมาณ CO2 ที่ผลิตได้ต่อ MWh ของไฟฟ้าในระบบโครงข่ายจ่ายไฟฟ้า ซึ่งเป็นการวัดความเข้มของคาร์บอนจากไฟฟ้าในโครงข่ายที่ถูกแทนที่ด้วยไฟฟ้าจากพลังงานแสงอาทิตย์
wholeRoofStats

object (SizeAndSunshineStats)

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

object (SizeAndSunshineStats)

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

object (RoofSegmentSizeAndSunshineStats)

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

object (SolarPanel)

SolarPanel แต่ละรายการจะอธิบายแผงโซลาร์เซลล์แผงเดียว โดยจะแสดงตามลำดับที่อัลกอริทึมเลย์เอาต์แผงวางไว้ ซึ่งโดยปกติแล้วจะเรียงตามลำดับการผลิตพลังงานประจำปีจากมากไปน้อย แต่ก็ไม่เสมอไป
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

พื้นที่ของหลังคาหรือส่วนของหลังคาในหน่วย ตร.ม. นี่คือพื้นที่หลังคา (พิจารณาความเอียง) ไม่ใช่พื้นที่ฐานราก
sunshineQuantiles[]

number

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

number

พื้นที่รอยเท้าบนพื้นดินที่หลังคาหรือส่วนของหลังคาครอบคลุมในหน่วย ตร.ม.

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 เพียงรายการเดียว
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

จำนวน AC kWh ที่เราคิดว่าแผงโซลาร์เซลล์จะผลิตได้ในปีแรก
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),
  "arrays": [
    {
      object (SolarArray)
    }
  ],
  "latestCaptureDate": {
    object (Date)
  }
}
ช่อง
detectionStatus

enum (DetectionStatus)

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

object (SolarArray)

รายการแผงเซลล์แสงอาทิตย์ที่ตรวจพบบนอาคาร
latestCaptureDate

object (Date)

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

DetectionStatus

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

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

SolarArray

รายละเอียดของแผงโซลาร์เซลล์ที่ตรวจพบ 1 แผง

การแสดง JSON 
{
  "polygonGeojson": {
    object
  }
}
ช่อง
polygonGeojson

object (Struct format)

การแสดงผล GeoJSON ของพื้นที่อาคารที่ตรวจพบแผงโซลาร์เซลล์

ข้อมูล GeoJSON ต้องอยู่ในรูปแบบ RFC 7946 และแสดงรูปหลายเหลี่ยมสำหรับพื้นที่ติดกัน 1 แห่ง

รูปหลายเหลี่ยมจะแสดงด้วยลูปหลายลูปเมื่อมีรู

ตัวอย่าง

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }