Package google.maps.solar.v1

Chỉ mục

Năng lượng mặt trời

Định nghĩa dịch vụ cho API Năng lượng mặt trời.

FindClosestBuildingInsights

rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights)

Xác định toà nhà có tâm điể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 50m từ điểm truy vấn.

Phạm vi uỷ quyền

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

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

rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers)

Nhận thông tin về năng lượng mặt trời cho một khu vực xung quanh một vị trí. Trả về lỗi có mã NOT_FOUND nếu vị trí nằm ngoài khu vực phủ sóng.

Phạm vi uỷ quyền

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

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

rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody)

Trả về một hình ảnh theo mã nhận dạng của hình ảnh đó.

Phạm vi uỷ quyền

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

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

BuildingInsights

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à.

Trường
name

string

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

LatLng

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

LatLngBox

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

Date

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

Date

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

string

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

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".
statistical_area

string

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

string

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

SolarPotential

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

ImageryQuality

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

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ể.

Trường
out_of_pocket_cost

Money

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

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 out_of_pocket_cost, là trước khi có các khoản ưu đãi về thuế.
rebate_value

Money

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

SavingsOverTime

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

float

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.

DataLayerView

Tập hợp con thông tin về mặt trời cần trả về.

Enum
DATA_LAYER_VIEW_UNSPECIFIED Tương đương với FULL.
DSM_LAYER Chỉ tải DSM.
IMAGERY_LAYERS Lấy DSM, RGB và mặt nạ.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Nhận DSM, RGB, mặt nạ và luồng ánh sáng hằng năm.
IMAGERY_AND_ALL_FLUX_LAYERS Nhận DSM, RGB, mặt nạ, luồng ánh sáng hằng năm và luồng ánh sáng hằng tháng.
FULL_LAYERS Lấy tất cả dữ liệu.

DataLayers

Thông tin về tiềm năng năng lượng mặt trời của một khu vực. Dữ liệu thực tế nằm trong một số tệp GeoTIFF bao phủ khu vực được yêu cầu, trong đó thông báo này chứa các URL: Mỗi chuỗi trong thông báo DataLayers chứa một URL mà từ đó có thể tìm nạp GeoTIFF tương ứng. Những URL này có hiệu lực trong vài giờ sau khi được tạo. Hầu hết các tệp GeoTIFF đều có độ phân giải 0,1 m/pixel, nhưng tệp thông tin về luồng ánh sáng hằng tháng có độ phân giải 0,5 m/pixel và tệp thông tin về bóng râm hằng giờ có độ phân giải 1 m/pixel. Nếu bạn chỉ định giá trị pixel_size_meters trong GetDataLayersRequest, thì độ phân giải tối thiểu trong tệp GeoTIFF sẽ là giá trị đó.

Trường
imagery_date

Date

Thời điểm chụp ảnh nguồn (từ đó tất cả dữ liệu khác được lấy) ở khu vực này. Thời gian này có thể chỉ mang tính tương đối vì hình ảnh có thể được chụp trong nhiều ngày.
imagery_processed_date

Date

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

string

URL của hình ảnh DSM (Mô hình bề mặt kỹ thuật số) của khu vực. Các giá trị được tính bằng mét trên geoid EGM96 (tức là mực nước biển). Các vị trí không hợp lệ (nơi chúng tôi không có dữ liệu) được lưu trữ dưới dạng -9999.
rgb_url

string

URL của hình ảnh dữ liệu RGB (ảnh chụp trên không) của khu vực.
mask_url

string

URL của hình ảnh mặt nạ toà nhà: một bit cho mỗi pixel cho biết liệu pixel đó có được coi là một phần của mái nhà hay không.
annual_flux_url

string

URL của bản đồ cường độ bức xạ hằng năm (lượng ánh sáng mặt trời hằng năm trên mái nhà) của khu vực. Giá trị là kWh/kW/năm. Đây là lưu lượng không bị che: lưu lượng được tính toán cho mọi vị trí, chứ không chỉ mái nhà. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999: các vị trí nằm ngoài vùng phủ sóng của chúng tôi sẽ không hợp lệ và một số vị trí nằm trong vùng phủ sóng mà chúng tôi không thể tính toán luồng cũng sẽ không hợp lệ.
monthly_flux_url

string

URL của bản đồ cường độ bức xạ mặt trời hằng tháng (ánh sáng mặt trời chiếu vào mái nhà, được phân tích theo tháng) của khu vực. Giá trị là kWh/kW/năm. GeoTIFF được trỏ đến bằng URL này sẽ chứa 12 dải, tương ứng với tháng 1...tháng 12 theo thứ tự.
hourly_shade_urls[]

string

