Method: buildingInsights.findClosest

Xác định toà nhà gần điểm truy vấn nhất. Trả về lỗi có mã NOT_FOUND nếu không có toà nhà nào trong phạm vi khoảng 50m từ điểm truy vấn.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Tham số
location

object (LatLng)

Bắt buộc. Kinh độ và vĩ độ mà API dùng để tìm tòa nhà đã biết gần nhất.
requiredQuality

enum (ImageryQuality)

Không bắt buộc. Cấp chất lượng tối thiểu được phép trong kết quả. Hệ thống sẽ không trả về kết quả có chất lượng thấp hơn mức này. Việc không chỉ định thuộc tính này tương đương với việc chỉ cho phép chất lượng CAO.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho Solar.FindClosestBuildingInsights. Thông tin về vị trí, kích thước và tiềm năng năng lượng mặt trời của một toà nhà.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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)
}
Trường
name

string

Tên tài nguyên cho toà nhà, có định dạng buildings/{place_id}.
center

object (LatLng)

Một điểm gần trung tâm của toà nhà.
boundingBox

object (LatLngBox)

Hộp giới hạn của toà nhà.
imageryDate

object (Date)

Ngày thu thập hình ảnh cơ bản. Đây là số liệu ước tính.
imageryProcessedDate

object (Date)

Thời điểm hoàn tất quá trình xử lý hình ảnh này.
postalCode

string

Mã bưu chính (ví dụ: Mã bưu chính của Hoa Kỳ) của toà nhà này.
administrativeArea

string

Khu vực hành chính 1 (ví dụ: tiểu bang ở Hoa Kỳ) có chứa toà nhà này. Ví dụ: ở Hoa Kỳ, chữ viết tắt có thể là "MA" hoặc "CA".
statisticalArea

string

Khu vực thống kê (ví dụ: Hoa Kỳ) nơi toà nhà này tọa lạc.
regionCode

string

Mã vùng của quốc gia (hoặc khu vực) nơi toà nhà này tọa lạc.
solarPotential

object (SolarPotential)

Tiềm năng năng lượng mặt trời của toà nhà.
imageryQuality

enum (ImageryQuality)

Chất lượng hình ảnh dùng để tính toán dữ liệu cho toà nhà này.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

LatLngBox

Hộp giới hạn theo toạ độ lat/lng.

Biểu diễn dưới dạng JSON 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Trường
sw

object (LatLng)

Góc tây nam của hộp.
ne

object (LatLng)

Góc đông bắc của hộp.

SolarPotential

Thông tin về tiềm năng năng lượng mặt trời của một toà nhà. Một số trường trong phần này được xác định theo "bảng điều khiển". Các trường panelCapacityWatts, panelHeightMeters và panelWidthMeters mô tả các tham số của mô hình bảng điều khiển được dùng trong các phép tính này.

Biểu diễn dưới dạng 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)
    }
  ]
}
Trường
maxArrayPanelsCount

integer

Kích thước của mảng tối đa – tức là số lượng tấm pin tối đa có thể lắp trên mái nhà.
panelCapacityWatts

number

Dung lượng (tính bằng watt) của bảng điều khiển được dùng trong quá trình tính toán.
panelHeightMeters

number

Chiều cao (tính bằng mét theo hướng dọc) của bảng điều khiển được dùng trong quá trình tính toán.
panelWidthMeters

number

Chiều rộng (tính bằng mét theo hướng dọc) của bảng điều khiển được dùng trong quá trình tính toán.
panelLifetimeYears

integer

Tuổi thọ dự kiến (tính bằng năm) của tấm pin mặt trời. Giá trị này được dùng trong các phép tính tài chính.
maxArrayAreaMeters2

number

Kích thước (tính bằng mét vuông) của mảng tối đa.
maxSunshineHoursPerYear

number

Số giờ nắng tối đa nhận được mỗi năm, tại bất kỳ điểm nào trên mái nhà. Số giờ nắng là thước đo tổng lượng bức xạ mặt trời (năng lượng) nhận được mỗi năm. 1 giờ nắng = 1 kWh/kW (trong đó kW là công suất kW trong Điều kiện thử nghiệm tiêu chuẩn).
carbonOffsetFactorKgPerMwh

number

