- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Para
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Deneyin.
Merkez noktası, sorgu noktasına en yakın olan binayı bulur. Sorgu noktasının yaklaşık 50 m yakınında bina yoksa NOT_FOUND kodlu 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ığı boylam ve enlem. |
requiredQuality |
İsteğe bağlıdır. Sonuçlarda izin verilen minimum kalite seviyesi. Bu kaliteden daha düşük kalitede sonuç döndürülmez. Bu değerin belirtilmemesi, yalnızca YÜKSEK kaliteyle kısıtlama yapılmasına eşdeğerdir. |
exactQualityRequired |
İsteğe bağlıdır. Görüntülerin tam kalitesinin gerekli olup olmadığı. "False" olarak ayarlanırsa |
experiments[] |
İsteğe bağlıdır. Etkinleştirilecek GKST öncesi denemeleri belirtir. Bu alanı kullanan istekler, Google Haritalar Platformu Hizmete Özgü Şartları kapsamında GKST öncesi teklif olarak sınıflandırılır. Daha fazla bilgi için lansman aşaması açıklamalarına bakın. |
additionalInsights[] |
İsteğe bağlıdır. Yanıta dahil edilecek |
İ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 alındığı tarih. Bu yaklaşık bir değerdir. |
imageryProcessedDate |
Bu görüntülerin işlenmesinin tamamlandığı tarih. |
postalCode |
Bu binanın bulunduğu posta kodu (ör. ABD posta kodu). |
administrativeArea |
Bu binanın bağlı olduğu yer 1 (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir. |
statisticalArea |
Bu binanın bulunduğu istatistiksel alan (ör. ABD nüfus sayımı bölgesi). |
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. |
detectedArrays |
Binada güneş panelleri tespit edildi. Bu alan yalnızca isteğin |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
BuildingInsights'ta döndürülebilen çatı geometrisi ve güneş paneli dizileri gibi ek bina bilgileri.
| Sıralamalar | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Varsayılan değer. Varsayılan BuildingInsights döndürülür. |
DETECTED_ARRAYS |
Yanıtın algılanan dizileri içerip içermeyeceğini belirler. Belirtilirse yanıtta |
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 bilgi. Bu belgedeki bazı alanlar "panel" olarak tanımlanmıştı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 panel dizisinin boyutu (çatıya sığabilecek maksimum panel sayısı). |
panelCapacityWatts |
Hesaplamalarda kullanılan panelin watt cinsinden kapasitesi. |
panelHeightMeters |
Hesaplamalarda kullanılan panelin dikey yönde metre cinsinden yüksekliği. |
panelWidthMeters |
Hesaplamalarda kullanılan panelin dikey yöndeki genişliği (metre cinsinden). |
panelLifetimeYears |
Güneş panellerinin yıl cinsinden beklenen kullanım ömrü. Bu, 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şli saatler, yıllık toplam güneşlenme (enerji) miktarının bir ölçüsüdür. 1 güneşli saat = kW başına 1 kWh (kW, Standart Test Koşulları'ndaki kW kapasitesini ifade eder). |
carbonOffsetFactorKgPerMwh |
Şebeke elektriğinin MW/sa başına üretilen eşdeğer CO2 miktarı. Bu, güneş enerjisiyle üretilen elektriğin yerini aldığı şebeke elektriğinin karbon yoğunluğunun bir ölçüsüdür. |
wholeRoofStats |
Çatının bir çatı segmentine atanmış bölümü için toplam boyut ve güneş ışığı miktarları. Adına rağmen bu, tüm binayı kapsamayabilir. Şu sayfaya göz atın: |
buildingStats |
Çatının bazı segmentlerine atanmamış kısımları da dahil olmak üzere tüm binanın boyut ve güneş ışığı miktarı. 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ş ışığı miktarları. |
solarPanels[] |
Her |
solarPanelConfigs[] |
Her |
financialAnalyses[] |
|
SizeAndSunshineStats
Bir çatının veya çatının bir bölümünün boyut ve güneşlilik nicelikleri.
| JSON gösterimi |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Alanlar | |
|---|---|
areaMeters2 |
Çatının veya çatı segmentinin m^2 cinsinden alanı. Bu, zemin ayak izi alanı değil, çatı alanıdır (eğim hesaba katılır). |
sunshineQuantiles[] |
Bölge genelinde noktasal güneşlilik miktarının yüzdelik dilimleri. Burada N değer varsa bu, (N-1)-ile'leri temsil eder. Örneğin, 5 değer varsa bunlar çeyreklikler (min, %25, %50, %75, maks) olur. Değerler, |
groundAreaMeters2 |
Çatının veya çatı segmentinin kapladığı zemin ayak izi alanı (m^2 cinsinden). |
RoofSegmentSizeAndSunshineStats
Çatı segmentinin boyutu ve güneş alma miktarı dilimleri hakkında bilgi.
| JSON gösterimi |
|---|
{ "stats": { object ( |
| Alanlar | |
|---|---|
stats |
Çatı segmenti için toplam boyut ve güneş ışığı miktarları. |
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 baktığı pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için ( |
planeHeightAtCenterMeters |
|
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 ortası. |
orientation |
Panelin yönü. |
yearlyEnergyDcKwh |
Bu yerleşimin bir yıl boyunca yakaladığı güneş ışığı enerjisi miktarı (DC kWh cinsinden). |
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 |
Panel yönü bilinmiyor. |
LANDSCAPE |
LANDSCAPE panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne diktir. |
PORTRAIT |
PORTRAIT panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne paraleldir. |
SolarPanelConfig
SolarPanelConfig, güneş panellerinin çatıdaki belirli bir yerleşimini açıklar.
| JSON gösterimi |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Alanlar | |
|---|---|
panelsCount |
Toplam panel sayısı. Bu değerin, |
yearlyEnergyDcKwh |
Yukarıda açıklanan panellerin kullanıldığı varsayılarak bu yerleşimin bir yıl boyunca 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 ve üzerine yerleştirilen panel sayısı hakkında 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 paneller varsayılarak, yerleşimin bu bölümünün bir yıl boyunca 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 baktığı pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için ( |
segmentIndex |
İlgili |
FinancialAnalysis
Belirli bir elektrik faturası tutarı için optimum güneş enerjisi düzeninin maliyet ve fayda analizi.
| JSON gösterimi |
|---|
{ "monthlyBill": { object ( |
| Alanlar | |
|---|---|
monthlyBill |
Bu analizde varsayılan aylık elektrik faturası. |
defaultBill |
Bu binanın bulunduğu bölge için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. |
averageKwhPerMonth |
Fatura tutarına 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 avantajı. |
cashPurchaseSavings |
Güneş panellerini nakit olarak satın almanın maliyeti ve avantajı. |
financedPurchaseSavings |
Satın alma işlemini finanse ederek güneş panelleri satın almanın maliyeti ve avantajı. |
panelConfigIndex |
Bu fatura tutarı için optimum güneş enerjisi düzeninin |
Para
Para birimi türüyle birlikte para miktarını 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 tam birimleri. Örneğin, |
nanos |
Miktarı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 analizin ayrıntıları. Bu ayrıntılardan bazıları zaten daha yüksek seviyelerde (ör. cepten yapılan harcama) depolanır. Toplam para tutarları, SolarPotential içindeki panelLifetimeYears alanı tarafından tanımlanan bir kullanım süresi boyunca geçerlidir. Not: Panelleri satın almanın cepten yapılan harcaması, CashPurchaseSavings cinsinden outOfPocketCost alanında belirtilir.
| JSON gösterimi |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Alanlar | |
|---|---|
initialAcKwhPerYear |
Güneş panellerinin ilk yılında kaç AC kWh üreteceğini tahmin ediyoruz. |
remainingLifetimeUtilityBill |
Panellerin kullanım ömrü boyunca güneş enerjisiyle üretilmeyen elektrik için ödenecek altyapı hizmeti faturası. |
federalIncentive |
Federal teşviklerden elde edilebilecek para miktarı. Bu miktar, kullanıcı panelleri satın alırsa (krediyle veya kredisiz) 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 miktar, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir. |
lifetimeSrecTotal |
Kullanıcının panel kullanım ömrü boyunca Güneş Enerjisi 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 sistemi kurmaması durumunda kullanım ömrü boyunca ödeyeceği toplam elektrik maliyeti. |
netMeteringAllowed |
Net ölçüme izin verilip verilmediği. |
solarPercentage |
Kullanıcının güneş enerjisinden 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ı varsaydığımız güneş enerjisi kaynaklı elektrik üretiminin yüzdesi (0-100). Net ölçmeye izin verilmiyorsa bu durum hesaplamaları etkiler. |
LeasingSavings
Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını kiralamanın maliyeti ve avantajı.
| 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 durum |
annualLeasingCost |
Tahmini yıllık kiralama maliyeti. |
savings |
Kullanım ömrü 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 |
Panelin kullanım ömrü boyunca elde edilen tasarruf. |
presentValueOfSavingsLifetime |
Varsayılan indirim oranı kullanıldığında, kümülatif yaşam boyu tasarrufların bugünkü değeri nedir? |
financiallyViable |
Bu senaryonun finansal açıdan uygulanabilir olup olmadığını gösterir. Finansal açıdan yeterli olmayan senaryolar (ör. para kaybettiren) için "false" değerini alır. |
CashPurchaseSavings
Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını doğrudan satın almanın maliyeti ve avantajı.
| JSON gösterimi |
|---|
{ "outOfPocketCost": { object ( |
| Alanlar | |
|---|---|
outOfPocketCost |
Vergiler hariç ilk maliyet: Cebinizden ödemeniz 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 edilmediği). |
paybackYears |
Geri ödeme gerçekleşene kadar geçen yıl sayısı. Negatif değer, yaşam boyu dönemde hiçbir zaman geri ödeme yapılmadığı anlamına gelir. |
FinancedPurchaseSavings
Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını satın almak için kredi kullanmanın maliyeti ve avantajı.
| JSON gösterimi |
|---|
{ "annualLoanPayment": { object ( |
| Alanlar | |
|---|---|
annualLoanPayment |
Yıllık kredi ödemeleri. |
rebateValue |
Federal Yatırım Vergisi İndirimi (ITC) dahil olmak üzere tüm vergi iadelerinin değeri. |
loanInterestRate |
Bu hesaplama grubunda varsayılan kredi faiz oranı. |
savings |
Yaşam boyu dönemde ne kadar tasarruf edildiği (veya edilmediği). |
DetectedArrays
Binada algılanan güneş paneli dizileri hakkında bilgi.
| JSON gösterimi |
|---|
{ "detectionStatus": enum ( |
| Alanlar | |
|---|---|
detectionStatus |
Bu bina için güneş panellerinin algılanma durumunu gösterir. |
arrays[] |
Binada algılanan güneş paneli gruplarının listesi. |
latestCaptureDate |
En son güneş paneli verilerinin ne zaman alındığını gösteren tarih. |
DetectionStatus
Bu bina için güneş panellerinin algılanma durumunu gösterir.
| Sıralamalar | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Belirtilmemiş durum. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Bu bina için algılanan güneş paneli verisi yok. |
DETECTION_STATUS_ARRAYS_DETECTED |
Bu bina için en az bir güneş paneli dizisi algılandı. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Bu bina için güneş paneli dizisi algılanmadı. |
SolarArray
Algılanan tek bir güneş enerjisi paneliyle ilgili ayrıntılar.
| JSON gösterimi |
|---|
{ "polygonGeojson": { object } } |
| Alanlar | |
|---|---|
polygonGeojson |
Güneş panellerinin algılandığı bina alanının GeoJSON gösterimi. GeoJSON verileri RFC 7946 biçiminde olmalı ve tek bir bitişik alan için bir poligonu temsil etmelidir. Poligon, delikler içerdiğinde birkaç döngüyle temsil edilir. Örnek: { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |