- 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.
Sorgu noktasına en yakın binayı bulur. Sorgu noktasının yaklaşık 50 m yakınında bina yoksa NOT_FOUND
koduyla bir hata döndürülü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. |
required |
İsteğe bağlı. Sonuçlarda izin verilen minimum kalite düzeyi. Bundan daha düşük kaliteli sonuç döndürülmez. Bu değerin belirtilmemesi, 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 bilgi.
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. |
bounding |
Binanın sınırlayıcı kutusu. |
imagery |
Temel görüntünün edinildiği tarih. Bu yaklaşık bir değerdir. |
imagery |
Bu görüntüler üzerinde işleme ne zaman tamamlandı? |
postal |
Posta kodu (ör. ABD posta kodu) içinde bulunduğu. |
administrative |
Bu binayı içeren 1.idari bölge (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir. |
statistical |
İstatistik alanı (ör. ABD nüfus sayımı bölgesi) belirtin. |
region |
Bu binanın bulunduğu ülkenin (veya bölgenin) bölge kodu. |
solar |
Binanın güneş enerjisi potansiyeli. |
imagery |
Bu binanın verilerini hesaplamak için kullanılan görüntü kalitesi. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Enlem/boylam 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 bilgiler. Bu dosyadaki 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 | |
---|---|
max |
Maksimum dizi boyutu (yani çatıya sığabilecek maksimum panel sayısı). |
panel |
Hesaplamalarda kullanılan panelin watt cinsinden kapasitesi. |
panel |
Hesaplamalarda kullanılan panelin dikey yönde metre cinsinden yüksekliği. |
panel |
Hesaplamalarda kullanılan panelin dikey yönde genişliği (metre cinsinden). |
panel |
Güneş panellerinin beklenen yaşam süresi (yıl cinsinden). Bu değer, finansal hesaplamalarda kullanılır. |
max |
Maksimum dizinin metrekare cinsinden boyutu. |
max |
Çatının herhangi bir noktasında yılda alınan maksimum güneş ışığı süresi. Güneşlenme süresi, yılda alınan toplam güneşlenme (enerji) miktarının bir ölçüsüdür. 1 güneş ışığı saati = kW başına 1 kWh (burada kW, Standart Test Koşulları'ndaki kW kapasitesini ifade eder). |
carbon |
Şebeke elektriği başına üretilen eşdeğer CO2 miktarı. Bu, güneş enerjisi tarafından şebeke elektriğinin yerini alan karbon yoğunluğu ölçümüdür. |
whole |
Çatının bir çatı segmentine atanan kısmı için toplam boyut ve güneş ışığı yüzdeleri. Adına rağmen, binanın tamamı bu kapsamda olmayabilir. Şu sayfaya göz atın: |
building |
Çatının bazı segmentlerine atanmamış kısımları dahil olmak üzere binanın tamamının boyutu 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. |
roof |
Her çatı segmenti için boyut ve güneş ışığı yüzdelik dilimleri. |
solar |
Her |
solar |
Her |
financial |
|
SizeAndSunshineStats
Bir çatıya veya çatı parçasına ait boyut ve güneşlenme yüzdeleri.
JSON gösterimi |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Alanlar | |
---|---|
area |
Çatı veya çatı segmentinin metrekare cinsinden alanı. Bu, zemin ayak izi alanı değil, çatı alanıdır (eğim dikkate alınır). |
sunshine |
Alandaki noktasal güneşliliğin yüzdelik dilimleri. Burada N değer varsa bu, (N-1)-iles'i temsil eder. Örneğin, 5 değer varsa bunlar çeyrekler olur (min, %25, %50, %75, maks). Değerler, |
ground |
Çatı veya çatı segmentinin kapladığı zemin ayak izi alanı (m2). |
RoofSegmentSizeAndSunshineStats
Bir çatı segmentinin boyutu ve güneşli olma 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ı segmentinin merkezine yakın bir nokta. |
bounding |
Çatı segmentinin sınırlayıcı kutusu. |
pitch |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik. |
azimuth |
Çatı segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için ( |
plane |
|
SolarPanel
SolarPanel, tek bir güneş panelinin konumunu, yönünü ve üretimini tanımlar. 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 ortası. |
orientation |
Panelin yönü. |
yearly |
Bu düzenin bir yıl boyunca DC kW/sa cinsinden yakaladığı güneş ışığı enerjisi miktarı. |
segment |
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 azimutuyla ilgili olarak yorumlanmalıdır.
Sıralamalar | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Panel yönü bilinmiyor. |
LANDSCAPE |
LANDSCAPE panelinin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne dik olur. |
PORTRAIT |
PORTRAIT panelinin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne paraleldir. |
SolarPanelConfig
SolarPanelConfig, güneş panellerinin çatıya yerleştirilme şeklini tanımlar.
JSON gösterimi |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Alanlar | |
---|---|
panels |
Toplam panel sayısı. Bunun, |
yearly |
Yukarıda açıklanan paneller olduğu varsayıldığında, bu düzenin bir yıl boyunca DC kW/sa cinsinden ne kadar güneş ışığı enerjisi yakaladığı. |
roof |
Bu düzende en az bir panel taşıyan her çatı segmentinin üretimiyle ilgili bilgiler. |
RoofSegmentSummary
Binadaki bir çatı segmenti hakkında bilgi. Bu segmente belirli sayıda panel yerleştirilmiştir.
JSON gösterimi |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Alanlar | |
---|---|
panels |
Bu segmentteki toplam panel sayısı. |
yearly |
Yukarıda açıklanan paneller olduğu varsayıldığında, düzenin bu bölümünün bir yıl boyunca DC kW/sa cinsinden yakaladığı güneş ışığı enerjisi miktarı. |
pitch |
Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik. |
azimuth |
Çatı segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için ( |
segment |
İlgili |
FinancialAnalysis
Belirli bir elektrik faturası boyutu için optimum güneş paneli düzeninin maliyetinin ve avantajlarının analizi.
JSON gösterimi |
---|
{ "monthlyBill": { object ( |
Alanlar | |
---|---|
monthly |
Bu analizde varsayılan aylık elektrik faturası. |
default |
Bu binanın bulunduğu alan için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. |
average |
Fatura boyutuna ve yerel elektrik fiyatlarına göre evin ortalama bir ayda ne kadar elektrik kullandığı. |
financial |
Kullanılan finansman yönteminden bağımsız olarak geçerli olan finansal bilgiler. |
leasing |
Güneş panellerini kiralamanın maliyeti ve avantajları. |
cash |
Güneş panellerini nakit olarak satın almanın maliyeti ve avantajları. |
financed |
Satın alma işlemini finanse ederek güneş panelleri satın almanın maliyeti ve avantajı. |
panel |
Bu fatura boyutu için optimum güneş paneli düzeninin |
Para
Para birimi türüyle birlikte bir para tutarını temsil eder.
JSON gösterimi |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Alanlar | |
---|---|
currency |
ISO 4217'de tanımlanan üç harfli para birimi kodu. |
units |
Tutardaki tam birimler. Örneğin, |
nanos |
Miktarın nano (10^-9) birimi sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. |
FinancialDetails
Finansal analizin ayrıntıları. Bu ayrıntılardan bazıları zaten daha üst düzeylerde depolanmaktadır (ör. cep harçlığı maliyeti). Toplam para tutarları, SolarPotential
alanındaki panelLifetimeYears
alanı tarafından tanımlanan bir kullanım ömrü dönemi boyuncadır. Not: Panellerin satın alınmasıyla ilgili nakit maliyet, CashPurchaseSavings
alanındaki outOfPocketCost
alanında belirtilir.
JSON gösterimi |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Alanlar | |
---|---|
initial |
Güneş panellerinin ilk yıl içinde kaç AC kWh üreteceğini tahmin ediyoruz. |
remaining |
Panellerin kullanım ömrü boyunca güneş enerjisi tarafından üretilmeyen elektrik için altyapı hizmeti faturası. |
federal |
Federal teşviklerden kullanılabilecek para miktarı; bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir. |
state |
Eyalet teşviklerinden yararlanılabilen para tutarı. Bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir. |
utility |
Kamu teşviklerinden kullanılabilecek para miktarı. Bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir. |
lifetime |
Kullanıcının, panelin kullanım ömrü boyunca Güneş Yenilenebilir Enerji Kredileri'nden alacağı para tutarı. Bu, kullanıcının panelleri satın alması (kredi ile veya kredisiz) durumunda geçerlidir. |
cost |
Kullanıcının, güneş paneli kurmasaydı kullanım ömrü boyunca ödeyeceği toplam elektrik maliyeti. |
net |
Net sayaca izin verilip verilmediğini belirtir. |
solar |
Kullanıcının güneş enerjisinden sağladığı gücün yüzdesi (0-100). İlk yıl için geçerlidir ancak gelecek yıllar için yaklaşık olarak doğrudur. |
percentage |
Üretimin ilk çeyreğine göre, şebekeye aktarıldığını varsaydığımız güneş enerjisi üretiminin yüzdesi (0-100). Net ölçmeye izin verilmiyorsa bu durum hesaplamaları etkiler. |
LeasingSavings
Belirli bir elektrik tüketimine sahip belirli bir güneş paneli yapılandırmasının kiralanmasının maliyeti ve avantajı.
JSON gösterimi |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Alanlar | |
---|---|
leases |
Bu yargı alanında kira sözleşmelerine izin verilip verilmediği (bazı eyaletlerde kira sözleşmelerine izin verilmez). Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır. |
leases |
Kiralamaların bu yargı alanında finansal hesaplama motoru tarafından desteklenip desteklenmediği. Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır. Bu, |
annual |
Tahmini yıllık kiralama maliyeti. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı). |
SavingsOverTime
Farklı finansman yöntemleri arasında paylaşılan finansal bilgiler.
JSON gösterimi |
---|
{ "savingsYear1": { object ( |
Alanlar | |
---|---|
savings |
Panel kurulumundan sonraki ilk yıl içinde elde edilen tasarruf. |
savings |
Panel kurulumundan sonraki ilk yirmi yıl içinde elde edilen tasarruf. |
present |
Varsayılan indirim oranı kullanılarak 20 yıllık kümülatif tasarrufların bugünkü değeri nedir? |
savings |
Panelin tüm kullanım ömrü boyunca elde edilen tasarruf. |
present |
Varsayılan indirim oranı kullanılarak, kümülatif yaşam boyu tasarrufların bugünkü değeri nedir? |
financially |
Bu senaryoyu finansal açıdan uygun olup olmadığını belirtir. Finansal açıdan uygunluğu düşük olan senaryolar (ör. para kaybeden) için yanlış olur. |
CashPurchaseSavings
Belirli bir elektrik tüketimine sahip belirli bir güneş paneli yapılandırmasının doğrudan satın alınmasının maliyeti ve avantajı.
JSON gösterimi |
---|
{ "outOfPocketCost": { object ( |
Alanlar | |
---|---|
out |
Vergi teşviklerinden önceki başlangıç maliyeti: Nakit olarak ödenmesi gereken tutar. Vergi teşviklerinden sonraki |
upfront |
Vergi teşviklerinden sonraki ilk maliyet: İlk yıl ödenmesi gereken tutardır. Vergi teşviklerinden önceki |
rebate |
Tüm vergi iadelerinin değeri. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı). |
payback |
Geri ödemenin gerçekleşeceği yıl sayısı. Negatif değer, geri ödemenin yaşam boyu dönemde hiçbir zaman gerçekleşmediği anlamına gelir. |
FinancedPurchaseSavings
Belirli bir elektrik tüketimine sahip belirli bir güneş paneli konfigürasyonunu satın almak için kredi kullanmanın maliyeti ve avantajı.
JSON gösterimi |
---|
{ "annualLoanPayment": { object ( |
Alanlar | |
---|---|
annual |
Yıllık kredi ödemeleri. |
rebate |
Tüm vergi iadelerinin değeri (Federal Yatırım Vergisi Kredisi (ITC) dahil). |
loan |
Bu hesaplama grubunda varsayılan kredi faiz oranı. |
savings |
Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı). |