Lượng CO2 tương đương được tạo ra trên mỗi MWh điện lưới. Đây là chỉ số đo lường cường độ carbon của điện lưới được thay thế bằng điện mặt trời.
wholeRoofStats

object (SizeAndSunshineStats)

Tổng kích thước và các phân vị ánh sáng mặt trời cho phần mái nhà được chỉ định cho một số phân đoạn mái. Mặc dù có tên là "toà nhà", nhưng địa điểm này có thể không bao gồm toàn bộ toà nhà. Vui lòng xem buildingStats.
buildingStats

object (SizeAndSunshineStats)

Kích thước và các phân vị ánh sáng mặt trời cho toàn bộ toà nhà, bao gồm cả các phần mái không được chỉ định cho một số phân khúc mái. Do hướng của các phần này không được xác định rõ ràng, nên kết quả ước tính diện tích mái không đáng tin cậy, nhưng kết quả ước tính diện tích mặt đất thì đáng tin cậy. Có thể bạn sẽ có được diện tích mái nhà toàn bộ toà nhà đáng tin cậy hơn bằng cách điều chỉnh tỷ lệ diện tích mái nhà từ wholeRoofStats theo tỷ lệ diện tích mặt đất của buildingStats và wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Kích thước và các phân vị ánh sáng mặt trời cho mỗi phân đoạn mái nhà.
solarPanels[]

object (SolarPanel)

Mỗi SolarPanel mô tả một tấm pin mặt trời. Các thành phần này được liệt kê theo thứ tự mà thuật toán bố cục bảng điều khiển đã đặt. Thứ tự này thường (nhưng không phải lúc nào cũng) giảm dần theo sản lượng năng lượng hằng năm.
solarPanelConfigs[]

object (SolarPanelConfig)

Mỗi SolarPanelConfig mô tả một cách sắp xếp khác nhau của các tấm pin năng lượng mặt trời trên mái nhà. Các chế độ này được sắp xếp theo thứ tự tăng dần số lượng bảng điều khiển. SolarPanelConfig với panelsCount=N dựa trên N bảng điều khiển đầu tiên trong danh sách solarPanels. Trường này chỉ được điền nếu ít nhất 4 tấm pin có thể lắp vừa trên một mái nhà.
financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis cho biết mức tiết kiệm khi sử dụng năng lượng mặt trời, giả sử có một hoá đơn hằng tháng và một nhà cung cấp điện nhất định. Các tài khoản được sắp xếp theo thứ tự tăng dần của số tiền trên hoá đơn hằng tháng. Trường này sẽ trống đối với những toà nhà ở những khu vực mà API Năng lượng mặt trời không có đủ thông tin để thực hiện các phép tính tài chính.

SizeAndSunshineStats

Kích thước và các phân vị về mức độ nắng của mái nhà hoặc một phần của mái nhà.

Biểu diễn dưới dạng JSON 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Trường
areaMeters2

number

Diện tích của mái hoặc đoạn mái, tính bằng m^2. Đây là diện tích mái nhà (có tính đến độ nghiêng), chứ không phải diện tích mặt đất.
sunshineQuantiles[]

number

Các tứ phân vị của mức độ nắng tại một điểm trên khu vực. Nếu có N giá trị ở đây, thì giá trị này đại diện cho (N-1)-iles. Ví dụ: nếu có 5 giá trị, thì đó sẽ là các tứ phân vị (tối thiểu, 25%, 50%, 75%, tối đa). Các giá trị được tính theo kWh/kW hằng năm như maxSunshineHoursPerYear.
groundAreaMeters2

number

Diện tích mặt đất mà mái hoặc đoạn mái che phủ, tính bằng m^2.

RoofSegmentSizeAndSunshineStats

Thông tin về kích thước và các phân vị về mức độ nắng của một phân đoạn mái nhà.

Biểu diễn dưới dạng JSON 
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Trường
stats

object (SizeAndSunshineStats)

Tổng kích thước và các phân vị ánh sáng mặt trời cho phân khúc mái nhà.
center

object (LatLng)

Một điểm gần tâm của đoạn mái.
boundingBox

object (LatLngBox)

Hộp giới hạn của đoạn mái.
pitchDegrees

number

