Method: buildingInsights.findClosest

Định vị toà nhà gần nhất với một điểm truy vấn. Trả về lỗi với mã NOT_FOUND nếu không có toà nhà nào trong phạm vi khoảng 50m tính 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 toà nhà gần nhất đã biết.
requiredQuality

enum (ImageryQuality)

Không bắt buộc. Mức chất lượng tối thiểu được cho phép trong các kết quả. Sẽ không có kết quả nào có chất lượng thấp hơn kết quả này được trả về. Việc không chỉ định điều này tương đương với việc chỉ giới hạn ở 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

Tin nhắn phản hồi cho Solar.FindClosestBuildingInsights. Thông tin về vị trí, kích thước và tiềm năng tạo 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 của toà nhà, ở định dạng building/<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 bên dưới. Đây là con số gần đúng.
imageryProcessedDate

object (Date)

Hình ảnh này đã được xử lý xong.
postalCode

string

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

string

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

string

Phạm vi thống kê (ví dụ: khu vực điều tra dân số của Hoa Kỳ) có toà nhà này.
regionCode

string

Mã vùng của quốc gia (hoặc khu vực) có toà nhà này.
solarPotential

object (SolarPotential)

Tiềm năng điện 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

Một hình hộp giới hạn theo toạ độ vĩ độ/kinh độ.

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 tạo 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 định nghĩa bằng thuật ngữ "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 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 tối đa có thể đặt vừa được trên mái nhà.
panelCapacityWatts

number

Công suất, tính bằng watt, của bảng điều khiển dùng trong các phép tính.
panelHeightMeters

number

Chiều cao, tính bằng mét theo hướng dọc, của bảng điều khiển dùng trong các phép tính.
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 các phép tính.
panelLifetimeYears

integer

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

number

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

number

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

number

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

object (SizeAndSunshineStats)

Tổng kích thước và số phân vị ánh sáng mặt trời cho phần mái được chỉ định cho một số phần mái. Tuy có tên như vậy nhưng hình ảnh này có thể không bao gồm toàn bộ toà nhà. Vui lòng xem buildingStats.
buildingStats

object (SizeAndSunshineStats)

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

object (RoofSegmentSizeAndSunshineStats)

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

object (SolarPanel)

Mỗi SolarPanel mô tả một bảng điều khiển năng lượng 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. Tỷ lệ này thường là giảm theo thứ tự sản xuất năng lượng hằng năm, mặc dù không phải lúc nào cũng vậy.
solarPanelConfigs[]

object (SolarPanelConfig)

Mỗi SolarPanelConfig mô tả một cách sắp xếp bảng điều khiển năng lượng mặt trời trên mái nhà. Những bảng này được sắp xếp theo thứ tự tăng dần số lượng bảng điều khiển. SolarPanelConfig có 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 sẵn nếu có ít nhất 4 bảng điều khiển có thể đặt vừa trên một mái nhà.
financialAnalyses[]

object (FinancialAnalysis)

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

SizeAndSunshineStats

Các số phân vị khả năng nắng và kích thước của mái nhà hoặc một phần 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 mái nhà 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), không phải diện tích đất xây dựng.
sunshineQuantiles[]

number

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

number

Diện tích đất xây dựng có mái che hoặc đoạn mái, tính bằng m^2.

RoofSegmentSizeAndSunshineStats

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

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à số phân vị ánh sáng mặt trời cho phân đoạn 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 nhà.
pitchDegrees

number

Góc của đoạn mái so với mặt phẳng 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 nhà đang trỏ tới. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với "phẳng" đoạn mái (pitchDegrees rất gần 0), góc phương vị không được xác định chính xác, do đó để tính nhất quán, ta tuỳ ý xác định giá trị này bằng 0 (Bắc).
planeHeightAtCenterMeters

number

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

SolarPanel

năng lượng mặt trời mô tả vị trí, hướng và quá trình sản xuất của một tấm pin năng lượng 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)

Ở giữ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 ánh sáng mặt trời mà bố cục này thu được trong một năm, tính bằng kWh.
segmentIndex

integer

Chỉ mục trong roofSegmentStats/RoofSegmentSizeAndSunshineStats tương ứng với đoạn mái nơi đặt bảng điều khiển này.

SolarPanelOrientation

Hướng của bảng điều khiển 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 nơi đặt bảng điều khiển.

Enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Chưa xác định hướng bảng điều khiển nào.
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 nơi đặt 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 đoạn mái nơi đặt nó.

SolarPanelConfig

năng lượng mặt trời PanelConfig mô tả 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. Lưu ý rằng điều này là thừa cho (tổng của) các trường tương ứng trong roofSegmentSummaries.
yearlyEnergyDcKwh

number

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

object (RoofSegmentSummary)

Thông tin về quá trình tạo từng đoạn mái có í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 nhà thứ i, bao gồm kích thước, hướng sản xuất và hướng sản xuất dự kiến.

RoofSegmentSummary

Thông tin về một phần mái của toà nhà, với một số tấm che đượ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 đoạn này.
yearlyEnergyDcKwh

number

Giả sử phần này của bố cục thu được bao nhiêu năng lượng ánh sáng mặt trời trong suốt một năm, tính bằng kWh, giả sử các bảng mô tả ở trên.
pitchDegrees

number

Góc của đoạn mái so với mặt phẳng 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 nhà đang trỏ tới. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với "phẳng" đoạn mái (pitchDegrees rất gần 0), góc phương vị không được xác định chính xác, do đó để tính nhất quán, ta tuỳ ý xác định giá trị này bằng 0 (Bắc).
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 việc bố trí giải pháp năng lượng mặt trời tối ưu cho một hoá đơn 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 của toà nhà này hay không. Đúng một FinancialAnalysis trong BuildingSolarPotential phải được đặt defaultBill.
averageKwhPerMonth

number

Lượng điện mà ngôi nhà sử dụng trong một tháng trung bình, dựa trên giá trị 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 chính được sử dụng là gì.
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 nguồn tài chính 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. Đâ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 con còn lại sẽ bị bỏ qua.

Tiền

Đại diện cho số tiền kèm theo 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ã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

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

integer

Số lượng nano (10^-9) đơn vị của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units là số dương thì nanos phải có giá trị dương hoặc 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc số âm. Nếu units là số âm thì nanos phải có giá trị âm hoặc 0. Ví dụ: $-1,75 được biểu thị dưới dạng 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 trong số này đã được lưu trữ ở mức cao hơn (ví dụ: chi phí tự trả). Tổng số tiền trong một khoảng thời gian toàn thời gian được xác định bằng trường panelLifetimeYears trong SolarPotential. Lưu ý: Chi phí tự trả khi mua những tấm pin này có 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 mặt trời sẽ tạo ra được trong năm đầu tiên.
remainingLifetimeUtilityBill

object (Money)

Hoá đơn dịch vụ tiện ích cho điện không phải do năng lượng mặt trời sản xuất ra, trong vòng đời của các tấm pin.
federalIncentive

object (Money)

Số tiền có được từ các ư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 bảng điều khiển.
stateIncentive

object (Money)

Số tiền có sẵn từ các ư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 bảng điều khiển.
utilityIncentive

object (Money)

Số tiền có sẵn từ các phần thưởng khuyến khích dịch vụ 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 bảng điều khiển.
lifetimeSrecTotal

object (Money)

Số tiền mà người dùng sẽ nhận được từ Tín dụng năng lượng tái tạo năng lượng mặt trời trong suốt thời gian hoạt động của bảng; đ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 bảng điều khiển.
costOfElectricityWithoutSolar

object (Money)

Tổng chi phí điện mà người dùng lẽ ra đã phải trả trong suốt vòng đời nếu họ không lắp đặt năng lượng mặt trời.
netMeteringAllowed

boolean

Liệu đo lường mạng có được cho phép hay không.
solarPercentage

number

Tỷ lệ phần trăm (0-100) công suất 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 trong tương lai.
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 ra lưới điện dựa trên sản lượng quý đầu tiên. Điều này sẽ ảnh hưởng đến các phép tính nếu định mức ròng không được phép.

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 năng lượng 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 pháp luật này có cho phép cho thuê hay không (không cho phép cho thuê ở một số tiểu bang). Nếu trường này là false (sai), thì các giá trị trong thông báo này có thể bị bỏ qua.
leasesSupported

boolean

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

object (Money)

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

object (SavingsOverTime)

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

SavingsOverTime

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

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)

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

object (Money)

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)

Khi 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)

Mức tiết kiệm trong toàn bộ vòng đời bảng điều khiển.
presentValueOfSavingsLifetime

object (Money)

Khi 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 vòng đời là bao nhiêu?
financiallyViable

boolean

Cho biết liệu tình huống này có khả thi về tài chính hay không. Giá trị này sẽ không đúng trong những tình huống có khả năng tài chính kém (ví dụ: mất tiền).

CashPurchaseSavings

Chi phí và lợi ích của việc mua hoàn toàn một cấu hình pin mặt trời cụ thể 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 ưu đãi thuế: số tiền phải được thanh toán tự trả. Trái ngược với upfrontCost, tức là sau ưu đãi thuế.
upfrontCost

object (Money)

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

object (Money)

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

object (SavingsOverTime)

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

number

Số năm cho đến khi việc hoàn trả tiền diễn ra. Giá trị âm có nghĩa là khoản hoàn trả không bao giờ xảy ra trong suốt vòng đời.

FinancedPurchaseSavings

Chi phí và lợi ích của việc vay tiền để mua một cấu hình pin mặt trời cụ thể 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)

Thanh toán khoản vay hằng năm.
rebateValue

object (Money)

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

number

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

object (SavingsOverTime)

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