Method: buildingInsights.findClosest

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

enum (ImageryQuality)

Không bắt buộc. Mức chất lượng tối thiểu được phép trong kết quả. 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ề. Nếu không chỉ định, điều này tương đương với việc chỉ hạn chế ở chất lượng CAO.
exactQualityRequired

boolean

Không bắt buộc. Có yêu cầu chất lượng chính xác của hình ảnh hay không. Nếu bạn đặt thành false, trường requiredQuality sẽ được diễn giải là chất lượng tối thiểu bắt buộc, sao cho hình ảnh có chất lượng CAO có thể được trả về khi requiredQuality được đặt thành TRUNG BÌNH. Nếu được đặt thành true, requiredQuality sẽ được diễn giải là chất lượng chính xác cần thiết và chỉ hình ảnh chất lượng MEDIUM được trả về nếu requiredQuality được đặt thành MEDIUM.
experiments[]

enum (Experiment)

Không bắt buộc. Chỉ định các thử nghiệm giai đoạn trước khi phát hành rộng rãi cần bật. Các yêu cầu sử dụng trường này được phân loại là sản phẩm ở giai đoạn trước khi phát hành rộng rãi theo Điều khoản dành riêng cho dịch vụ của Google Maps Platform. Hãy xem mô tả giai đoạn ra mắt để biết thêm thông tin chi tiết.
additionalInsights[]

enum (AdditionalInsights)

Không bắt buộc. Danh sách additionalInsights sẽ được đưa vào phản hồi.

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 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),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
Trường
name

string

Tên tài nguyên của 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à giá trị ước tính.
imageryProcessedDate

object (Date)

Thời điểm xử lý xong hình ảnh này.
postalCode

string

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

string

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

string

Khu vực thống kê (ví dụ: khu điều tra dân số ở Hoa Kỳ) mà toà nhà này nằm trong.
regionCode

string

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

object (SolarPotential)

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

enum (ImageryQuality)

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

object (DetectedArrays)

Các mảng năng lượng mặt trời được phát hiện trên toà nhà. Trường này chỉ được điền sẵn nếu DETECTED_ARRAYS có trong FindClosestBuildingInsightsRequest.additional_insights của yêu cầu.

Phạm vi uỷ quyền

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

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

AdditionalInsights

Thông tin bổ sung về toà nhà, chẳng hạn như hình dạng mái nhà và các mảng tấm năng lượng mặt trời có thể được trả về trong BuildingInsights.

Enum
ADDITIONAL_INSIGHTS_UNSPECIFIED Giá trị mặc định. BuildingInsights mặc định sẽ được trả về.
DETECTED_ARRAYS

Xác định xem phản hồi có bao gồm các mảng được phát hiện hay không.

Nếu được chỉ định, trường detectedArrays sẽ được điền sẵn trong phản hồi.

LatLngBox

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 dưới cùng bên trái 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 xác định theo "bảng điều khiển". Các trường panelCapacityWatts, panelHeightMeters và panelWidthMeters mô tả các thông 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 đặt trên mái nhà.
panelCapacityWatts

number

Công suất (tính bằng watt) của tấm pin được dùng trong các phép tính.
panelHeightMeters

number

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

integer