Góc của đoạn mái so với mặt phẳng mặt đất lý thuyết. 0 = song song với mặt đất, 90 = vuông góc với mặt đất.
azimuthDegrees

number

Hướng la bàn mà đoạn mái đang chỉ đến. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với một phân đoạn mái "phẳng" (pitchDegrees rất gần 0), góc phương vị không được xác định rõ ràng, vì vậy, để đảm bảo tính nhất quán, chúng ta sẽ xác định góc phương vị này là 0 (Bắc) một cách tuỳ ý.
planeHeightAtCenterMeters

number

Chiều cao của mặt phẳng phân đoạn mái, tính bằng mét so với mực nước biển, tại điểm do center chỉ định. Cùng với độ dốc, góc phương vị và vị trí tâm, thông tin này xác định đầy đủ mặt phẳng của phân đoạn mái.

SolarPanel

SolarPanel mô tả vị trí, hướng và sản lượng của một tấm pin mặt trời. Xem các trường panelHeightMeters, panelWidthMeters và panelCapacityWatts trong SolarPotential để biết thông tin về các tham số của bảng điều khiển.

Biểu diễn dưới dạng JSON 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Trường
center

object (LatLng)

Trung tâm của bảng điều khiển.
orientation

enum (SolarPanelOrientation)

Hướng của bảng điều khiển.
yearlyEnergyDcKwh

number

Lượng năng lượng mặt trời mà bố cục này thu được trong một năm, tính bằng kWh DC.
segmentIndex

integer

Chỉ mục trong roofSegmentStats của RoofSegmentSizeAndSunshineStats tương ứng với phân đoạn mái mà bảng điều khiển này được đặt trên đó.

SolarPanelOrientation

Hướng của tấm pin năng lượng mặt trời. Giá trị này phải được diễn giải tương ứng với góc phương vị của đoạn mái mà bảng điều khiển được đặt trên đó.

Enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Không xác định được hướng của bảng điều khiển.
LANDSCAPE Bảng điều khiển LANDSCAPE có cạnh dài vuông góc với hướng phương vị của đoạn mái mà bảng điều khiển được đặt trên đó.
PORTRAIT Bảng điều khiển PORTRAIT có cạnh dài song song với hướng phương vị của phân đoạn mái mà bảng điều khiển được đặt trên đó.

SolarPanelConfig

SolarPanelConfig mô tả vị trí cụ thể của các tấm pin năng lượng mặt trời trên mái nhà.

Biểu diễn dưới dạng JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Trường
panelsCount

integer

Tổng số bảng điều khiển. Xin lưu ý rằng giá trị này là thừa so với (tổng của) các trường tương ứng trong roofSegmentSummaries.
yearlyEnergyDcKwh

number

Lượng năng lượng mặt trời mà bố cục này thu được trong một năm, tính bằng kWh DC, giả sử các tấm pin được mô tả ở trên.
roofSegmentSummaries[]

object (RoofSegmentSummary)

Thông tin về quá trình sản xuất từng phân đoạn mái chứa ít nhất một bảng điều khiển trong bố cục này. roofSegmentSummaries[i] mô tả phân đoạn mái thứ i, bao gồm kích thước, sản lượng dự kiến và hướng.

RoofSegmentSummary

Thông tin về một phân đoạn mái trên toà nhà, với một số tấm được đặt trên đó.

Biểu diễn dưới dạng JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Trường
panelsCount

integer

Tổng số bảng điều khiển trên phân khúc này.
yearlyEnergyDcKwh

number

Lượng năng lượng mặt trời mà phần bố cục này thu được trong một năm, tính bằng kWh DC, giả sử các tấm pin được mô tả ở trên.
pitchDegrees

number

Góc của đoạn mái so với mặt phẳng mặt đất lý thuyết. 0 = song song với mặt đất, 90 = vuông góc với mặt đất.
azimuthDegrees

number

Hướng la bàn mà đoạn mái đang chỉ đến. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với một phân đoạn mái "phẳng" (pitchDegrees rất gần 0), góc phương vị không được xác định rõ ràng, vì vậy, để đảm bảo tính nhất quán, chúng ta sẽ xác định góc phương vị này là 0 (Bắc) một cách tuỳ ý.
segmentIndex

integer

