- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Uang
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Cobalah!
Menemukan bangunan yang centroid-nya paling dekat 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 ini 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 lebih rendah dari ini yang akan ditampilkan. Jika tidak ditentukan, hal ini sama dengan membatasi hanya pada kualitas HIGH. |
exactQualityRequired |
Opsional. Apakah akan mewajibkan kualitas gambar yang tepat. Jika ditetapkan ke false, kolom |
experiments[] |
Opsional. Menentukan eksperimen pra-GA yang akan diaktifkan. Permintaan yang menggunakan kolom ini diklasifikasikan sebagai penawaran pra-GA berdasarkan Persyaratan Khusus Layanan Google Maps Platform. Lihat deskripsi tahap peluncuran untuk mengetahui detail selengkapnya. |
additionalInsights[] |
Opsional. Daftar |
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 resource untuk gedung, dengan format |
center |
Titik di dekat bagian tengah bangunan. |
boundingBox |
Kotak pembatas bangunan. |
imageryDate |
Tanggal pengambilan gambar yang mendasarinya. Ini adalah perkiraan. |
imageryProcessedDate |
Waktu pemrosesan selesai pada gambar ini. |
postalCode |
Kode pos (misalnya, kode pos AS) yang mencakup bangunan ini. |
administrativeArea |
Wilayah administratif 1 (misalnya, di AS, negara bagian) yang berisi bangunan ini. Misalnya, di Amerika Serikat, singkatannya mungkin "MA" atau "CA". |
statisticalArea |
Area statistik (misalnya, wilayah sensus AS) tempat bangunan ini berada. |
regionCode |
Kode wilayah untuk negara (atau wilayah) tempat gedung ini berada. |
solarPotential |
Potensi tenaga surya bangunan. |
imageryQuality |
Kualitas gambar yang digunakan untuk menghitung data bangunan ini. |
detectedArrays |
Sistem panel surya terdeteksi di bangunan. Kolom ini hanya diisi jika DETECTED_ARRAYS disertakan dalam |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Informasi bangunan tambahan seperti geometri atap dan panel surya yang dapat ditampilkan di BuildingInsights.
| Enum | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Nilai default. BuildingInsights default akan ditampilkan. |
DETECTED_ARRAYS |
Menentukan apakah respons akan menyertakan array yang terdeteksi. Jika ditentukan, kolom |
LatLngBox
Kotak pembatas dalam koordinat lintang/bujur.
| 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 di dalamnya ditentukan dalam bentuk "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 array maksimum, yaitu jumlah maksimum panel yang dapat dipasang di atap. |
panelCapacityWatts |
Kapasitas, dalam watt, panel yang digunakan dalam penghitungan. |
panelHeightMeters |
Tinggi, dalam meter dalam orientasi potret, panel yang digunakan dalam penghitungan. |
panelWidthMeters |
Lebar, dalam meter dalam orientasi potret, panel yang digunakan dalam penghitungan. |
panelLifetimeYears |
Perkiraan masa pakai panel surya, dalam tahun. Nilai ini digunakan dalam penghitungan keuangan. |
maxArrayAreaMeters2 |
Ukuran, dalam meter persegi, dari array maksimum. |
maxSunshineHoursPerYear |
Jumlah maksimum jam sinar matahari yang diterima per tahun, di titik mana pun di atap. Jam penyinaran matahari adalah ukuran jumlah total insolasi (energi) yang diterima per tahun. 1 jam sinar matahari = 1 kWh per kW (dengan kW mengacu pada kW kapasitas berdasarkan Kondisi Pengujian Standar). |
carbonOffsetFactorKgPerMwh |
Jumlah setara CO2 yang dihasilkan per MWh listrik jaringan. Ini adalah ukuran intensitas karbon listrik jaringan yang digantikan oleh listrik tenaga surya. |
wholeRoofStats |
Total ukuran dan kuantil sinar matahari untuk bagian atap yang ditetapkan ke beberapa segmen atap. Meskipun namanya demikian, ini mungkin tidak mencakup 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 ini tidak dicirikan dengan baik, estimasi area atap tidak dapat diandalkan, tetapi estimasi area tanah dapat diandalkan. Mungkin luas atap seluruh bangunan yang lebih andal dapat diperoleh dengan menskalakan luas atap dari |
roofSegmentStats[] |
Kuantil ukuran dan sinar matahari untuk setiap segmen atap. |
solarPanels[] |
Setiap |
solarPanelConfigs[] |
Setiap |
financialAnalyses[] |
|
SizeAndSunshineStats
Kuantil ukuran dan intensitas sinar matahari pada atap, atau bagian atap.
| Representasi JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Kolom | |
|---|---|
areaMeters2 |
Luas atap atau segmen atap, dalam m^2. Ini adalah luas atap (memperhitungkan kemiringan), bukan luas jejak tanah. |
sunshineQuantiles[] |
Kuantil kecerahan titik di seluruh area. Jika ada nilai N di sini, ini mewakili (N-1)-il. Misalnya, jika ada 5 nilai, maka nilai tersebut akan menjadi kuartil (min, 25%, 50%, 75%, maks). Nilai dalam kWh/kW tahunan seperti |
groundAreaMeters2 |
Area jejak tanah yang tercakup oleh atap atau segmen atap, dalam m^2. |
RoofSegmentSizeAndSunshineStats
Informasi tentang ukuran dan kuantil paparan sinar matahari dari segmen atap.
| Representasi JSON |
|---|
{ "stats": { object ( |
| Kolom | |
|---|---|
stats |
Total ukuran dan kuantil sinar matahari untuk segmen atap. |
center |
Titik di dekat pusat segmen atap. |
boundingBox |
Kotak pembatas segmen atap. |
pitchDegrees |
Sudut segmen atap yang diukur dari bidang tanah teoretis. 0 = sejajar dengan tanah, 90 = tegak lurus dengan tanah. |
azimuthDegrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap "datar" ( |
planeHeightAtCenterMeters |
Ketinggian 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 |
Jumlah energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam kWh DC. |
segmentIndex |
Indeks di |
SolarPanelOrientation
Orientasi panel surya. Hal 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 panjang yang tegak lurus dengan arah azimut segmen atap tempat panel tersebut ditempatkan. |
PORTRAIT |
Panel PORTRAIT memiliki tepi panjang yang sejajar dengan arah azimut segmen atap tempat panel tersebut ditempatkan. |
SolarPanelConfig
SolarPanelConfig menjelaskan penempatan panel surya tertentu di atap.
| Representasi JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Kolom | |
|---|---|
panelsCount |
Jumlah total panel. Perhatikan bahwa ini redundan dengan (jumlah) kolom yang sesuai di |
yearlyEnergyDcKwh |
Jumlah energi sinar matahari yang ditangkap tata letak ini selama setahun, dalam kWh DC, dengan asumsi panel yang dijelaskan di atas. |
roofSegmentSummaries[] |
Informasi tentang produksi setiap segmen atap yang membawa setidaknya satu panel dalam tata letak ini. |
RoofSegmentSummary
Informasi tentang segmen atap pada bangunan, dengan sejumlah panel yang ditempatkan di atasnya.
| Representasi JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| Kolom | |
|---|---|
panelsCount |
Jumlah total panel di segmen ini. |
yearlyEnergyDcKwh |
Jumlah energi sinar matahari yang ditangkap oleh bagian tata letak ini selama setahun, dalam kWh DC, dengan asumsi panel yang dijelaskan di atas. |
pitchDegrees |
Sudut segmen atap yang diukur dari bidang tanah teoretis. 0 = sejajar dengan tanah, 90 = tegak lurus dengan tanah. |
azimuthDegrees |
Arah kompas yang ditunjuk oleh segmen atap. 0 = Utara, 90 = Timur, 180 = Selatan. Untuk segmen atap "datar" ( |
segmentIndex |
Indeks di |
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 diasumsikan dalam analisis ini. |
defaultBill |
Apakah ini ukuran tagihan yang dipilih sebagai tagihan default untuk area tempat bangunan ini berada. Tepat satu |
averageKwhPerMonth |
Jumlah listrik yang digunakan rumah dalam rata-rata bulan, berdasarkan jumlah tagihan dan tarif listrik lokal. |
financialDetails |
Informasi keuangan yang berlaku, terlepas dari metode pembiayaan yang digunakan. |
leasingSavings |
Biaya dan manfaat menyewa panel surya. |
cashPurchaseSavings |
Biaya dan manfaat membeli panel surya dengan uang tunai. |
financedPurchaseSavings |
Biaya dan manfaat membeli panel surya dengan membiayai pembelian. |
panelConfigIndex |
Indeks di |
Uang
Mewakili jumlah uang dengan jenis mata uangnya.
| Representasi JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Kolom | |
|---|---|
currencyCode |
Kode mata uang tiga huruf yang ditentukan dalam ISO 4217. |
units |
Seluruh unit jumlahnya. Misalnya jika |
nanos |
Jumlah unit nano (10^-9) dari jumlah. Nilainya harus antara -999.999.999 dan +999.999.999 inklusif. Jika |
FinancialDetails
Detail analisis keuangan. Beberapa detail ini sudah disimpan di tingkat yang lebih tinggi (misalnya, biaya yang dikeluarkan sendiri). Jumlah total uang adalah selama periode masa aktif yang ditentukan oleh kolom panelLifetimeYears di SolarPotential. Catatan: Biaya yang dikeluarkan untuk membeli panel diberikan di kolom outOfPocketCost di CashPurchaseSavings.
| Representasi JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Kolom | |
|---|---|
initialAcKwhPerYear |
Jumlah kWh AC yang kami perkirakan akan dihasilkan oleh panel surya pada tahun pertama. |
remainingLifetimeUtilityBill |
Tagihan utilitas untuk listrik yang tidak dihasilkan oleh panel 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 bagian; 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; hal ini berlaku jika pengguna membeli (dengan atau tanpa pinjaman) panel. |
costOfElectricityWithoutSolar |
Total biaya listrik yang akan dibayar pengguna selama periode masa aktif jika mereka tidak memasang panel surya. |
netMeteringAllowed |
Apakah pengukuran bersih diizinkan atau tidak. |
solarPercentage |
Persentase (0-100) daya pengguna yang disuplai oleh tenaga surya. Berlaku untuk tahun pertama, tetapi perkiraannya tepat untuk tahun-tahun mendatang. |
percentageExportedToGrid |
Persentase (0-100) produksi listrik tenaga surya yang kami asumsikan diekspor ke jaringan listrik, berdasarkan kuartal pertama produksi. Hal ini memengaruhi penghitungan jika pengukuran bersih tidak diizinkan. |
LeasingSavings
Biaya dan manfaat menyewa konfigurasi panel surya tertentu dengan penggunaan listrik tertentu.
| Representasi JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Kolom | |
|---|---|
leasesAllowed |
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. |
leasesSupported |
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 |
annualLeasingCost |
Estimasi biaya sewa tahunan. |
savings |
Jumlah yang dihemat (atau tidak) selama periode masa aktif. |
SavingsOverTime
Informasi keuangan yang dibagikan antara berbagai metode pembiayaan.
| Representasi JSON |
|---|
{ "savingsYear1": { object ( |
| Kolom | |
|---|---|
savingsYear1 |
Penghematan pada 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 selama 20 tahun? |
savingsLifetime |
Penghematan selama masa pakai panel. |
presentValueOfSavingsLifetime |
Dengan menggunakan asumsi tarif diskon, berapa nilai sekarang dari penghematan masa pakai kumulatif? |
financiallyViable |
Menunjukkan apakah skenario ini layak secara finansial. Akan bernilai salah untuk skenario dengan kelayakan finansial yang buruk (misalnya, merugi). |
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: jumlah yang harus dibayar selama tahun pertama. Berbeda dengan |
rebateValue |
Nilai semua potongan pajak. |
savings |
Jumlah yang dihemat (atau tidak) selama periode masa aktif. |
paybackYears |
Jumlah tahun hingga pengembalian investasi terjadi. Nilai negatif berarti pengembalian modal tidak pernah terjadi dalam periode masa aktif. |
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 kredit pajak (termasuk Federal Investment Tax Credit (ITC)). |
loanInterestRate |
Suku bunga pinjaman yang diasumsikan dalam kumpulan penghitungan ini. |
savings |
Jumlah yang dihemat (atau tidak) selama periode masa aktif. |
DetectedArrays
Informasi tentang panel surya yang terdeteksi di bangunan.
| Representasi JSON |
|---|
{ "detectionStatus": enum ( |
| Kolom | |
|---|---|
detectionStatus |
Menunjukkan status deteksi panel surya untuk bangunan ini. |
arrays[] |
Daftar panel surya yang terdeteksi di bangunan. |
latestCaptureDate |
Tanggal yang menunjukkan kapan data panel surya terbaru diambil. |
DetectionStatus
Menunjukkan status deteksi panel surya untuk bangunan ini.
| Enum | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Status tidak ditentukan. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Data panel surya yang terdeteksi tidak tersedia untuk bangunan ini. |
DETECTION_STATUS_ARRAYS_DETECTED |
Setidaknya satu panel surya telah terdeteksi untuk bangunan ini. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Tidak ada panel surya yang terdeteksi untuk bangunan ini. |
SolarArray
Detail satu panel surya yang terdeteksi.
| Representasi JSON |
|---|
{ "polygonGeojson": { object } } |
| Kolom | |
|---|---|
polygonGeojson |
Representasi GeoJSON dari area bangunan tempat panel surya terdeteksi. Data GeoJSON harus dalam format RFC 7946 dan merepresentasikan Poligon untuk satu area yang berdekatan. Polygon akan direpresentasikan oleh beberapa loop jika berisi lubang. Contoh: { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |