Indeks
Solar
(antarmuka)BuildingInsights
(pesan)CashPurchaseSavings
(pesan)DataLayerView
(enum)DataLayers
(pesan)FinancedPurchaseSavings
(pesan)FinancialAnalysis
(pesan)FinancialDetails
(pesan)FindClosestBuildingInsightsRequest
(pesan)GetDataLayersRequest
(pesan)GetGeoTiffRequest
(pesan)ImageryQuality
(enum)LatLngBox
(pesan)LeasingSavings
(pesan)RoofSegmentSizeAndSunshineStats
(pesan)RoofSegmentSummary
(pesan)SavingsOverTime
(pesan)SizeAndSunshineStats
(pesan)SolarPanel
(pesan)SolarPanelConfig
(pesan)SolarPanelOrientation
(enum)SolarPotential
(pesan)
Solar
Definisi layanan untuk Solar API.
FindClosestBuildingInsights |
---|
Menemukan bangunan yang centroidnya paling dekat dengan titik kueri. Menampilkan error dengan kode
|
GetDataLayers |
---|
Mendapatkan informasi surya untuk wilayah di sekitar lokasi. Menampilkan error dengan kode
|
GetGeoTiff |
---|
Menampilkan gambar berdasarkan ID-nya.
|
BuildingInsights
Pesan respons untuk Solar.FindClosestBuildingInsights
. Informasi tentang lokasi, dimensi, dan potensi tenaga surya bangunan.
Kolom | |
---|---|
name |
Nama resource untuk bangunan, dengan format |
center |
Titik di dekat pusat bangunan. |
bounding_box |
Kotak pembatas bangunan. |
imagery_date |
Tanggal saat gambar pokok diperoleh. Ini adalah perkiraan. |
imagery_processed_date |
Saat pemrosesan gambar ini selesai. |
postal_code |
Kode pos (misalnya, Kode pos AS) yang memuat bangunan ini. |
administrative_area |
Wilayah administratif 1 (misalnya, di AS, negara bagian) yang berisi bangunan ini. Misalnya, di Amerika Serikat, singkatannya mungkin "MA" atau "CA". |
statistical_area |
Area statistik (misalnya, Jalur sensus AS) tempat bangunan ini berada. |
region_code |
Kode wilayah untuk negara (atau wilayah) tempat gedung ini berada. |
solar_potential |
Potensi tenaga surya bangunan. |
imagery_quality |
Kualitas gambar yang digunakan untuk menghitung data untuk bangunan ini. |
CashPurchaseSavings
Biaya dan manfaat pembelian langsung konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Kolom | |
---|---|
out_of_pocket_cost |
Biaya awal sebelum insentif pajak: jumlah yang harus dibayar secara mandiri. Berbeda dengan |
upfront_cost |
Biaya awal setelah insentif pajak: jumlah yang harus dibayar selama tahun pertama. Berbeda dengan |
rebate_value |
Nilai semua potongan pajak. |
savings |
Jumlah yang disimpan (atau tidak) selama periode masa aktif. |
payback_years |
Jumlah tahun hingga pengembalian modal terjadi. Nilai negatif berarti pengembalian modal tidak pernah terjadi dalam periode masa aktif. |
DataLayerView
Subset informasi surya yang akan ditampilkan.
Enum | |
---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
Setara dengan FULL. |
DSM_LAYER |
Mendapatkan DSM saja. |
IMAGERY_LAYERS |
Mendapatkan DSM, RGB, dan mask. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Mendapatkan DSM, RGB, mask, dan fluks tahunan. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Mendapatkan DSM, RGB, mask, fluks tahunan, dan fluks bulanan. |
FULL_LAYERS |
Mendapatkan semua data. |
DataLayers
Informasi tentang potensi tenaga surya di suatu wilayah. Data sebenarnya terdapat dalam sejumlah file GeoTIFF yang mencakup wilayah yang diminta, yang URL-nya berisi pesan ini: Setiap string dalam pesan DataLayers
berisi URL tempat GeoTIFF yang sesuai dapat diambil. URL ini valid selama beberapa jam setelah dibuat. Sebagian besar file GeoTIFF memiliki resolusi 0,1 m/piksel, tetapi file fluks bulanan memiliki resolusi 0,5 m/piksel, dan file bayangan per jam memiliki resolusi 1 m/piksel. Jika nilai pixel_size_meters
ditentukan di GetDataLayersRequest
, resolusi minimum dalam file GeoTIFF akan menjadi nilai tersebut.
Kolom | |
---|---|
imagery_date |
Waktu pengambilan gambar sumber (tempat semua data lainnya berasal) di wilayah ini. Estimasi ini bersifat perkiraan, karena gambar mungkin diambil selama lebih dari satu hari. |
imagery_processed_date |
Saat pemrosesan gambar ini selesai. |
dsm_url |
URL untuk gambar DSM (Digital Surface Model) wilayah. Nilainya dinyatakan dalam meter di atas geoid EGM96 (yaitu, permukaan laut). Lokasi yang tidak valid (tempat kami tidak memiliki data) disimpan sebagai -9999. |
rgb_url |
URL untuk gambar data RGB (foto udara) wilayah. |
mask_url |
URL untuk gambar mask bangunan: satu bit per piksel yang menunjukkan apakah piksel tersebut dianggap sebagai bagian dari atap atau tidak. |
annual_flux_url |
URL untuk peta fluks tahunan (sinar matahari tahunan di atap) wilayah tersebut. Nilainya adalah kWh/kW/tahun. Ini adalah fluks yang tidak disamarkan: fluks dihitung untuk setiap lokasi, bukan hanya atap bangunan. Lokasi yang tidak valid disimpan sebagai -9999: lokasi di luar area cakupan kami akan tidak valid, dan beberapa lokasi di dalam area cakupan, tempat kami tidak dapat menghitung fluks, juga akan tidak valid. |
monthly_flux_url |
URL untuk peta fluks bulanan (sinar matahari di atap, yang diperinci menurut bulan) di wilayah tersebut. Nilainya adalah kWh/kW/tahun. GeoTIFF yang ditunjuk oleh URL ini akan berisi dua belas band, yang sesuai dengan Januari...Desember, secara berurutan. |
hourly_shade_urls[] |
Dua belas URL untuk bayangan per jam, yang sesuai dengan Januari...Desember, secara berurutan. Setiap GeoTIFF akan berisi 24 band, yang sesuai dengan 24 jam dalam sehari. Setiap piksel adalah bilangan bulat 32 bit, yang sesuai dengan (hingga) 31 hari dalam sebulan tersebut; 1 bit berarti lokasi yang sesuai dapat melihat matahari pada hari, jam, dan bulan tersebut. Lokasi yang tidak valid disimpan sebagai -9999 (karena negatif, bit 31 ditetapkan, dan tidak ada nilai valid yang dapat menetapkan bit 31 karena akan sesuai dengan hari ke-32 dalam sebulan). Contoh mungkin akan berguna. Jika ingin mengetahui apakah titik (di lokasi piksel (x, y)) melihat matahari pada pukul 16.00 pada 22 Juni, Anda harus:
Secara lebih formal: Dengan
dengan |
imagery_quality |
Kualitas gambar hasil. |
FinancedPurchaseSavings
Biaya dan manfaat penggunaan pinjaman untuk membeli konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Kolom | |
---|---|
annual_loan_payment |
Pembayaran pinjaman tahunan. |
rebate_value |
Nilai semua potongan pajak (termasuk Federal Investment Tax Credit (ITC)). |
loan_interest_rate |
Suku bunga pinjaman yang diasumsikan dalam kumpulan penghitungan ini. |
savings |
Jumlah yang disimpan (atau tidak) selama periode masa aktif. |
FinancialAnalysis
Analisis biaya dan manfaat tata letak surya yang optimal untuk ukuran tagihan listrik tertentu.
Kolom | |
---|---|
monthly_bill |
Tagihan listrik bulanan yang diasumsikan dalam analisis ini. |
default_bill |
Apakah ini adalah ukuran tagihan yang dipilih sebagai tagihan default untuk area tempat gedung ini berada. Tepat satu |
average_kwh_per_month |
Jumlah listrik yang digunakan rumah dalam sebulan rata-rata, berdasarkan jumlah tagihan dan tarif listrik lokal. |
financial_details |
Informasi keuangan yang berlaku terlepas dari metode pembiayaan yang digunakan. |
leasing_savings |
Biaya dan manfaat leasing panel surya. |
cash_purchase_savings |
Biaya dan manfaat membeli panel surya dengan uang tunai. |
financed_purchase_savings |
Biaya dan manfaat membeli panel surya dengan pembiayaan pembelian. |
panel_config_index |
Indeks di |
FinancialDetails
Detail analisis keuangan. Beberapa detail ini sudah disimpan di tingkat yang lebih tinggi (misalnya, biaya langsung). Total jumlah uang adalah selama periode masa aktif yang ditentukan oleh kolom panel_lifetime_years
di SolarPotential
. Catatan: Biaya pembelian panel secara langsung diberikan di kolom out_of_pocket_cost
di CashPurchaseSavings
.
Kolom | |
---|---|
initial_ac_kwh_per_year |
Jumlah kWh AC yang kami perkirakan akan dihasilkan oleh panel surya pada tahun pertamanya. |
remaining_lifetime_utility_bill |
Tagihan utilitas untuk listrik yang tidak dihasilkan oleh tenaga surya, selama masa pakai panel. |
federal_incentive |
Jumlah uang yang tersedia dari insentif federal; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
state_incentive |
Jumlah uang yang tersedia dari insentif negara bagian; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
utility_incentive |
Jumlah uang yang tersedia dari insentif utilitas; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
lifetime_srec_total |
Jumlah uang yang akan diterima pengguna dari Solar Renewable Energy Credits selama masa aktif panel; hal ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
cost_of_electricity_without_solar |
Total biaya listrik yang akan dibayar pengguna selama periode masa aktif jika mereka tidak menginstal panel surya. |
net_metering_allowed |
Apakah pengukuran bersih diizinkan. |
solar_percentage |
Persentase (0-100) daya pengguna yang disediakan oleh tenaga surya. Berlaku untuk tahun pertama, tetapi kira-kira benar untuk tahun-tahun mendatang. |
percentage_exported_to_grid |
Persentase (0-100) produksi listrik surya yang kami asumsikan diekspor ke jaringan, berdasarkan kuartal pertama produksi. Hal ini memengaruhi penghitungan jika pengukuran bersih tidak diizinkan. |
FindClosestBuildingInsightsRequest
Pesan permintaan untuk Solar.FindClosestBuildingInsights
.
Kolom | |
---|---|
location |
Wajib. Bujur dan lintang tempat API mencari bangunan terdekat yang diketahui. |
required_quality |
Opsional. Tingkat kualitas minimum yang diizinkan dalam hasil. Tidak ada hasil dengan kualitas yang lebih rendah dari ini yang akan ditampilkan. Jika tidak ditentukan, hal ini sama dengan membatasi kualitas ke TINGGI saja. |
GetDataLayersRequest
Pesan permintaan untuk Solar.GetDataLayers
.
Kolom | |
---|---|
location |
Wajib. Bujur dan lintang untuk bagian tengah wilayah yang akan mendapatkan data. |
radius_meters |
Wajib. Radius, dalam meter, yang menentukan wilayah di sekitar titik tengah yang datanya akan ditampilkan. Batasan pada nilai ini adalah:
|
view |
Opsional. Subset data yang diinginkan untuk ditampilkan. |
required_quality |
Opsional. Tingkat kualitas minimum yang diizinkan dalam hasil. Tidak ada hasil dengan kualitas yang lebih rendah dari ini yang akan ditampilkan. Jika tidak ditentukan, hal ini sama dengan membatasi kualitas ke TINGGI saja. |
pixel_size_meters |
Opsional. Skala minimum, dalam meter per piksel, dari data yang akan ditampilkan. Nilai 0,1 (default, jika kolom ini tidak ditetapkan secara eksplisit), 0,25, 0,5, dan 1,0 didukung. Komponen gambar yang resolusi normalnya kurang dari |
exact_quality_required |
Opsional. Apakah akan mewajibkan kualitas gambar yang tepat. Jika ditetapkan ke salah (false), kolom |
GetGeoTiffRequest
Pesan permintaan untuk Solar.GetGeoTiff
.
Kolom | |
---|---|
id |
Wajib. ID aset yang diminta. |
ImageryQuality
Kualitas gambar yang digunakan untuk menghitung beberapa hasil API.
Catatan: Terlepas dari tingkat kualitas gambar, output DSM selalu memiliki resolusi 0,1 m/piksel, output fluks bulanan selalu memiliki resolusi 0,5 m/piksel, dan output bayangan per jam selalu memiliki resolusi 1 m/piksel.
Enum | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
Kualitas tidak diketahui. |
HIGH |
Data surya berasal dari citra udara yang diambil pada ketinggian rendah dan diproses pada 0,1 m/piksel. |
MEDIUM |
Data surya berasal dari citra udara yang ditingkatkan yang diambil di dataran tinggi dan diproses pada 0,25 m/piksel. |
LOW |
Data surya berasal dari citra satelit yang ditingkatkan yang diproses pada 0,25 m/piksel. |
BASE |
Data surya berasal dari citra satelit yang ditingkatkan yang diproses pada 0,25 m/piksel. |
LatLngBox
Kotak pembatas dalam koordinat lintang/bujur.
LeasingSavings
Biaya dan manfaat menyewa konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Kolom | |
---|---|
leases_allowed |
Apakah sewa diizinkan di wilayah hukum ini (sewa tidak diizinkan di beberapa negara bagian). Jika kolom ini salah, nilai dalam pesan ini mungkin harus diabaikan. |
leases_supported |
Apakah sewa didukung di wilayah hukum ini oleh mesin penghitungan keuangan. Jika kolom ini salah, nilai dalam pesan ini mungkin harus diabaikan. Hal ini tidak bergantung pada |
annual_leasing_cost |
Perkiraan biaya sewa tahunan. |
savings |
Jumlah yang disimpan (atau tidak) selama periode masa aktif. |
RoofSegmentSizeAndSunshineStats
Informasi tentang ukuran dan kuantil keteduhan segmen atap.
Kolom | |
---|---|
stats |
Total ukuran dan kuantil sinar matahari untuk segmen atap. |
center |
Titik di dekat bagian tengah segmen atap. |
bounding_box |
Kotak pembatas segmen atap. |
pitch_degrees |
Sudut segmen atap relatif terhadap bidang tanah teoretis. 0 = sejajar dengan tanah, 90 = tegak lurus dengan tanah. |
azimuth_degrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap "datar" ( |
plane_height_at_center_meters |
Ketinggian bidang segmen atap, dalam meter di atas permukaan laut, pada titik yang ditetapkan oleh |
RoofSegmentSummary
Informasi tentang segmen atap di bangunan, dengan beberapa panel yang ditempatkan di atasnya.
Kolom | |
---|---|
panels_count |
Jumlah total panel di segmen ini. |
yearly_energy_dc_kwh |
Jumlah energi sinar matahari yang ditangkap bagian tata letak ini selama setahun, dalam kWh DC, dengan asumsi panel yang dijelaskan di atas. |
pitch_degrees |
Sudut segmen atap relatif terhadap bidang tanah teoretis. 0 = sejajar dengan tanah, 90 = tegak lurus dengan tanah. |
azimuth_degrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap "datar" ( |
segment_index |
Indeks di |
SavingsOverTime
Informasi keuangan yang dibagikan di antara berbagai metode pembiayaan.
Kolom | |
---|---|
savings_year1 |
Penghematan pada tahun pertama setelah pemasangan panel. |
savings_year20 |
Penghematan dalam dua puluh tahun pertama setelah pemasangan panel. |
present_value_of_savings_year20 |
Dengan menggunakan tingkat diskon yang diasumsikan, berapa nilai sekarang dari penghematan kumulatif selama 20 tahun? |
savings_lifetime |
Penghematan di seluruh masa aktif panel. |
present_value_of_savings_lifetime |
Dengan menggunakan tingkat diskon yang diasumsikan, berapa nilai sekarang dari penghematan kumulatif sepanjang waktu? |
financially_viable |
Menunjukkan apakah skenario ini layak secara finansial. Akan bernilai salah untuk skenario dengan kelayakan finansial yang buruk (misalnya, merugi). |
SizeAndSunshineStats
Ukuran dan kuantil keteduhan atap, atau bagian atap.
Kolom | |
---|---|
area_meters2 |
Luas atap atau segmen atap, dalam m^2. Ini adalah area atap (dengan mempertimbangkan kemiringan), bukan area jejak tanah. |
sunshine_quantiles[] |
Kuartil tingkat cerah titik di seluruh area. Jika ada nilai N di sini, nilai ini mewakili (N-1)-iles. Misalnya, jika ada 5 nilai, nilai tersebut akan menjadi kuartil (min, 25%, 50%, 75%, maks). Nilainya dalam kWh/kW tahunan seperti |
ground_area_meters2 |
Area jejak tanah yang tertutup oleh atap atau segmen atap, dalam m^2. |
SolarPanel
SolarPanel menjelaskan posisi, orientasi, dan produksi satu panel surya. Lihat kolom panel_height_meters
, panel_width_meters
, dan panel_capacity_watts
di SolarPotential
untuk mengetahui informasi tentang parameter panel.
Kolom | |
---|---|
center |
Bagian tengah panel. |
orientation |
Orientasi panel. |
yearly_energy_dc_kwh |
Jumlah energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam kWh DC. |
segment_index |
Indeks di |
SolarPanelConfig
SolarPanelConfig menjelaskan penempatan panel surya tertentu di atap.
Kolom | |
---|---|
panels_count |
Jumlah total panel. Perhatikan bahwa ini berlebihan untuk (jumlah) kolom yang sesuai di |
yearly_energy_dc_kwh |
Jumlah energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam kWh DC, dengan asumsi panel yang dijelaskan di atas. |
roof_segment_summaries[] |
Informasi tentang produksi setiap segmen atap yang membawa setidaknya satu panel dalam tata letak ini. |
SolarPanelOrientation
Orientasi panel surya. Ini harus ditafsirkan relatif terhadap azimuth segmen atap tempat panel ditempatkan.
Enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Tidak ada orientasi panel yang diketahui. |
LANDSCAPE |
Panel LANDSCAPE memiliki tepi panjang yang tegak lurus dengan arah azimuth segmen atap tempat panel tersebut ditempatkan. |
PORTRAIT |
Tepi panjang panel PORTRAIT sejajar dengan arah azimuth segmen atap tempat panel tersebut ditempatkan. |
SolarPotential
Informasi tentang potensi tenaga surya sebuah bangunan. Sejumlah kolom dalam hal ini ditentukan dalam istilah "panel". Kolom panel_capacity_watts
, panel_height_meters
, dan panel_width_meters
menjelaskan parameter model panel yang digunakan dalam penghitungan ini.
Kolom | |
---|---|
max_array_panels_count |
Ukuran array maksimum - yaitu, jumlah maksimum panel yang dapat muat di atap. |
panel_capacity_watts |
Kapasitas, dalam watt, panel yang digunakan dalam penghitungan. |
panel_height_meters |
Tinggi, dalam meter dalam orientasi potret, dari panel yang digunakan dalam penghitungan. |
panel_width_meters |
Lebar, dalam meter dalam orientasi potret, dari panel yang digunakan dalam penghitungan. |
panel_lifetime_years |
Masa aktif yang diharapkan, dalam tahun, dari panel surya. Nilai ini digunakan dalam penghitungan keuangan. |
max_array_area_meters2 |
Ukuran, dalam meter persegi, dari array maksimum. |
max_sunshine_hours_per_year |
Jumlah maksimum jam sinar matahari yang diterima per tahun, di setiap titik di atap. Jam sinar matahari adalah ukuran jumlah total insolasi (energi) yang diterima per tahun. 1 jam sinar matahari = 1 kWh per kW (dengan kW mengacu pada kapasitas kW dalam Kondisi Pengujian Standar). |
carbon_offset_factor_kg_per_mwh |
Jumlah CO2 yang dihasilkan per MWh listrik jaringan yang setara. Ini adalah ukuran intensitas karbon listrik jaringan yang tergantikan oleh listrik surya. |
whole_roof_stats |
Total ukuran dan kuantil sinar matahari untuk bagian atap yang ditetapkan ke beberapa segmen atap. Meskipun namanya demikian, ini mungkin tidak mencakup seluruh gedung. Lihat |
building_stats |
Ukuran dan kuantil sinar matahari untuk seluruh bangunan, termasuk bagian atap yang tidak ditetapkan ke beberapa segmen atap. Karena orientasi bagian-bagian ini tidak dikarakterisasi dengan baik, estimasi area atap tidak dapat diandalkan, tetapi estimasi area tanah dapat diandalkan. Mungkin area atap seluruh bangunan yang lebih andal dapat diperoleh dengan menskalakan area atap dari |
roof_segment_stats[] |
Ukuran dan kuantil sinar matahari untuk setiap segmen atap. |
solar_panels[] |
Setiap |
solar_panel_configs[] |
Setiap |
financial_analyses[] |
|