- 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ının yaklaşık 50 m yakınında bina yoksa NOT_FOUND
koduyla birlikte bir 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ığı enlem ve boylam. |
requiredQuality |
İsteğe bağlı. Sonuçlarda izin verilen minimum kalite seviyesi. Bundan daha düşük kalitede bir sonuç döndürülmez. Bunu belirtmemek, yalnızca YÜKSEK kaliteyle kısıtlamaya 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 |
Binanın |
center |
Yapının merkezine yakın bir nokta. |
boundingBox |
Yapının sınırlayıcı kutusu. |
imageryDate |
Temel görüntünün edinildiği tarih. Bu, yaklaşık bir değerdir. |
imageryProcessedDate |
Bu görüntülerin işlenmesinin tamamlanma zamanı. |
postalCode |
Posta kodu (ör. ABD posta kodu) bu binanın bulunduğu ülkedir. |
administrativeArea |
Bu binayı içeren 1.bağlı olduğu yer (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir. |
statisticalArea |
İstatistiksel alan (ör. ABD nüfus sayımı bölgesi) bu binanın bulunduğu ülkedir. |
regionCode |
Bu binanın bulunduğu ülkenin (veya bölgenin) bölge kodu. |
solarPotential |
Binanın güneş enerjisi potansiyeli. |
imageryQuality |
Bu binanın verilerini hesaplamak için kullanılan görüntülerin kalitesi. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Enlem/Boylam koordinatlarında 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 bilgiler. Bu öğedeki bazı alanlar "paneller" olarak 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 dikey yönde metre cinsinden yüksekliğidir. |
panelWidthMeters |
Hesaplamalarda kullanılan panelin genişliği (dikey yönde, metre cinsinden). |
panelLifetimeYears |
Güneş panellerinin beklenen kullanım ömrü (yıl cinsinden). Finansal hesaplamalarda kullanılır. |
maxArrayAreaMeters2 |
Maksimum dizinin metrekare cinsinden boyutu. |
maxSunshineHoursPerYear |
Çatıdaki herhangi bir noktaya göre bir yılda alınan maksimum güneş ışığı süresi sayısı. Güneş ışığı süresi, bir yıl içinde alınan toplam yalıtım (enerji) miktarının bir ölçümüdür. 1 güneşli hava saati = kW başına 1 kW/sa (burada kW, Standart Test Koşullarında kW olarak kapasiteyi ifade eder). |
carbonOffsetFactorKgPerMwh |
Şebeke elektriğinin 1 MWh başına üretilen CO2 miktarına eşdeğerdir. Güneş enerjisiyle yer değiştiren şebeke elektriğinin karbon yoğunluğunun bir ölçüsüdür. |
wholeRoofStats |
Çatının bir çatı segmentine atanmış bölümüne ait toplam boyut ve güneş ışığı yüzdeleri. Adına rağmen, bu binanın tamamını kapsamayabilir. Şu sayfaya göz atın: |
buildingStats |
Çatının bazı çatı segmentlerine atanmamış kısımları da dahil olmak üzere, binanın tamamına ilişkin boyut ve güneş ışığı yüzdeleri. Bu parçaların yönleri iyi tanımlanmadığı için çatı alanı tahmini güvenilir değildir ancak zemin alanı tahmini güvenilirdir. |
roofSegmentStats[] |
Her bir çatı segmenti için boyut ve güneş ışığı yüzdeleri. |
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 yüzdeleri.
JSON gösterimi |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Alanlar | |
---|---|
areaMeters2 |
Çatı veya çatı segmentinin m^2 cinsinden alanı. Bu, zemin kapladığı alanı değil, çatı alanını (eğimi de hesaba katar) ifade eder. |
sunshineQuantiles[] |
Alandaki nokta tabanlı güneşliliğin miktarları. Burada N değeri varsa bu, (N-1)-ile'leri temsil eder. Örneğin, 5 değer varsa çeyreklik dilimler (min., %25, %50, %75, maks.) olur. Değerler |
groundAreaMeters2 |
Çatı veya çatı segmentinin kapladığı zemin kapladığı alan (m^2 cinsinden). |
RoofSegmentSizeAndSunshineStats
Bir çatı segmentinin boyutu ve güneşlilik yüzdeleri hakkında bilgi.
JSON gösterimi |
---|
{ "stats": { object ( |
Alanlar | |
---|---|
stats |
Çatı segmenti için toplam boyut ve güneş ışığı yüzdeleri. |
center |
Çatı bölümünün ortasına yakın bir nokta. |
boundingBox |
Çatı segmentinin sınırlayıcı kutusu. |
pitchDegrees |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik. |
azimuthDegrees |
Çatı segmentinin işaret ettiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (0'a çok yakın |
planeHeightAtCenterMeters |
Çatı segmenti düzleminin, |
SolarPanel
SolarPanel, tek bir güneş panelinin konumunu, yönünü ve üretimini açıklar. Panelin parametreleri hakkında bilgi edinmek için SolarPotential
içindeki panelHeightMeters
, panelWidthMeters
ve panelCapacityWatts
alanlarına bakın.
JSON gösterimi |
---|
{ "center": { object ( |
Alanlar | |
---|---|
center |
Panelin merkezi. |
orientation |
Panelin yönü. |
yearlyEnergyDcKwh |
Bu düzenin bir yıl boyunca DC kW/sa cinsinden yakaladığı güneş ışığı enerjisi miktarı. |
segmentIndex |
Bu panelin yerleştirildiği çatı segmentine karşılık gelen |
SolarPanelOrientation
Güneş panelinin yönü. Bu değer, panelin yerleştirildiği çatı segmentinin azimutuna göre yorumlanmalıdır.
Sıralamalar | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Bilinen bir panel yönü yok. |
LANDSCAPE |
Bir LANDSCAPE panelinin uzun kenarı, üzerine yerleştirildiği çatı segmentinin azimut yönüne dik bir konumdadır. |
PORTRAIT |
Bir PORTRAIT panelinin uzun kenarı, üzerine yerleştirildiği çatı segmentinin azimut yönüne paraleldir. |
SolarPanelConfig
SolarPanelConfig, güneş panellerinin çatıya belirli bir yerleştirmesini açıklar.
JSON gösterimi |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Alanlar | |
---|---|
panelsCount |
Toplam panel sayısı. Bunun, |
yearlyEnergyDcKwh |
Yukarıda açıklanan paneller varsayıldığında bu düzenin bir yıl boyunca DC kW/sa cinsinden yakaladığı güneş ışığı enerjisi miktarıdır. |
roofSegmentSummaries[] |
Bu düzende en az bir panel içeren her çatı segmentinin üretimiyle ilgili bilgiler. |
RoofSegmentSummary
Üzerinde birkaç panel bulunan binadaki bir çatı segmentiyle ilgili bilgiler.
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 paneller varsayıldığında düzenin bu bölümünün bir yıl boyunca DC kW/sa cinsinden yakaladığı güneş ışığı enerjisi miktarı. |
pitchDegrees |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik. |
azimuthDegrees |
Çatı segmentinin işaret ettiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (0'a çok yakın |
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 kabul edilen aylık elektrik faturası. |
defaultBill |
Bunun, bu binanın bulunduğu bölge için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. |
averageKwhPerMonth |
Fatura boyutuna ve yerel elektrik ücretlerine göre evin bir ayda kullandığı elektrik miktarı. |
financialDetails |
Kullanılan finans yönteminden bağımsız olarak geçerli olan finansal bilgiler. |
leasingSavings |
Güneş paneli kiralamanın maliyeti ve faydası. |
cashPurchaseSavings |
Güneş panellerini nakit parayla satın almanın maliyeti ve faydası. |
financedPurchaseSavings |
Satın almayı finanse ederek güneş paneli satın almanın maliyeti ve sağladığı fayda. |
panelConfigIndex |
Bu fatura boyutu için optimum güneş enerjisi düzeninin |
Para
Para birimini, para birimi türüyle birlikte temsil eder.
JSON gösterimi |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Alanlar | |
---|---|
currencyCode |
ISO 4217'de tanımlanan üç harfli para birimi kodu. |
units |
Tutarın tüm birimleri. Örneğin, |
nanos |
Tutarın nano (10^-9) birimlerinin sayısı. Değer -999.999.999 ile +999.999.999 (her iki değer de dahil) arasında olmalıdır. |
FinancialDetails
Finansal analizin ayrıntıları. Bu ayrıntılardan bazıları zaten daha yüksek düzeylerde depolanmaktadır (ör. cepten harcamalar). Toplam para tutarları, SolarPotential
içindeki panelLifetimeYears
alanı tarafından tanımlanan kullanım ömrü süresince gösterilir. Not: Panel satın alma işleminin cepten maliyeti, CashPurchaseSavings
bölgesindeki outOfPocketCost
alanında belirtilmiştir.
JSON gösterimi |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Alanlar | |
---|---|
initialAcKwhPerYear |
Güneş panellerinin ilk yılda kaç AC kW/sa enerji üreteceğini düşündüğümüz. |
remainingLifetimeUtilityBill |
Panellerin kullanım ömrü boyunca, güneş enerjisi tarafından üretilmeyen elektriğin elektrik, su veya doğalgaz faturası. |
federalIncentive |
Federal teşviklerden elde edilebilecek para miktarı. Bu değer, kullanıcının panelleri satın alması (kredi ile veya kredi olmadan) için geçerlidir. |
stateIncentive |
Eyalet teşviklerinden elde edilebilecek para miktarı. Bu, kullanıcının panelleri satın alması (kredi ile veya kredi olmadan) için geçerlidir. |
utilityIncentive |
Kamu yararı teşviklerinden elde edilebilecek para miktarı. Bu, kullanıcının panel satın alması (kredi ile veya kredi olmadan) için geçerlidir. |
lifetimeSrecTotal |
Kullanıcının panel ömrü boyunca Güneş Enerjisi Yenilenebilir Enerji Kredilerinden alacağı para miktarı. Bu, kullanıcının panelleri satın alması (ödüllü veya kredi olmadan) için geçerlidir. |
costOfElectricityWithoutSolar |
Kullanıcının güneş enerjisi kurulumu yapmaması durumunda ömür boyu ödeyeceği toplam elektrik maliyeti. |
netMeteringAllowed |
Net sayaca izin verilip verilmeyeceği. |
solarPercentage |
Kullanıcının güneş tarafından sağlanan gücünün 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 göre şebekeye aktarıldığını düşündüğümüz güneş enerjisi üretiminin yüzdesi (0-100). Bu, net ölçüme izin verilmiyorsa hesaplamaları etkiler. |
LeasingSavings
Belirli bir elektrik kullanımına sahip güneş panellerinin belirli bir 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 verilmeyeceği (bazı eyaletlerde kiralamalara izin verilmez). Bu alan yanlışsa bu iletideki değerler büyük olasılıkla yoksayılacaktır. |
leasesSupported |
Kiralamaların bu değerlendirmede finansal hesaplama motoru tarafından desteklenip desteklenmediği. Bu alan yanlışsa bu iletideki değerler büyük olasılıkla yoksayılacaktır. Bu, |
annualLeasingCost |
Tahmini yıllık kiralama maliyeti. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiği (veya olmadığı) |
SavingsOverTime
Farklı finansman yöntemleri arasında paylaşılan finansal bilgiler.
JSON gösterimi |
---|
{ "savingsYear1": { object ( |
Alanlar | |
---|---|
savingsYear1 |
Panel kurulumundan sonraki ilk yılda tasarruf. |
savingsYear20 |
Panel kurulumundan sonraki ilk yirmi yılda elde edilen tasarruf. |
presentValueOfSavingsYear20 |
Varsayılan iskonto oranı kullanıldığında kümülatif 20 yıllık tasarrufun bugünkü değeri nedir? |
savingsLifetime |
Panel ömrü boyunca sağlanan tasarruf. |
presentValueOfSavingsLifetime |
Varsayılan indirim oranı kullanıldığında kümülatif ömür boyu tasarrufların bugünkü değeri nedir? |
financiallyViable |
Bu senaryonun finansal açıdan uygun olup olmadığını belirtir. Finansal açıdan zayıf olan senaryolar için (ör. para kaybı) yanlış değerini döndürür. |
CashPurchaseSavings
Belirli bir elektrik kullanımı olan 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şviklerinden önceki ilk maliyet: Cepten ödenmesi gereken tutar. Vergi teşviklerinden sonraki |
upfrontCost |
Vergi teşviklerinden sonraki ilk maliyet: İlk yıl içinde ödenmesi gereken tutardır. Vergi teşviklerinden önceki |
rebateValue |
Tüm vergi iadelerinin değeri. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiği (veya olmadığı) |
paybackYears |
Geri ödeme gerçekleşene kadar geçen yıl sayısı. Negatif değer ise geri ödemenin kullanım ömrü içinde hiçbir zaman gerçekleşmediği anlamına gelir. |
FinancedPurchaseSavings
Belirli bir elektrik kullanımı olan 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 kümesinde kabul edilen kredilerin faiz oranı. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf edildiği (veya olmadığı) |