Tuổi thọ dự kiến của các tấm pin mặt trời (tính bằng năm). 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ính theo mọi điểm 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 trên mỗi kW (trong đó kW là công suất theo Điều kiện kiểm tra 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à thước đo cường độ phát thải 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à lượng ánh sáng mặt trời theo phân vị cho phần mái nhà được chỉ định cho một đoạn mái nhà nào đó. Mặc dù có tên như vậy, nhưng có thể địa điểm này không bao gồm toàn bộ toà nhà. Vui lòng xem buildingStats.
buildingStats

object (SizeAndSunshineStats)

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 mái nhà chưa được chỉ định cho một số đoạn mái nhà. Vì hướng của các bộ phận này không được xác định rõ, nên thông tin ước tính về diện tích mái nhà là không đáng tin cậy, nhưng thông tin ước tính về diện tích mặt đất là đáng tin cậy. Có thể bạn sẽ có được diện tích mái nhà của 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 nhà từ wholeRoofStats theo tỷ lệ diện tích mặt đất của buildingStats và wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

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

object (SolarPanel)

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

object (SolarPanelConfig)

Mỗi SolarPanelConfig mô tả một cách bố trí khác nhau của các tấm pin mặt trời trên mái nhà. Các tấm pin này được sắp xếp theo thứ tự tăng dần về số lượng. 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ó thể lắp đặt ít nhất 4 tấm pin trên 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ử bạn có một hoá đơn hằng tháng và một nhà cung cấp điện cụ thể. Các gói này được sắp xếp theo thứ tự tăng dần của số tiền hoá đơn hằng tháng. Trường này sẽ trống đối với các toà nhà ở những khu vực mà Solar API không có đủ thông tin để thực hiện các phép tính tài chính.

SizeAndSunshineStats

Phân vị kích thước và độ nắng của một 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 của mái nhà hoặc đoạn mái nhà, tính bằng m^2. Đây là diện tích mái nhà (tính cả độ nghiêng), chứ không phải diện tích mặt bằng.
sunshineQuantiles[]

number

Phân vị của độ nắng tại từng điểm trên toàn khu vực. Nếu có N giá trị ở đây, thì điều này biểu thị (N-1) phân vị. 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 bằng kWh/kW mỗi năm, chẳng hạn như maxSunshineHoursPerYear.
groundAreaMeters2

number

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

RoofSegmentSizeAndSunshineStats

Thông tin về kích thước và các phân vị về độ nắng của một đ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 đoạn mái nhà.
center

object (LatLng)

Một điểm gần tâm của đoạn mái nhà.
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 nhà 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 chỉ. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với một đoạn mái "phẳng" (pitchDegrees rất gần 0), 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 tôi xác định phương vị một cách tuỳ ý là 0 (hướng Bắc).
planeHeightAtCenterMeters

number

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

SolarPanel

SolarPanel mô tả vị trí, hướng và sản lượng của một tấm năng lượng mặt trời. Hãy 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 điện một chiều.
segmentIndex

integer

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

SolarPanelOrientation

Hướng của tấm năng lượng mặt trời. Bạn phải diễn giải thông tin này theo phương vị của đoạn mái nhà mà tấm pin đượ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 Tấm LANDSCAPE có cạnh dài vuông góc với hướng phương vị của đoạn mái mà tấm này được đặt trên đó.
PORTRAIT Tấm PORTRAIT có cạnh dài song song với hướng phương vị của đoạn mái mà tấm đó được đặt lên.

SolarPanelConfig

SolarPanelConfig 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. Xin lưu ý rằng điều này là dư thừa đối 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 điện một chiều, giả sử các tấm pin như mô tả ở trên.
roofSegmentSummaries[]

object (RoofSegmentSummary)

Thông tin về việc sản xuất từng phân đoạn mái nhà có ít nhất một tấm pin trong bố cục này. roofSegmentSummaries[i] mô tả đoạn mái nhà 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 mái nhà trên toà nhà, với một số tấm pin đượ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 điện một chiều, giả sử các tấm pin như mô tả ở trên.
pitchDegrees

number

Góc của đoạn mái nhà 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 chỉ. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với một đoạn mái "phẳng" (pitchDegrees rất gần 0), 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 tôi xác định phương vị một cách tuỳ ý là 0 (hướng 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 bố cục năng lượng mặt trời tối ưu cho một quy mô 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

Đâ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. Bạn phải đặt defaultBill cho đúng một FinancialAnalysis trong BuildingSolarPotential.
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 quy mô 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.
leasingSavings

object (LeasingSavings)

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

object (CashPurchaseSavings)

Chi phí và lợi ích khi 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 năng lượng mặt trời bằng cách tài trợ cho giao dịch mua.
panelConfigIndex

integer

Chỉ số trong solarPanelConfigs của bố cục pin 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ã đơn vị tiền tệ gồm 3 chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Đơn vị số lượng nguyê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 (bao gồm cả hai số này). Nếu units là số dương, thì nanos phải là số dương hoặc 0. Nếu units bằng 0, thì nanos có thể là số dương, số 0 hoặc số âm. Nếu units là số âm, thì nanos phải là số âm hoặc 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à số tiền trong suốt thời gian được xác định bằng trường panelLifetimeYears trong SolarPotential. Lưu ý: Chi phí tự trả khi mua các tấm pin được nêu 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 điện xoay chiều mà chúng tôi cho rằng các tấm pin mặt trời sẽ tạo ra trong năm đầu tiên.
remainingLifetimeUtilityBill

object (Money)

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

object (Money)

Số tiền được hưởng từ các ưu đãi của chính phủ 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 hưởng 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 tấm pin.
utilityIncentive

object (Money)

Số tiền được hưởng từ các ưu đãi của công ty điện lực; đ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ừ 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 sử dụng tấm pin; điều này áp dụng nếu người dùng mua tấm pin (có hoặc không có khoản vay).
costOfElectricityWithoutSolar

object (Money)

Tổng chi phí điện mà người dùng sẽ 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ơ sở lưu trú có cho phép sử dụng cơ chế bù trừ điện năng hay không.
solarPercentage

number

Tỷ lệ phần trăm (0-100) điện nă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 những năm tiếp theo.
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 là được xuất vào lưới điện, dựa trên quý đầu tiên của sản lượng. Điều này ảnh hưởng đến các phép tính nếu cơ chế bù trừ điện nă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 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 có được phép cho thuê ở khu vực pháp lý này hay không (một số tiểu bang không cho phép cho thuê). Nếu trường này là false, thì bạn nên bỏ qua các giá trị trong thông báo này.
leasesSupported

boolean

Công cụ tính toán tài chính có hỗ trợ hợp đồng thuê ở khu vực tài phán này hay không. Nếu trường này là false, thì bạn nên bỏ qua các giá trị trong thông báo này. Điều này không phụ thuộc vào leasesAllowed: ở một số khu vực, hợp đồng thuê được cho phép nhưng phải tuân thủ các điều kiện không được xử lý bằng các mô hình tài chính.
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 tiết kiệm được) 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 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)