12 URL cho bóng giờ, tương ứng với tháng 1...tháng 12, theo thứ tự. Mỗi GeoTIFF sẽ chứa 24 dải, tương ứng với 24 giờ trong ngày. Mỗi pixel là một số nguyên 32 bit, tương ứng với (tối đa) 31 ngày trong tháng đó; 1 bit có nghĩa là vị trí tương ứng có thể nhìn thấy mặt trời vào ngày, giờ và tháng đó. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999 (vì giá trị này là âm, nên bit 31 được đặt và không có giá trị hợp lệ nào có thể đặt bit 31 vì giá trị đó sẽ tương ứng với ngày thứ 32 của tháng).

Sau đây là một ví dụ có thể hữu ích. Nếu muốn biết liệu một điểm (ở vị trí pixel (x, y)) có nhìn thấy mặt trời lúc 4 giờ chiều ngày 22 tháng 6 hay không, bạn sẽ:

  1. tìm nạp URL thứ sáu trong danh sách này (tương ứng với tháng 6).
  2. tra cứu kênh thứ 17 (tương ứng với 4 giờ chiều).
  3. đọc giá trị 32 bit tại (x, y).
  4. đọc bit 21 của giá trị (tương ứng với ngày 22 trong tháng).
  5. nếu bit đó là 1, thì vị trí đó đã nhìn thấy mặt trời lúc 4 giờ chiều ngày 22 tháng 6.

Chính thức hơn: Với month (1-12), day (1...tháng tối đa; tháng 2 có 28 ngày) và hour (0-23), bóng râm/mặt trời cho tháng/ngày/giờ đó ở vị trí (x, y) là bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

trong đó (x, y) là lập chỉ mục không gian, [month - 1] là tìm nạp URL month - 1st (lập chỉ mục từ 0), [hour] là lập chỉ mục vào các kênh và kết quả cuối cùng khác 0 có nghĩa là "có nắng". Không có ngày nhuận và không có giờ mùa hè (mọi ngày đều dài 24 giờ; buổi trưa luôn là buổi trưa theo "giờ chuẩn").
imagery_quality

ImageryQuality

Chất lượng hình ảnh của kết quả.

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ể.

Trường
annual_loan_payment

Money

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

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)).
loan_interest_rate

float

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

SavingsOverTime

Số tiền tiết kiệm được (hoặc không) trong suốt thời gian sử dụ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ể.

Trường
monthly_bill

Money

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

bool

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 default_bill.
average_kwh_per_month

float

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.
financial_details

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.
leasing_savings

LeasingSavings

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

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.
financed_purchase_savings

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.
panel_config_index

int32

Chỉ mục trong solar_panel_configs 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.

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 panel_lifetime_years 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 out_of_pocket_cost trong CashPurchaseSavings.

Trường
initial_ac_kwh_per_year

float

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.
remaining_lifetime_utility_bill

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.
federal_incentive

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.
state_incentive

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.
utility_incentive

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.
lifetime_srec_total

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.
cost_of_electricity_without_solar

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.
net_metering_allowed

bool

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

float

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.
percentage_exported_to_grid

float

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.

FindClosestBuildingInsightsRequest

Thông báo yêu cầu đối với Solar.FindClosestBuildingInsights.

Trường
location

LatLng

Bắt buộc. Kinh độ và vĩ độ mà API sẽ tìm kiếm tòa nhà đã biết gần nhất.
required_quality

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.

GetDataLayersRequest

Thông báo yêu cầu đối với Solar.GetDataLayers.

Trường
location

LatLng

Bắt buộc. Kinh độ và vĩ độ của trung tâm khu vực để lấy dữ liệu.
radius_meters

float

Bắt buộc. Bán kính, tính bằng mét, xác định vùng xung quanh điểm trung tâm mà dữ liệu sẽ được trả về. Các giới hạn đối với giá trị này là:

  • Bạn luôn có thể chỉ định bất kỳ giá trị nào lên đến 100 triệu.
  • Bạn có thể chỉ định các giá trị trên 100 triệu, miễn là radius_meters <= pixel_size_meters * 1000.
  • Tuy nhiên, đối với các giá trị trên 175 m, DataLayerView trong yêu cầu không được bao gồm thông tin về luồng ánh sáng hằng tháng hoặc bóng râm hằng giờ.
view

DataLayerView

Không bắt buộc. Tập hợp con dữ liệu mong muốn để trả về.
required_quality

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.
pixel_size_meters

float

Không bắt buộc. Tỷ lệ tối thiểu, tính bằng mét trên pixel, của dữ liệu cần trả về. Hệ thống hỗ trợ các giá trị 0,1 (mặc định, nếu bạn không đặt trường này một cách rõ ràng), 0,25, 0,5 và 1,0. Các thành phần hình ảnh có độ phân giải thông thường nhỏ hơn pixel_size_meters sẽ được trả về ở độ phân giải do pixel_size_meters chỉ định; các thành phần hình ảnh có độ phân giải thông thường bằng hoặc lớn hơn pixel_size_meters sẽ được trả về ở độ phân giải thông thường đó.
exact_quality_required

bool

Không bắt buộc. Liệu 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 giá trị này thành false, trường required_quality sẽ được diễn giải là chất lượng tối thiểu bắt buộc, chẳng hạn như hình ảnh có chất lượng CAO có thể được trả về khi bạn đặt required_quality thành MEDIUM. Nếu được đặt thành true, required_quality sẽ được hiểu là chất lượng cần thiết chính xác và chỉ hình ảnh chất lượng MEDIUM mới được trả về nếu required_quality được đặt thành MEDIUM.

GetGeoTiffRequest

Thông báo yêu cầu đối với Solar.GetGeoTiff.

Trường
id

string

Bắt buộc. Mã của thành phần đang được yêu cầu.

ImageryQuality

Chất lượng của hình ảnh dùng để tính toán một số kết quả API.

Lưu ý: Bất kể cấp chất lượng hình ảnh, đầu ra DSM luôn có độ phân giải là 0,1 m/pixel, đầu ra luồng hàng tháng luôn có độ phân giải là 0,5 m/pixel và đầu ra bóng mỗi giờ luôn có độ phân giải là 1 m/pixel.

Enum
IMAGERY_QUALITY_UNSPECIFIED Không xác định được chất lượng.
HIGH Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh chụp từ trên cao ở độ cao thấp và được xử lý ở tỷ lệ 0,1 m/pixel.
MEDIUM Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh chụp từ trên cao được nâng cao, chụp ở độ cao lớn và được xử lý ở tỷ lệ 0,25 m/pixel.
LOW Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh vệ tinh nâng cao được xử lý ở tỷ lệ 0,25 m/pixel.
BASE Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh vệ tinh nâng cao được xử lý ở tỷ lệ 0,25 m/pixel.

LatLngBox

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

Trường
sw

LatLng

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

LatLng

Góc đông bắc của hộ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 mặt trời với mức sử dụng điện cụ thể.

Trường
leases_allowed

bool

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.
leases_supported

bool

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 leases_allowed: ở 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ý.
annual_leasing_cost

Money

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

SavingsOverTime

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

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à.

Trường
stats

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

LatLng

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

LatLngBox

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

float

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.
azimuth_degrees

float

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" (pitch_degrees 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ỳ ý.
plane_height_at_center_meters

float

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.

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 đó.

Trường
panels_count

int32

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

float

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.
pitch_degrees

float

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.
azimuth_degrees

float

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" (pitch_degrees 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ỳ ý.
segment_index

int32

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

SavingsOverTime

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

Trường
savings_year1

Money

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

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.
present_value_of_savings_year20

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?
savings_lifetime

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.
present_value_of_savings_lifetime

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?
financially_viable

bool

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ỗ).

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à.

Trường
area_meters2

float

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.
sunshine_quantiles[]

float

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ư max_sunshine_hours_per_year.
ground_area_meters2

float

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

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 panel_height_meters, panel_width_meters và panel_capacity_watts trong SolarPotential để biết thông tin về các tham số của bảng điều khiển.

Trường
center

LatLng

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

SolarPanelOrientation

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

float

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.
segment_index

int32

Chỉ mục trong roof_segment_stats 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 đó.

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à.

Trường
panels_count

int32

Tổng số bảng điều khiển. Xin lưu ý rằng giá trị này không cần thiết đối với (tổng của) các trường tương ứng trong roof_segment_summaries.
yearly_energy_dc_kwh

float

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.
roof_segment_summaries[]

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. roof_segment_summaries[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.

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 đó.

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 panel_capacity_watts, panel_height_meters và panel_width_meters 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.

Trường
max_array_panels_count

int32

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à.
panel_capacity_watts

float

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.
panel_height_meters

float

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.
panel_width_meters

float

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.
panel_lifetime_years

int32

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.
max_array_area_meters2

float

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

float

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).
carbon_offset_factor_kg_per_mwh

float

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.
whole_roof_stats

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 building_stats.
building_stats

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 có thể lấy đượ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ừ whole_roof_stats theo tỷ lệ diện tích mặt đất của building_stats và whole_roof_stats.
roof_segment_stats[]

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à.
solar_panels[]

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. Mặc dù không phải lúc nào cũng vậy, nhưng thứ tự này thường giảm dần theo sản lượng năng lượng hằng năm.
solar_panel_configs[]

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 panels_count=N dựa trên N bảng điều khiển đầu tiên trong danh sách solar_panels. 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à.
financial_analyses[]

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.