- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Money
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- 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ı. Sonuçlarda izin verilen minimum kalite seviyesi. Bundan daha düşük kaliteli sonuçlar döndürülmez. Bu seçeneğin belirtilmemesi, yalnızca YÜKSEK kaliteyle sınırlamaya eşdeğerdir. |
exactQualityRequired |
İsteğe bağlı. Görüntülerin tam kalitede olmasının gerekip gerekmediği. Yanlış olarak ayarlanırsa |
experiments[] |
İsteğe bağlı. Etkinleştirilecek GKST öncesi denemeleri belirtir. Bu alanın kullanıldığı istekler, Google Haritalar Platformu Hizmete Özgü Şartları uyarınca GKST öncesi teklif olarak sınıflandırılır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin. |
additionalInsights[] |
İsteğe bağlı. Yanıtına eklenecek |
İ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 |
Bu binanın bulunduğu posta kodu (ör. ABD posta kodu). |
administrativeArea |
Bu binanın bağlı olduğu 1.yer (ö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ş paneli dizileri algılandı. Bu alan yalnızca DETECTED_ARRAYS, 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. Belirtilmişse yanıtta |
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 kWh (kW, Standart Test Koşulları altındaki kapasiteyi ifade eder). |
carbonOffsetFactorKgPerMwh |
Şebeke elektriğinin MWh başına üretilen eşdeğer CO2 miktarı. Bu, güneş elektriğiyle 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, eğim hesaba katılarak hesaplanan çatı alanıdı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üzdelikleri 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, |
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 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 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 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 düzen 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 = zemine paralel, 90 = zemine 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 Solar 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ığını gösterir. |
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ş panellerini satın almanın maliyeti ve faydası. |
panelConfigIndex |
Bu fatura boyutu için optimum güneş paneli yerleşiminin |
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 miktarları, 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ş enerjisi kaynaklı elektrik üretiminin yüzdesi (0-100). Net ölçme izni verilmiyorsa bu durum 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 göz ardı edilmelidir. |
leasesSupported |
Bu yargı alanında finansal hesaplama motoru tarafından kiralamaların desteklenip desteklenmediği. Bu alan yanlışsa bu mesajdaki değerler muhtemelen göz ardı edilmelidir. 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 indirim 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 |
Vergiler hariç başlangıç maliyeti: 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). |
DetectedArrays
Binada algılanan güneş panelleri hakkında bilgiler.
| JSON gösterimi |
|---|
{ "detectionStatus": enum ( |
| Alanlar | |
|---|---|
detectionStatus |
Bu bina için güneş panellerinin algılama durumunu gösterir. |
latestCaptureDate |
En son güneş paneli verilerinin ne zaman alındığını gösteren tarih. |
DetectionStatus
Bu bina için güneş panellerinin algılama durumunu gösterir.
| Sıralamalar | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Durum belirtilmemiş. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Bu bina için algılanan güneş paneli verileri kullanılamıyor. |
DETECTION_STATUS_ARRAYS_DETECTED |
Bu bina için en az bir güneş paneli algılandı. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Bu bina için güneş paneli tespit edilmedi. |