- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Money
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Deneyin.
Ağırlık merkezi bir sorgu noktasına en yakın olan binayı bulur. Sorgu noktasının yaklaşık 50 metre yakınında 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ıdır. Sonuçlarda izin verilen minimum kalite düzeyi. Bundan daha düşük kaliteli sonuçlar döndürülmez. Bu ayarın belirtilmemesi, yalnızca YÜKSEK kaliteyle sınırlamaya eşdeğerdir. |
exactQualityRequired |
İsteğe bağlıdır. Görüntülerin tam kalitede olmasının gerekip gerekmediği. Yanlış olarak ayarlanırsa |
experiments[] |
İsteğe bağlıdır. Etkinleştirilecek GKST öncesi özellikleri belirtir. |
İstek metni
İstek metni boş olmalıdır.
Yanıt metni
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 kaynak adı, |
center |
Binanın merkezine yakın bir nokta. |
boundingBox |
Binanın sınırlayıcı kutusu. |
imageryDate |
Temel görüntülerin elde edildiği tarih. Bu değer yaklaşık bir değerdir. |
imageryProcessedDate |
Bu görüntülerin işlenmesi tamamlandığında. |
postalCode |
Posta kodu (ör. Bu binanın bulunduğu ABD posta kodu. |
administrativeArea |
Bu binayı içeren 1.idari bölge (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir. |
statisticalArea |
İstatistik alanı (ör. ABD nüfus sayımı bölgesi) bu binanın bulunduğu yer. |
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. Buradaki 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 (çatıya sığabilecek maksimum panel sayısı). |
panelCapacityWatts |
Hesaplamalarda kullanılan panelin watt cinsinden kapasitesi. |
panelHeightMeters |
Hesaplamalarda kullanılan panelin dikey yöndeki yüksekliği (metre cinsinden). |
panelWidthMeters |
Hesaplamalarda kullanılan panelin dikey yöndeki genişliği (metre cinsinden). |
panelLifetimeYears |
Güneş panellerinin beklenen kullanım ömrü (yıl). Bu değer, finansal hesaplamalarda kullanılır. |
maxArrayAreaMeters2 |
Maksimum dizinin metrekare cinsinden boyutu. |
maxSunshineHoursPerYear |
Çatının herhangi bir noktasının yılda aldığı maksimum güneş ışığı saati sayısı. Güneş ışığı saatleri, yılda alınan toplam güneş ışığı (enerji) miktarının bir ölçüsüdür. 1 saat güneş ışığı = kW başına 1 kWsa (burada kW, Standart Test Koşulları altındaki kapasitenin kW'ını ifade eder). |
carbonOffsetFactorKgPerMwh |
Şebeke elektriğinin MWh başına üretilen eşdeğer CO2 miktarı. Bu, güneş enerjisiyle yer değiştirilen şebeke elektriğinin karbon yoğunluğunun bir ölçüsüdür. |
wholeRoofStats |
Çatının bir çatı segmentine atanan kısmı için toplam boyut ve güneş ışığı yüzdelik dilimleri. Adına rağmen bu, binanın tamamını içermeyebilir. Şu sayfaya göz atın: |
buildingStats |
Çatının bazı bölümlerine atanmamış kısımlar da dahil olmak üzere binanın tamamı için boyut ve güneş ışığı yüzdelik dilimleri. 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 çatı segmenti için boyut ve güneş ışığı yüzdelik dilimleri. |
solarPanels[] |
Her |
solarPanelConfigs[] |
Her |
financialAnalyses[] |
|
SizeAndSunshineStats
Bir çatının veya çatı bölümünün boyutu ve güneş ışığı miktarı.
| JSON gösterimi |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Alanlar | |
|---|---|
areaMeters2 |
Çatının veya çatı segmentinin alanı (m^2). Bu, yerdeki ayak izi alanı değil, çatı alanıdır (eğim dikkate alınır). |
sunshineQuantiles[] |
Bölgedeki noktasal güneş ışığı miktarlarının yüzdelik dilimleri. Burada N değer varsa bu, (N-1) yüzdelik dilimini temsil eder. Örneğin, 5 değer varsa bunlar çeyreklikler (en düşük, %25, %50, %75, en yüksek) olur. Değerler, |
groundAreaMeters2 |
Çatı veya çatı bölümü tarafından kaplanan zemin alanı (m^2). |
RoofSegmentSizeAndSunshineStats
Bir çatı segmentinin boyutu ve güneş ışığı miktarı yüzdelik dilimleri hakkında bilgi.
| JSON gösterimi |
|---|
{ "stats": { object ( |
| Alanlar | |
|---|---|
stats |
Çatı segmentinin toplam boyutu ve güneş ışığı yüzdelik dilimleri. |
center |
Çatı segmentinin merkezine yakın bir nokta. |
boundingBox |
Çatı segmentinin sınırlayıcı kutusu. |
pitchDegrees |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = yere paralel, 90 = yere dik. |
azimuthDegrees |
Çatı segmentinin yönünü gösteren pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti ( |
planeHeightAtCenterMeters |
Çatı segmenti düzleminin, deniz seviyesinden yüksekliği (metre cinsinden) |
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 yerleşim düzeninin bir yıl içinde yakaladığı güneş enerjisi miktarı (DC kW/sa cinsinden). |
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 |
Bir LANDSCAPE panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne diktir. |
PORTRAIT |
Bir PORTRAIT panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne paraleldir. |
SolarPanelConfig
SolarPanelConfig, çatıdaki güneş panellerinin belirli bir yerleşimini tanımlar.
| JSON gösterimi |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Alanlar | |
|---|---|
panelsCount |
Toplam panel sayısı. Bunun, |
yearlyEnergyDcKwh |
Yukarıda açıklanan panellerin kullanıldığı varsayıldığında, bu yerleşimin bir yıl içinde yakaladığı güneş enerjisi miktarı (DC kWh cinsinden). |
roofSegmentSummaries[] |
Bu düzende en az bir panel taşıyan her çatı segmentinin üretimiyle ilgili bilgiler. |
RoofSegmentSummary
Binadaki bir çatı segmenti hakkında bilgi. Çatının üzerinde belirli sayıda panel yer alıyor.
| 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 kullanıldığı varsayıldığında, bu yerleşim bölümünün bir yıl içinde yakaladığı güneş enerjisi miktarı (DC kWh cinsinden). |
pitchDegrees |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = yere paralel, 90 = yere dik. |
azimuthDegrees |
Çatı segmentinin yönünü gösteren pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti ( |
segmentIndex |
İlgili |
FinancialAnalysis
Belirli bir elektrik faturası büyüklüğü için optimum güneş enerjisi düzeninin maliyet ve faydalarının analizi.
| JSON gösterimi |
|---|
{ "monthlyBill": { object ( |
| Alanlar | |
|---|---|
monthlyBill |
Bu analizde varsayılan aylık elektrik faturası. |
defaultBill |
Bu binanın bulunduğu alan için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. |
averageKwhPerMonth |
Fatura tutarı ve yerel elektrik tarifelerine göre evin ortalama bir ayda kullandığı elektrik miktarı. |
financialDetails |
Kullanılan finansman yönteminden bağımsız olarak geçerli olan finansal bilgiler. |
leasingSavings |
Güneş panellerini kiralamanın maliyeti ve faydası. |
cashPurchaseSavings |
Güneş panellerini nakit olarak satın almanın maliyeti ve faydası. |
financedPurchaseSavings |
Satın alma işlemini finanse ederek güneş panelleri satın almanın maliyeti ve faydası. |
panelConfigIndex |
Bu fatura boyutu için optimum güneş paneli 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 birimleri. Örneğin, |
nanos |
Tutarın nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. |
FinancialDetails
Finansal analiz ayrıntıları. Bu ayrıntıların bazıları daha yüksek düzeylerde (ör. cepten ödenen maliyet) zaten depolanır. Toplam para tutarları, SolarPotential içindeki panelLifetimeYears alanı tarafından tanımlanan bir kullanım süresi boyunca geçerlidir. Not: Panellerin satın alınmasıyla ilgili cepten ödenen maliyet, CashPurchaseSavings içindeki outOfPocketCost alanında belirtilir.
| JSON gösterimi |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Alanlar | |
|---|---|
initialAcKwhPerYear |
Güneş panellerinin ilk yılda kaç AC kWh üreteceğini tahmin ediyoruz. |
remainingLifetimeUtilityBill |
Panellerin kullanım ömrü boyunca güneş enerjisiyle üretilmeyen elektrik için ödenen elektrik faturası. |
federalIncentive |
Federal teşviklerden elde edilebilecek para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir. |
stateIncentive |
Eyalet teşviklerinden elde edilebilecek para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir. |
utilityIncentive |
Kamu hizmeti teşviklerinden elde edilebilecek para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir. |
lifetimeSrecTotal |
Kullanıcının panel ömrü boyunca Solar Yenilenebilir Enerji Kredilerinden alacağı para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir. |
costOfElectricityWithoutSolar |
Kullanıcının güneş enerjisi kurmadığı takdirde kullanım ömrü boyunca ödeyeceği toplam elektrik maliyeti. |
netMeteringAllowed |
Net ölçüme izin verilip verilmediği. |
solarPercentage |
Kullanıcının güneş enerjisiyle sağlanan gücünün yüzdesi (0-100). İlk yıl için geçerlidir ancak gelecek yıllar için yaklaşık olarak doğrudur. |
percentageExportedToGrid |
Üretimin ilk çeyreğine göre, şebekeye aktarıldığını varsaydığımız güneş enerjisiyle elektrik üretiminin yüzdesi (0-100). Bu durum, net ölçmeye izin verilmediği takdirde hesaplamaları etkiler. |
LeasingSavings
Belirli bir elektrik kullanımıyla belirli bir güneş paneli yapılandırmasını 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 kiralamaya izin verilmez). Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır. |
leasesSupported |
Bu yargı alanında finansal hesaplama motoru tarafından kiralamaların desteklenip desteklenmediği. Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır. Bu, |
annualLeasingCost |
Tahmini yıllık kiralama maliyeti. |
savings |
Kullanım süresi boyunca ne kadar tasarruf edildiği (veya edilmediği). |
SavingsOverTime
Farklı finansman yöntemleri arasında paylaşılan finansal bilgiler.
| JSON gösterimi |
|---|
{ "savingsYear1": { object ( |
| Alanlar | |
|---|---|
savingsYear1 |
Panel kurulumundan sonraki ilk yılda elde edilen tasarruf. |
savingsYear20 |
Panel kurulumundan sonraki ilk yirmi yılda elde edilen tasarruf. |
presentValueOfSavingsYear20 |
Varsayılan indirim oranı kullanıldığında, 20 yıllık kümülatif tasarrufun bugünkü değeri nedir? |
savingsLifetime |
Tüm panelin kullanım ömrü boyunca yapılan 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 olarak uygulanabilir olup olmadığını gösterir. Finansal yeterliliğin düşük olduğu (ör. para kaybettiren) senaryolarda yanlış olur. |
CashPurchaseSavings
Belirli bir elektrik kullanımıyla belirli bir güneş paneli yapılandırmasının 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 indirimlerinin değeri. |
savings |
Kullanım süresi boyunca ne kadar tasarruf edildiği (veya edilmediği). |
paybackYears |
Geri ödemenin gerçekleşmesine kadar geçen yıl sayısı. Negatif değer, geri ödemenin hiçbir zaman gerçekleşmeyeceği anlamına gelir. |
FinancedPurchaseSavings
Belirli bir elektrik kullanımıyla belirli bir güneş paneli yapılandırmasını 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 indirimlerinin değeri (Federal Yatırım Vergisi Kredisi (ITC) dahil). |
loanInterestRate |
Bu hesaplamalar grubunda varsayılan kredilerin faiz oranı. |
savings |
Kullanım süresi boyunca ne kadar tasarruf edildiği (veya edilmediği). |