- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Uang
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Cobalah!
Mencari bangunan terdekat dengan titik kueri. Menampilkan error dengan kode NOT_FOUND
jika tidak ada bangunan dalam jarak sekitar 50 m dari titik kueri.
Permintaan HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
location |
Wajib. Bujur dan lintang tempat API mencari bangunan terdekat yang diketahui. |
requiredQuality |
Opsional. Tingkat kualitas minimum yang diizinkan dalam hasil. Tidak ada hasil dengan kualitas yang lebih rendah daripada yang akan ditampilkan. Tidak menentukan ini sama dengan membatasi ke kualitas TINGGI saja. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk Solar.FindClosestBuildingInsights
. Informasi tentang lokasi, dimensi, dan potensi tenaga surya suatu bangunan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "name": string, "center": { object ( |
Kolom | |
---|---|
name |
Nama fasilitas untuk gedung, dengan format |
center |
Titik di dekat pusat bangunan. |
boundingBox |
Kotak pembatas bangunan. |
imageryDate |
Tanggal citra yang mendasari diperoleh. Ini hanya perkiraan. |
imageryProcessedDate |
Ketika pemrosesan selesai pada citra ini. |
postalCode |
Kode pos (misalnya, kode pos AS) tempat bangunan ini berada. |
administrativeArea |
Wilayah administratif 1 (misalnya, di AS, negara bagian) yang berisi bangunan ini. Misalnya, di US, singkatannya mungkin "MA" atau "CA". |
statisticalArea |
Area statistik (mis., jalur sensus AS) tempat ini berada. |
regionCode |
Kode wilayah untuk negara (atau wilayah) tempat bangunan ini berada. |
solarPotential |
Potensi tenaga surya pada bangunan. |
imageryQuality |
Kualitas gambar yang digunakan untuk menghitung data untuk bangunan ini. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Kotak pembatas dalam koordinat lat/lng.
Representasi JSON |
---|
{ "sw": { object ( |
Kolom | |
---|---|
sw |
Sudut barat daya kotak. |
ne |
Sudut timur laut kotak. |
SolarPotential
Informasi tentang potensi tenaga surya suatu bangunan. Sejumlah kolom dalam hal ini didefinisikan dalam istilah "panel". Kolom panelCapacityWatts
, panelHeightMeters
, dan panelWidthMeters
menjelaskan parameter model panel yang digunakan dalam penghitungan ini.
Representasi JSON |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
Kolom | |
---|---|
maxArrayPanelsCount |
Ukuran susunan maksimum - yaitu, jumlah maksimum panel yang dapat diletakkan di atap. |
panelCapacityWatts |
Kapasitas, dalam watt, panel yang digunakan dalam penghitungan. |
panelHeightMeters |
Tinggi, dalam meter dalam orientasi potret, dari panel yang digunakan dalam penghitungan. |
panelWidthMeters |
Lebar panel yang digunakan dalam penghitungan, dalam meter dalam orientasi potret. |
panelLifetimeYears |
Masa pakai yang diharapkan, dalam bertahun-tahun, panel surya. Ini digunakan dalam perhitungan keuangan. |
maxArrayAreaMeters2 |
Ukuran array maksimum, dalam meter persegi. |
maxSunshineHoursPerYear |
Jumlah maksimum jam sinar matahari yang diterima per tahun, dari titik mana pun di atap. Jam sinar matahari adalah ukuran jumlah total insolasi (energi) yang diterima setiap tahun. 1 jam sinar matahari = 1 kWh per kW (di mana kW mengacu pada kW kapasitas dalam Kondisi Pengujian Standar). |
carbonOffsetFactorKgPerMwh |
Jumlah CO2 yang setara yang dihasilkan per MWh listrik jaringan. Ini adalah ukuran intensitas karbon jaringan listrik yang digantikan oleh listrik tenaga surya. |
wholeRoofStats |
Ukuran total dan kuantil sinar matahari untuk bagian atap yang ditetapkan ke beberapa segmen atap. Meskipun dinamai demikian, ini mungkin tidak menyertakan seluruh bangunan. Lihat |
buildingStats |
Kuantil ukuran dan sinar matahari untuk seluruh bangunan, termasuk bagian atap yang tidak ditetapkan ke beberapa segmen atap. Karena orientasi bagian-bagian tersebut tidak ditandai dengan baik, perkiraan luas atap tidak dapat diandalkan, tetapi perkiraan luas tanah dapat diandalkan. Mungkin seluruh area atap bangunan yang lebih andal dapat diperoleh dengan menskalakan area atap dari |
roofSegmentStats[] |
Ukuran dan kuantil sinar matahari untuk setiap segmen atap. |
solarPanels[] |
Setiap |
solarPanelConfigs[] |
Setiap |
financialAnalyses[] |
|
SizeAndSunshineStats
Kuantil ukuran dan sunyi atap, atau bagian dari atap.
Representasi JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Kolom | |
---|---|
areaMeters2 |
Luas segmen atap, dalam m^2. Ini adalah area atap (yang memperhitungkan kemiringan), bukan area jejak tanah. |
sunshineQuantiles[] |
Kuantile cahaya matahari yang tajam di seluruh area. Jika ada nilai N di sini, ini mewakili (N-1)-iles. Misalnya, jika ada 5 nilai, maka nilainya adalah kuartil (min, 25%, 50%, 75%, maks). Nilai dalam kWh/kW tahunan seperti |
groundAreaMeters2 |
Area jejak tanah yang ditutupi oleh segmen atap atau atap, dalam m^2. |
RoofSegmentSizeAndSunshineStats
Informasi tentang kuantil ukuran dan kuantil kegelapan segmen atap.
Representasi JSON |
---|
{ "stats": { object ( |
Kolom | |
---|---|
stats |
Ukuran total dan kuantil sinar matahari untuk segmen atap. |
center |
Titik di dekat bagian tengah segmen atap. |
boundingBox |
Kotak pembatas segmen atap. |
pitchDegrees |
Sudut segmen atap relatif terhadap bidang tanah secara teoritis. 0 = sejajar dengan permukaan tanah, 90 = tegak lurus dengan permukaan tanah |
azimuthDegrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap yang "datar" ( |
planeHeightAtCenterMeters |
Tinggi bidang segmen atap, dalam meter di atas permukaan laut, pada titik yang ditentukan oleh |
SolarPanel
SolarPanel menjelaskan posisi, orientasi, dan produksi satu panel surya. Lihat kolom panelHeightMeters
, panelWidthMeters
, dan panelCapacityWatts
di SolarPotential
untuk mengetahui informasi tentang parameter panel.
Representasi JSON |
---|
{ "center": { object ( |
Kolom | |
---|---|
center |
Bagian tengah panel. |
orientation |
Orientasi panel. |
yearlyEnergyDcKwh |
Berapa banyak energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam DC kWh. |
segmentIndex |
Indeks di |
SolarPanelOrientation
Orientasi panel surya. Ini harus ditafsirkan secara relatif terhadap azimut segmen atap tempat panel ditempatkan.
Enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Tidak ada orientasi panel yang diketahui. |
LANDSCAPE |
Panel LANDSCAPE memiliki tepi panjangnya yang tegak lurus dengan arah azimut segmen atap tempat panel berada. |
PORTRAIT |
Panel PORTRAIT memiliki tepi panjang yang sejajar dengan arah azimuth segmen atap tempat panel berada. |
SolarPanelConfig
SolarPanelConfig menjelaskan penempatan tertentu dari panel surya di atap.
Representasi JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Kolom | |
---|---|
panelsCount |
Jumlah total panel. Perhatikan bahwa ini redundan untuk (jumlah) kolom yang sesuai di |
yearlyEnergyDcKwh |
Berapa banyak energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam DC kWh, dengan asumsi panel yang dijelaskan di atas. |
roofSegmentSummaries[] |
Informasi tentang produksi setiap segmen atap yang memiliki setidaknya satu panel dalam tata letak ini. |
RoofSegmentSummary
Informasi tentang segmen atap pada bangunan, dengan beberapa panel yang diletakkan di atasnya.
Representasi JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Kolom | |
---|---|
panelsCount |
Jumlah total panel di segmen ini. |
yearlyEnergyDcKwh |
Berapa banyak energi sinar matahari yang ditangkap bagian tata letak ini selama setahun, dalam DC kWh, dengan asumsi panel yang dijelaskan di atas. |
pitchDegrees |
Sudut segmen atap relatif terhadap bidang tanah secara teoritis. 0 = sejajar dengan permukaan tanah, 90 = tegak lurus dengan permukaan tanah |
azimuthDegrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap yang "datar" ( |
segmentIndex |
Indeks dalam |
FinancialAnalysis
Analisis biaya dan manfaat tata letak panel surya yang optimal untuk ukuran tagihan listrik tertentu.
Representasi JSON |
---|
{ "monthlyBill": { object ( |
Kolom | |
---|---|
monthlyBill |
Tagihan listrik bulanan yang mengasumsikan analisis ini. |
defaultBill |
Apakah ini adalah ukuran paruh yang dipilih sebagai tagihan default untuk area tempat bangunan ini berada. Tepat satu |
averageKwhPerMonth |
Jumlah listrik yang digunakan rumah dalam sebulan rata-rata, berdasarkan ukuran tagihan dan tarif listrik lokal. |
financialDetails |
Informasi keuangan yang berlaku terlepas dari metode pendanaan yang digunakan. |
leasingSavings |
Biaya dan manfaat sewa panel surya. |
cashPurchaseSavings |
Biaya dan manfaat pembelian panel surya dengan uang tunai. |
financedPurchaseSavings |
Biaya dan manfaat pembelian panel surya dengan membiayai pembelian. |
panelConfigIndex |
Indeks dalam |
Uang
Menyatakan jumlah uang dengan jenis mata uangnya.
Representasi JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Kolom | |
---|---|
currencyCode |
Tiga huruf kode mata uang yang ditentukan dalam ISO 4217. |
units |
Seluruh unit jumlahnya. Misalnya, jika |
nanos |
Jumlah satuan nano (10^-9) dari jumlahnya. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika |
FinancialDetails
Detail analisis keuangan. Beberapa detail ini sudah disimpan di level yang lebih tinggi (misalnya, tanpa biaya). Jumlah total uang selama periode sepanjang waktu yang ditentukan oleh kolom panelLifetimeYears
di SolarPotential
. Catatan: Biaya langsung untuk membeli panel diberikan di kolom outOfPocketCost
di CashPurchaseSavings
.
Representasi JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Kolom | |
---|---|
initialAcKwhPerYear |
Berapa kWh AC yang kami perkirakan akan dihasilkan panel surya pada tahun pertamanya. |
remainingLifetimeUtilityBill |
Tagihan utilitas untuk listrik yang tidak dihasilkan oleh tenaga surya, selama masa pakai panel. |
federalIncentive |
Jumlah uang yang tersedia dari insentif federal; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
stateIncentive |
Jumlah uang yang tersedia dari insentif negara; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
utilityIncentive |
Jumlah uang yang tersedia dari insentif utilitas; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
lifetimeSrecTotal |
Jumlah uang yang akan diterima pengguna dari Kredit Energi Terbarukan Tenaga Surya selama masa pakai panel; ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
costOfElectricityWithoutSolar |
Total biaya listrik yang akan dibayar pengguna selama periode seumur hidup jika mereka tidak memasang tenaga surya. |
netMeteringAllowed |
Apakah pengukuran bersih diizinkan. |
solarPercentage |
Persentase (0-100) daya listrik pengguna yang disuplai oleh tenaga surya. Berlaku untuk tahun pertama, tetapi kurang lebih benar untuk tahun yang akan datang. |
percentageExportedToGrid |
Persentase (0-100) produksi listrik tenaga surya yang kami asumsikan diekspor ke jaringan listrik, berdasarkan produksi kuartal pertama. Hal ini memengaruhi penghitungan jika pengukuran bersih tidak diizinkan. |
LeasingSavings
Biaya dan manfaat penyewaan konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Representasi JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Kolom | |
---|---|
leasesAllowed |
Apakah sewa diizinkan dalam hukum ini (sewa tidak diizinkan di beberapa negara bagian). Jika kolom ini disetel ke salah (false), nilai dalam pesan ini mungkin harus diabaikan. |
leasesSupported |
Apakah sewa didukung dalam hukum ini oleh mesin hitung keuangan. Jika kolom ini disetel ke salah (false), nilai dalam pesan ini mungkin harus diabaikan. Hal ini tidak bergantung pada |
annualLeasingCost |
Perkiraan biaya sewa tahunan. |
savings |
Berapa banyak yang dihemat (atau tidak) selama periode seumur hidup. |
SavingsOverTime
Informasi keuangan yang dibagikan di antara berbagai metode pendanaan.
Representasi JSON |
---|
{ "savingsYear1": { object ( |
Kolom | |
---|---|
savingsYear1 |
Penghematan dalam tahun pertama setelah pemasangan panel. |
savingsYear20 |
Penghematan dalam dua puluh tahun pertama setelah pemasangan panel. |
presentValueOfSavingsYear20 |
Dengan menggunakan asumsi tarif diskon, berapa nilai sekarang dari penghematan kumulatif 20 tahun? |
savingsLifetime |
Penghematan sepanjang waktu panel. |
presentValueOfSavingsLifetime |
Dengan menggunakan asumsi tarif diskon, berapa nilai sekarang dari penghematan seumur hidup kumulatif? |
financiallyViable |
Menunjukkan apakah skenario ini layak secara finansial. Akan salah untuk skenario dengan kelayakan finansial yang buruk (misalnya, kehilangan uang). |
CashPurchaseSavings
Biaya dan manfaat pembelian langsung konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Representasi JSON |
---|
{ "outOfPocketCost": { object ( |
Kolom | |
---|---|
outOfPocketCost |
Biaya awal sebelum insentif pajak: jumlah yang harus dibayar sendiri. Berbeda dengan |
upfrontCost |
Biaya awal setelah insentif pajak: ini adalah jumlah yang harus dibayarkan selama tahun pertama. Berbeda dengan |
rebateValue |
Nilai semua potongan pajak. |
savings |
Berapa banyak yang dihemat (atau tidak) selama periode seumur hidup. |
paybackYears |
Jumlah tahun hingga pengembalian dilakukan. Nilai negatif berarti pengembalian tidak pernah terjadi dalam periode seumur hidup. |
FinancedPurchaseSavings
Biaya dan manfaat penggunaan pinjaman untuk membeli konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
Representasi JSON |
---|
{ "annualLoanPayment": { object ( |
Kolom | |
---|---|
annualLoanPayment |
Pembayaran pinjaman tahunan. |
rebateValue |
Nilai semua potongan pajak (termasuk Kredit Pajak Investasi Federal (ITC)). |
loanInterestRate |
Suku bunga pinjaman yang diasumsikan dalam rangkaian penghitungan ini. |
savings |
Berapa banyak yang dihemat (atau tidak) selama periode seumur hidup. |