- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Para
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Deneyin.
Bir sorgu noktasına en yakın binayı bulur. Sorgu noktasından yaklaşık 50 metre uzakta bina yoksa NOT_FOUND
koduyla hata döndürür.
HTTP isteği
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
location |
Zorunlu. API'nin bilinen en yakın binayı aradığı boylam ve enlem. |
requiredQuality |
İsteğe bağlı. Sonuçlarda izin verilen minimum kalite seviyesi. Bundan daha düşük kalitede bir sonuç döndürülmez. Bunun belirtilmemesi yalnızca YÜKSEK kalite ile kısıtlamayla eşdeğerdir. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Solar.FindClosestBuildingInsights
için yanıt mesajı. Bir binanın konumu, boyutları ve güneş enerjisi potansiyeli hakkında bilgiler.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "name": string, "center": { object ( |
Alanlar | |
---|---|
name |
Bina için |
center |
Binanın merkezine yakın bir nokta. |
boundingBox |
Binanın sınırlayıcı kutusu. |
imageryDate |
Alttaki görüntülerin elde edildiği tarih. Bu sayı yaklaşıktır. |
imageryProcessedDate |
Bu görüntülerin işlenmesinin tamamlandığı tarih. |
postalCode |
Posta kodu (ör. ABD posta kodu) bu binanın bulunduğu yerdir. |
administrativeArea |
Bu binanın bulunduğu 1.idari bölge (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" olabilir. "CA" yazın. |
statisticalArea |
İstatistik alanı (ör. ABD nüfus sayım yeri) |
regionCode |
Bu binanın bulunduğu ülkenin (veya bölgenin) bölge kodu. |
solarPotential |
Binanın güneş enerjisi potansiyeli. |
imageryQuality |
Bu binaya ait verilerin hesaplanmasında kullanılan görüntülerin kalitesi. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Enl/Boyl koordinatlarında bir sınırlayıcı kutu.
JSON gösterimi |
---|
{ "sw": { object ( |
Alanlar | |
---|---|
sw |
Kutunun güneybatı köşesi. |
ne |
Kutunun kuzeydoğu köşesi. |
SolarPotential
Bir binanın güneş enerjisi potansiyeli hakkında bilgi. Bu örnekteki bazı alanlar "paneller" şeklinde tanımlanır. panelCapacityWatts
, panelHeightMeters
ve panelWidthMeters
alanları, bu hesaplamalarda kullanılan panel modelinin parametrelerini açıklar.
JSON gösterimi |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
Alanlar | |
---|---|
maxArrayPanelsCount |
Maksimum dizinin boyutu - yani, çatıya sığabilecek maksimum panel sayısı. |
panelCapacityWatts |
Hesaplamalarda kullanılan panelin vat cinsinden kapasitesi. |
panelHeightMeters |
Hesaplamalarda kullanılan panelin metre cinsinden dikey yönde yüksekliği. |
panelWidthMeters |
Hesaplamalarda kullanılan panelin dikey yönde metre cinsinden genişliği. |
panelLifetimeYears |
Güneş panellerinin tahmini ömrü (yıl olarak). Bu değer, finansal hesaplamalarda kullanılır. |
maxArrayAreaMeters2 |
Maksimum dizinin metrekare cinsinden boyutu. |
maxSunshineHoursPerYear |
Çatının herhangi bir noktasından yıllık maksimum güneş ışığı alma süresi. Güneş ışığı alma saatleri, bir yılda alınan toplam yalıtım (enerji) miktarının bir ölçüsüdür. 1 güneş ışığı = kW başına 1 kW/sa (burada kW, Standart Test Koşulları kapsamında kW kapasiteyi ifade eder). |
carbonOffsetFactorKgPerMwh |
MW/sa şebeke elektriği başına üretilen eşdeğer CO2 miktarı. Güneş enerjisiyle yer değiştiren şebeke elektriğinin karbon yoğunluğunun ölçümüdür. |
wholeRoofStats |
Çatının bir kısmına çatının atanmış bölümünün toplam boyutu ve güneş ışığı yüzdelik dilimleri. Adına rağmen binanın tamamını içermeyebilir. Şu sayfaya göz atın: |
buildingStats |
Çatının bazı çatı segmentlerine atanmamış bölümleri de dahil, tüm binanın boyutu ve güneş ışığı yüzdeleri. Bu parçaların yönleri iyi tanımlanmadığından, çatı alanı tahmini güvenilir değildir, ancak zemin alanı tahmini güvenilirdir. |
roofSegmentStats[] |
Her çatı segmenti için boyut ve güneş ışığı yüzdelikleri. |
solarPanels[] |
Her |
solarPanelConfigs[] |
Her |
financialAnalyses[] |
|
SizeAndSunshineStats
Bir çatının veya çatının bir bölümünün boyutu ve güneşlilik oranı.
JSON gösterimi |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Alanlar | |
---|---|
areaMeters2 |
Çatı veya çatı segmentinin m^2 cinsinden alanı. Bu alan, zeminin kapladığı alan değil, çatı alanıdır (eğim hesaplanırken hesaba katılır). |
sunshineQuantiles[] |
Bölgedeki noktasal güneşin yüzdelik dilimleri. Burada N değer varsa bu, (N-1)-ile'leri temsil eder. Örneğin, 5 değer varsa çeyrekler (min, %25, %50, %75, maks.) olur. Değerler, |
groundAreaMeters2 |
Çatı veya çatı segmentinin kapladığı zemin ayak izi alanı (m^2 cinsinden). |
RoofSegmentSizeAndSunshineStats
Bir çatı segmentinin boyutu ve güneşlilik yüzdelik dilimleri hakkında bilgi.
JSON gösterimi |
---|
{ "stats": { object ( |
Alanlar | |
---|---|
stats |
Çatı segmentinin toplam boyut ve güneş ışığı yüzdelik dilimleri. |
center |
Çatı segmentinin merkezine yakın bir nokta. |
boundingBox |
Çatı segmentinin sınırlayıcı kutusu. |
pitchDegrees |
Teorik zemin düzlemine göre çatı segmentinin açısı. 0 = yere paralel, 90 = zemine dik. |
azimuthDegrees |
Tavan segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" için çatı segmenti ( |
planeHeightAtCenterMeters |
Çatı segment düzleminin |
SolarPanel
SolarPanel, tek bir güneş panelinin konumunu, yönünü ve üretimini açıklar. Panelin parametreleri hakkında bilgi için SolarPotential
içindeki panelHeightMeters
, panelWidthMeters
ve panelCapacityWatts
alanlarına bakın.
JSON gösterimi |
---|
{ "center": { object ( |
Alanlar | |
---|---|
center |
Panelin ortası. |
orientation |
Panelin yönü. |
yearlyEnergyDcKwh |
Bu düzenin bir yıl boyunca DC kWh cinsinden ne kadar güneş ışığı enerjisi yakaladığı. |
segmentIndex |
Bu panelin yerleştirildiği çatı segmentine karşılık gelen |
SolarPanelOrientation
Güneş panelinin yönü. Bu, panelin yerleştirildiği çatı segmentinin azimutuna göre yorumlanmalıdır.
Sıralamalar | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Panel yönü bilinmiyor. |
LANDSCAPE |
LANDSCAPE panelinin uzun kenarı, üzerine yerleştirildiği çatı segmentinin azimut yönüne diktir. |
PORTRAIT |
PORTRAIT panelinin uzun kenarı, üzerine yerleştirildiği çatı segmentinin azimut yönüne paraleldir. |
SolarPanelConfig
SolarPanelConfig, güneş panellerinin çatıya belirli bir konumunu açıklamaktadır.
JSON gösterimi |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Alanlar | |
---|---|
panelsCount |
Toplam panel sayısı. Bunun, |
yearlyEnergyDcKwh |
Yukarıda açıklanan panellerin olduğu varsayıldığında, bu düzenin bir yıl boyunca DC kWh cinsinden ne kadar güneş ışığı enerjisi yakaladığı. |
roofSegmentSummaries[] |
Bu düzende en az bir paneli taşıyan her bir çatı segmentinin üretimiyle ilgili bilgiler. |
RoofSegmentSummary
Binadaki bir çatı segmenti hakkında ve üzerine birkaç panel yerleştirilmiş bilgi.
JSON gösterimi |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Alanlar | |
---|---|
panelsCount |
Bu segmentteki toplam panel sayısı. |
yearlyEnergyDcKwh |
Yukarıda açıklanan panellerin olduğu varsayıldığında, düzenin bu bölümünün bir yıl boyunca DC kWh olarak ne kadar güneş ışığı enerjisi yakaladığı. |
pitchDegrees |
Teorik zemin düzlemine göre çatı segmentinin açısı. 0 = yere paralel, 90 = zemine dik. |
azimuthDegrees |
Tavan segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" için çatı segmenti ( |
segmentIndex |
Karşılık gelen |
FinancialAnalysis
Belirli bir elektrik faturası boyutu için optimum güneş enerjisi düzeninin maliyetinin ve faydalarının analizi.
JSON gösterimi |
---|
{ "monthlyBill": { object ( |
Alanlar | |
---|---|
monthlyBill |
Bu analizde temel alınan aylık elektrik faturası. |
defaultBill |
Bu, binanın bulunduğu bölge için varsayılan fatura olarak seçilen fatura boyutunun olup olmadığı. |
averageKwhPerMonth |
Fatura büyüklüğüne ve yerel elektrik ücretlerine göre evin ortalama bir ayda kullandığı elektrik miktarı. |
financialDetails |
Kullanılan finans yönteminden bağımsız olarak geçerli finansal bilgiler. |
leasingSavings |
Güneş panellerini kiralamanın maliyeti ve faydası. |
cashPurchaseSavings |
Güneş panellerini nakitle satın almanın maliyeti ve faydası. |
financedPurchaseSavings |
Satın almayı finanse ederek güneş paneli satın almanın maliyeti ve faydası. |
panelConfigIndex |
Bu fatura boyutu için optimum güneş enerjisi düzeninin |
Para
Para birimi türüyle birlikte bir para tutarını gösterir.
JSON gösterimi |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Alanlar | |
---|---|
currencyCode |
ISO 4217'de tanımlanan üç harfli para birimi kodu. |
units |
Tutarın tam birimi. Örneğin, |
nanos |
Tutarın nano (10^-9) birimlerinin sayısı. Değer -999.999.999 ile +999.999.999 (bu değerler dahil) arasında olmalıdır. |
FinancialDetails
Finansal analizin ayrıntıları. Bu ayrıntıların bazıları zaten daha yüksek seviyelerde depolanmıştır (örneğin, cebinizde). Toplam para tutarları, SolarPotential
içindeki panelLifetimeYears
alanı tarafından tanımlanan bir ömür boyu değerdir. Not: Panelleri satın almanın harici maliyeti CashPurchaseSavings
içindeki outOfPocketCost
alanında belirtilmiştir.
JSON gösterimi |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Alanlar | |
---|---|
initialAcKwhPerYear |
Güneş panellerinin ilk yılda kaç kW/sa enerji üreteceğini düşünüyoruz. |
remainingLifetimeUtilityBill |
Panellerin ömrü boyunca güneş enerjisiyle üretilmeyen elektrik için altyapı hizmeti faturası. |
federalIncentive |
Federal teşviklerden elde edilen paranın tutarı; Bu, kullanıcı panelleri (krediyle veya kredi olmadan) satın aldığında geçerlidir. |
stateIncentive |
Devlet teşviklerinden elde edilen paranın tutarı; Bu, kullanıcı panelleri (krediyle veya kredi olmadan) satın aldığında geçerlidir. |
utilityIncentive |
Kamu hizmeti teşviklerinden elde edilen paranın tutarı; Bu, kullanıcı panelleri (krediyle veya kredi olmadan) satın aldığında geçerlidir. |
lifetimeSrecTotal |
Kullanıcının panel ömrü boyunca Yenilenebilir Güneş Enerjisi Kredilerinden alacağı para miktarı; Bu, kullanıcı panelleri (krediyle veya kredi olmadan) satın aldığında geçerlidir. |
costOfElectricityWithoutSolar |
Güneş enerjisi kurulumu olmasaydı kullanıcının ömür boyu ödeyeceği toplam elektrik maliyeti. |
netMeteringAllowed |
Net ölçüme izin verilip verilmediği. |
solarPercentage |
Kullanıcının güneş enerjisiyle sağladığı enerjinin yüzdesi (0-100). İlk yıl için geçerlidir ancak sonraki yıllar için yaklaşık olarak doğrudur. |
percentageExportedToGrid |
Üretimin ilk çeyreğine dayanarak güneş enerjisi üretiminin yüzdesinin (0-100) şebekeye ihraç edildiğini varsaydık. Net ölçüme izin verilmiyorsa bu durum hesaplamaları etkiler. |
LeasingSavings
Belirli bir elektrik kullanımı için belirli bir güneş paneli konfigürasyonunu kiralamanın maliyeti ve faydası.
JSON gösterimi |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Alanlar | |
---|---|
leasesAllowed |
Bu yargı alanında kiralamaya izin verilip verilmediği (bazı eyaletlerde kiralamalara izin verilmez). Bu alan false (yanlış) değerine ayarlanmışsa bu mesajdaki değerlerin muhtemelen yoksayılması gerekir. |
leasesSupported |
Kiralamaların bu yargı alanında finansal hesaplama motoru tarafından desteklenip desteklenmediği. Bu alan false (yanlış) değerine ayarlanmışsa bu mesajdaki değerlerin muhtemelen yoksayılması gerekir. Bu, |
annualLeasingCost |
Tahmini yıllık kiralama maliyeti. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiğini (veya kaydedilmediğini). |
SavingsOverTime
Farklı finans yöntemleri arasında paylaşılan finansal bilgiler.
JSON gösterimi |
---|
{ "savingsYear1": { object ( |
Alanlar | |
---|---|
savingsYear1 |
Panelin kurulumundan sonraki ilk yılda tasarruflar. |
savingsYear20 |
Panel kurulumundan sonraki ilk yirmi yılda tasarruf. |
presentValueOfSavingsYear20 |
Varsayılan iskonto oranı kullanıldığında 20 yıllık kümülatif tasarrufların bugünkü değeri nedir? |
savingsLifetime |
Tüm panel ömrü boyunca tasarruf. |
presentValueOfSavingsLifetime |
Varsayılan iskonto oranı kullanıldığında kümülatif yaşam boyu tasarrufların bugünkü değeri nedir? |
financiallyViable |
Bu senaryonun finansal açıdan uygun olup olmadığını gösterir. Finansal açıdan yetersiz olan senaryolar (ör. para kaybı) için yanlış olarak ayarlanır. |
CashPurchaseSavings
Belirli bir elektrik kullanımına sahip belirli bir güneş paneli konfigürasyonunun doğrudan satın alınmasının maliyeti ve faydası.
JSON gösterimi |
---|
{ "outOfPocketCost": { object ( |
Alanlar | |
---|---|
outOfPocketCost |
Vergi teşvikleri öncesi ilk maliyet: Cepten ödenmesi gereken tutar. Vergi teşviklerinden sonraki |
upfrontCost |
Vergi teşviklerinden sonraki ilk maliyet: Bu tutar, ilk yıl boyunca ödenmesi gereken tutardır. Vergi teşviklerinden önceki |
rebateValue |
Tüm vergi iadelerinin değeri. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiğini (veya kaydedilmediğini). |
paybackYears |
Geri ödemenin gerçekleştirilmesine kalan yıl sayısı. Negatif değer, kullanım ömrü boyunca geri ödemenin hiçbir zaman gerçekleşmediği anlamına gelir. |
FinancedPurchaseSavings
Belirli bir elektrik kullanımına sahip belirli bir güneş paneli konfigürasyonunu satın almak için kredi kullanmanın maliyeti ve faydası.
JSON gösterimi |
---|
{ "annualLoanPayment": { object ( |
Alanlar | |
---|---|
annualLoanPayment |
Yıllık kredi ödemeleri. |
rebateValue |
Tüm vergi iadelerinin değeri (Federal Yatırım Vergisi Kredisi (ITC) dahil). |
loanInterestRate |
Bu hesaplama grubunda kabul edilen kredilerin faiz oranı. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiğini (veya kaydedilmediğini). |