Khoản tiết kiệm trong năm đầu tiên sau khi lắp đặt tấm pin.
savingsYear20

object (Money)

Khoản tiết kiệm trong 20 năm đầu tiên sau khi lắp đặt tấm pin.
presentValueOfSavingsYear20

object (Money)

Với 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 được trong toàn bộ thời gian sử dụng của tấm pin.
presentValueOfSavingsLifetime

object (Money)

Với 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 thời gian sử dụng là bao nhiêu?
financiallyViable

boolean

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

CashPurchaseSavings

Chi phí và lợi ích của việc mua đứt một cấu hình cụ thể của tấm 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 
{
  "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 ưu đãi thuế: số tiền mà bạn phải tự chi trả. Ngược lại với upfrontCost, là sau khi áp dụng ưu đãi 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. Khác với outOfPocketCost là các ưu đãi trước thuế.
rebateValue

object (Money)

Giá trị của tất cả các khoản chiết khấu 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 sử dụng.
paybackYears

number

Số năm đế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 tồn tạ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 năng lượng mặt trời với mức tiêu thụ đ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 tiền vay hằng năm.
rebateValue

object (Money)

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

number

Lãi suất của các khoản vay được giả định trong bộ tính toán 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 sử dụng.

DetectedArrays

Thông tin về các mảng pin mặt trời được phát hiện trên toà nhà.

Biểu diễn dưới dạng JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
Trường
detectionStatus

enum (DetectionStatus)

Cho biết trạng thái phát hiện của các giàn pin mặt trời cho toà nhà này.
latestCaptureDate

object (Date)

Ngày cho biết thời điểm dữ liệu gần đây nhất về mảng năng lượng mặt trời được thu thập.

DetectionStatus

Cho biết trạng thái phát hiện của các giàn pin mặt trời cho toà nhà này.

Enum
DETECTION_STATUS_UNSPECIFIED Trạng thái không xác định.
DETECTION_STATUS_DATA_UNAVAILABLE Không có dữ liệu về giàn pin mặt trời được phát hiện cho toà nhà này.
DETECTION_STATUS_ARRAYS_DETECTED Đã phát hiện thấy ít nhất một giàn pin mặt trời cho toà nhà này.
DETECTION_STATUS_NO_ARRAYS_DETECTED Không phát hiện thấy giàn pin mặt trời nào cho toà nhà này.