Chỉ mục trong roofSegmentStats của RoofSegmentSizeAndSunshineStats tương ứng.

FinancialAnalysis

Phân tích chi phí và lợi ích của bố cục pin mặt trời tối ưu cho một mức tiền điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
Trường
monthlyBill

object (Money)

Hoá đơn tiền điện hằng tháng mà bản phân tích này giả định.
defaultBill

boolean

Liệu đây có phải là kích thước hoá đơn được chọn làm hoá đơn mặc định cho khu vực mà toà nhà này nằm trong đó hay không. Chỉ có đúng một FinancialAnalysis trong BuildingSolarPotential được đặt defaultBill.
averageKwhPerMonth

number

Lượng điện mà ngôi nhà sử dụng trung bình mỗi tháng, dựa trên số tiền trên hoá đơn và giá điện tại địa phương.
financialDetails

object (FinancialDetails)

Thông tin tài chính áp dụng bất kể phương thức tài trợ được sử dụng.
leasingSavings

object (LeasingSavings)

Chi phí và lợi ích của việc thuê tấm pin năng lượng mặt trời.
cashPurchaseSavings

object (CashPurchaseSavings)

Chi phí và lợi ích của việc mua tấm pin năng lượng mặt trời bằng tiền mặt.
financedPurchaseSavings

object (FinancedPurchaseSavings)

Chi phí và lợi ích của việc mua tấm pin năng lượng mặt trời bằng hình thức tài trợ mua.
panelConfigIndex

integer

Chỉ mục trong solarPanelConfigs của bố cục năng lượng mặt trời tối ưu cho kích thước hoá đơn này. Giá trị này có thể là -1, cho biết không có bố cục nào. Trong trường hợp này, các thông báo phụ còn lại sẽ bị bỏ qua.

Tiền

Biểu thị một số tiền cùng với loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Trường
currencyCode

string

Mã tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Số nguyên của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị là 1 đô la Mỹ.
nanos

integer

Số lượng đơn vị nano (10^-9) của số tiền. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units dương, nanos phải dương hoặc bằng 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units âm, thì nanos phải âm hoặc bằng 0. Ví dụ: -1,75 đô la được biểu thị là units=-1 và nanos=-750.000.000.

FinancialDetails

Thông tin chi tiết về một bản phân tích tài chính. Một số thông tin chi tiết này đã được lưu trữ ở cấp cao hơn (ví dụ: chi phí tự trả). Tổng số tiền là trong một khoảng thời gian trọn đời do trường panelLifetimeYears trong SolarPotential xác định. Lưu ý: Chi phí thực tế để mua các bảng điều khiển được cung cấp trong trường outOfPocketCost trong CashPurchaseSavings.

Biểu diễn dưới dạng 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
}
Trường
initialAcKwhPerYear

number

Số kWh AC mà chúng tôi cho rằng các tấm pin năng lượng mặt trời sẽ tạo ra trong năm đầu tiên.
remainingLifetimeUtilityBill

object (Money)

Hoá đơn dịch vụ điện không phải do năng lượng mặt trời tạo ra, trong suốt thời gian hoạt động của tấm pin.
federalIncentive

object (Money)

Số tiền có sẵn từ các khoản ưu đãi của liên bang; điều này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
stateIncentive

object (Money)

Số tiền có sẵn từ các khoản ưu đãi của tiểu bang; điều này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
utilityIncentive

object (Money)

Số tiền có sẵn từ các khoản khuyến khích của công ty tiện ích; điều này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
lifetimeSrecTotal

object (Money)

Số tiền mà người dùng sẽ nhận được từ Khoản tín dụng năng lượng tái tạo từ năng lượng mặt trời trong suốt thời gian hoạt động của tấm pin; điều này áp dụng nếu người dùng mua (có hoặc không có khoản vay) tấm pin.
costOfElectricityWithoutSolar

object (Money)

Tổng chi phí điện mà người dùng phải trả trong suốt thời gian sử dụng nếu họ không lắp đặt hệ thống năng lượng mặt trời.
netMeteringAllowed

boolean

Cơ chế bù trừ điện năng có được phép hay không.
solarPercentage

number

Tỷ lệ phần trăm (0-100) năng lượng do năng lượng mặt trời cung cấp cho người dùng. Có hiệu lực trong năm đầu tiên nhưng gần đúng cho các năm sau.
percentageExportedToGrid

number

Tỷ lệ phần trăm (0-100) sản lượng điện mặt trời mà chúng tôi giả định đã được xuất vào lưới điện, dựa trên quý đầu tiên của quá trình sản xuất. Điều này ảnh hưởng đến kết quả tính toán nếu không cho phép cơ chế bù trừ điện năng.

LeasingSavings

Chi phí và lợi ích của việc thuê một cấu hình cụ thể của tấm pin mặt trời với mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Trường
leasesAllowed

boolean

Liệu hợp đồng thuê có được phép ở khu vực tài phán này hay không (một số tiểu bang không cho phép hợp đồng thuê). Nếu trường này có giá trị là false, thì các giá trị trong thông báo này có thể sẽ bị bỏ qua.
leasesSupported

boolean

Công cụ tính toán tài chính có hỗ trợ hợp đồng thuê trong khu vực tài phán này hay không. Nếu trường này có giá trị là false, thì các giá trị trong thông báo này có thể sẽ bị bỏ qua. Điều này độc lập với leasesAllowed: ở một số khu vực, hợp đồng thuê được cho phép, nhưng theo các điều kiện không được mô hình tài chính xử lý.
annualLeasingCost

object (Money)

Chi phí thuê ước tính hằng năm.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không) trong suốt thời gian sử dụng.

SavingsOverTime

Thông tin tài chính được chia sẻ giữa các phương thức tài trợ.

Biểu diễn dưới dạng JSON 
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Trường
savingsYear1

object (Money)

Khoản tiết kiệm trong năm đầu tiên sau khi lắp đặt bảng điều khiển.
savingsYear20

object (Money)

Khoản tiết kiệm trong 20 năm đầu tiên sau khi lắp đặt bảng điều khiển.
presentValueOfSavingsYear20

object (Money)

Sử dụng tỷ lệ chiết khấu giả định, giá trị hiện tại của khoản tiết kiệm tích luỹ trong 20 năm là bao nhiêu?
savingsLifetime

object (Money)

Số tiền tiết kiệm trong toàn bộ thời gian hoạt động của bảng điều khiển.
presentValueOfSavingsLifetime

object (Money)

Sử dụng tỷ lệ chiết khấu giả định, giá trị hiện tại của khoản tiết kiệm tích luỹ trong suốt cuộc đời là bao nhiêu?
financiallyViable

boolean

Cho biết liệu tình huống này có khả thi về mặt tài chính hay không. Sẽ là sai đối với các trường hợp có khả năng tài chính kém (ví dụ: thua lỗ).

CashPurchaseSavings

Chi phí và lợi ích của việc mua thẳng một cấu hình cụ thể của tấm pin mặt trời với mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Trường
outOfPocketCost

object (Money)

Chi phí ban đầu trước khi áp dụng ưu đãi thuế: số tiền phải trả bằng tiền mặt. Ngược với upfrontCost, là sau khi áp dụng các khoản ưu đãi về thuế.
upfrontCost

object (Money)

Chi phí ban đầu sau khi áp dụng ưu đãi thuế: đây là số tiền phải trả trong năm đầu tiên. Trái ngược với outOfPocketCost, là trước khi có các khoản ưu đãi về thuế.
rebateValue

object (Money)

Giá trị của tất cả khoản hoàn thuế.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không) trong suốt thời gian sử dụng.
paybackYears

number

Số năm cho đến khi hoàn vốn. Giá trị âm có nghĩa là thời gian hoàn vốn không bao giờ xảy ra trong khoảng thời gian trọn đời.

FinancedPurchaseSavings

Chi phí và lợi ích của việc sử dụng khoản vay để mua một cấu hình cụ thể của tấm pin mặt trời với mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Trường
annualLoanPayment

object (Money)

Khoản thanh toán hằng năm cho khoản vay.
rebateValue

object (Money)

Giá trị của tất cả khoản hoàn thuế (bao gồm cả Khoản tín dụng thuế đầu tư liên bang (ITC)).
loanInterestRate

number

Lãi suất của khoản vay được giả định trong tập hợp các phép tính này.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không) trong suốt thời gian sử dụng.