Package google.maps.solar.v1

Dizin

• Solar (arayüz)
• BuildingInsights (message)
• CashPurchaseSavings (message)
• DataLayerView (enum)
• DataLayers (mesaj)
• FinancedPurchaseSavings (message)
• FinancialAnalysis (message)
• FinancialDetails (message)
• FindClosestBuildingInsightsRequest (message)
• GetDataLayersRequest (message)
• GetGeoTiffRequest (message)
• ImageryQuality (enum)
• LatLngBox (mesaj)
• LeasingSavings (message)
• RoofSegmentSizeAndSunshineStats (message)
• RoofSegmentSummary (message)
• SavingsOverTime (message)
• SizeAndSunshineStats (message)
• SolarPanel (message)
• SolarPanelConfig (message)
• SolarPanelOrientation (enum)
• SolarPotential (mesaj)

Güneş

Solar API için hizmet tanımı.

FindClosestBuildingInsights
rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights) Merkezi bir sorgu noktasına en yakın olan 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. Yetkilendirme kapsamları Aşağıdaki OAuth kapsamını gerektirir: https://www.googleapis.com/auth/cloud-platform

GetDataLayers
rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers) Bir konumu çevreleyen bölgenin güneş enerjisi bilgilerini alır. Konum kapsama alanı dışındaysa NOT_FOUND koduyla bir hata döndürür. Yetkilendirme kapsamları Aşağıdaki OAuth kapsamını gerektirir: https://www.googleapis.com/auth/cloud-platform

GetGeoTiff
rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody) Bir resmi kimliğine göre döndürür. Yetkilendirme kapsamları Aşağıdaki OAuth kapsamını gerektirir: https://www.googleapis.com/auth/cloud-platform

BuildingInsights

Solar.FindClosestBuildingInsights için yanıt mesajı. Bir binanın konumu, boyutları ve güneş enerjisi potansiyeli hakkında bilgi.

Alanlar
name	string Binanın kaynak adı (buildings/{place_id} biçiminde).
center	LatLng Binanın merkezine yakın bir nokta.
bounding_box	LatLngBox Binanın sınırlayıcı kutusu.
imagery_date	Date Temel görüntünün edinildiği tarih. Bu yaklaşık bir değerdir.
imagery_processed_date	Date Bu görüntüler üzerinde işleme ne zaman tamamlandı?
postal_code	string Posta kodu (ör. ABD posta kodu) içinde yer aldığı bölgenin posta kodunu girin.
administrative_area	string Bu binayı içeren 1.idari bölge (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir.
statistical_area	string İstatistik alanı (ör. ABD nüfus sayımı bölgesi) belirtin.
region_code	string Bu binanın bulunduğu ülkenin (veya bölgenin) bölge kodu.
solar_potential	SolarPotential Binanın güneş enerjisi potansiyeli.
imagery_quality	ImageryQuality Bu binanın verilerini hesaplamak için kullanılan görüntü kalitesi.

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ı.

Alanlar
out_of_pocket_cost	Money Vergi teşviklerinden önceki başlangıç maliyeti: Nakit olarak ödenmesi gereken tutar. Vergi teşviklerinden sonraki upfront_cost ile karşılaştırın.
upfront_cost	Money Vergi teşviklerinden sonraki ilk maliyet: İlk yıl ödenmesi gereken tutardır. Vergi teşviklerinden önceki out_of_pocket_cost ile karşılaştırın.
rebate_value	Money Tüm vergi iadelerinin değeri.
savings	SavingsOverTime Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı).
payback_years	float 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.

DataLayerView

Döndürülecek güneş bilgilerinin alt kümesi.

Sıralamalar
DATA_LAYER_VIEW_UNSPECIFIED	TAM değerine eşdeğerdir.
DSM_LAYER	Yalnızca DSM'yi alın.
IMAGERY_LAYERS	DSM, RGB ve maskeyi alın.
IMAGERY_AND_ANNUAL_FLUX_LAYERS	DSM, RGB, maske ve yıllık akış elde edin.
IMAGERY_AND_ALL_FLUX_LAYERS	DSM, RGB, maske, yıllık akış ve aylık akış bilgilerini alın.
FULL_LAYERS	Tüm verileri alın.

DataLayers

Bir bölgenin güneş enerjisi potansiyeli hakkında bilgi. Gerçek veriler, istenen bölgeyi kapsayan ve bu iletideki URL'leri içeren bir dizi GeoTIFF dosyasında bulunur: DataLayers iletindeki her dize, ilgili GeoTIFF'in alınabileceği bir URL içerir. Bu URL'ler oluşturulduktan sonraki birkaç saat boyunca geçerlidir. GeoTIFF dosyalarının çoğu 0,1 m/piksel çözünürlüktedir ancak aylık akış dosyası 0,5 m/piksel, saatlik gölge dosyaları ise 1 m/piksel çözünürlüktedir. GetDataLayersRequest içinde bir pixel_size_meters değeri belirtilmişse GeoTIFF dosyalarındaki minimum çözünürlük bu değer olur.

Alanlar
imagery_date	Date Bu bölgedeki kaynak görüntüler (diğer tüm verilerin türetildiği görüntüler) ne zaman çekildi? Resimler birden fazla günde çekilmiş olabileceğinden bu değer biraz yaklaşıktir.
imagery_processed_date	Date Bu görüntüler üzerinde işleme ne zaman tamamlandı?
dsm_url	string Bölgenin DSM (Dijital Yüzey Modeli) resminin URL'si. Değerler, EGM96 jeoidinin (yani deniz seviyesinin) üstündeki metre cinsinden yüksekliktir. Geçersiz konumlar (verilerimizin olmadığı konumlar) -9999 olarak depolanır.
rgb_url	string Bölgenin RGB veri resminin (havadan fotoğraf) URL'si.
mask_url	string Bina maskesi resminin URL'si: Bir piksel başına bir bit. Bu piksel, bir çatı parçası olarak kabul edilip edilmediğini belirtir.
annual_flux_url	string Bölgenin yıllık akış haritasının (çatılara gelen yıllık güneş ışığı) URL'si. Değerler kWh/kW/yıl cinsindendir. Bu, maskesiz akıştır: Akış yalnızca binaların çatıları için değil, her konum için hesaplanır. Geçersiz konumlar -9999 olarak depolanır: Kapsama alanımızın dışındaki konumlar geçersiz olur ve kapsama alanındaki, akış hesaplayamadığımız birkaç konum da geçersiz olur.
monthly_flux_url	string Bölgenin aylık akış haritasının (çatılara gelen güneş ışığı, aya göre ayrılmış) URL'si. Değerler kWh/kW/yıl cinsindendir. Bu URL'nin gösterdiği GeoTIFF, sırasıyla Ocak-Aralık'a karşılık gelen on iki bant içerir.
hourly_shade_urls[]	string Saatlik gölge için sırasıyla Ocak-Aralık'a karşılık gelen on iki URL. Her GeoTIFF, günün 24 saatine karşılık gelen 24 bant içerir. Her piksel, ilgili ayın 31 gününe (en fazla) karşılık gelen 32 bitlik bir tam sayıdır. 1 bit, ilgili konumun ilgili ayın, ilgili günün, ilgili saatinde güneşi görebildiği anlamına gelir. Geçersiz konumlar -9999 olarak saklanır (negatif olduğu için 31. bit ayarlanmıştır ve ayın 32. gününe karşılık geldiği için hiçbir geçerli değer 31. bit ayarlayamaz). Bir örnek faydalı olabilir. Bir noktanın (piksel konumu (x, y)) 22 Haziran'da saat 16:00'da güneş görüp görmediğini öğrenmek istiyorsanız: Bu listedeki altıncı URL'yi (Haziran'a karşılık gelir) getirir. 17. kanalı (16:00'a karşılık gelir) bulun. (x, y) noktasındaki 32 bitlik değeri okuyun. değerin 21. bitini (ayın 22. gününe karşılık gelir) okur. Bu bit 1 ise söz konusu nokta 22 Haziran saat 16:00'da güneşi görmüştür. Daha resmi bir şekilde: month (1-12), day (1...ay maks.; Şubat 28 gündür) ve hour (0-23) değerleri verildiğinde, (x, y) konumundaki ilgili ay/gün/saat için gölge/güneş biti (hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1)) Burada (x, y), mekansal dizine ekleme, [month - 1] month - 1. URL'yi getirmeyi (sıfırdan dizine ekleme), [hour] kanallara dizine eklemeyi, sıfır olmayan nihai sonuç ise "güneşli" anlamına gelir. Artık gün yoktur ve yaz saati uygulaması yoktur (tüm günler 24 saattir; öğle zamanı her zaman "standart saat" öğle zamanıdır).
imagery_quality	ImageryQuality Sonuçtaki görüntülerin kalitesi.

FinancedPurchaseSavings

Belirli bir elektrik tüketimine sahip belirli bir güneş paneli konfigürasyonu satın almak için kredi kullanmanın maliyeti ve avantajı.

Alanlar
annual_loan_payment	Money Yıllık kredi ödemeleri.
rebate_value	Money Tüm vergi iadelerinin değeri (Federal Yatırım Vergi Kredisi (ITC) dahil).
loan_interest_rate	float Bu hesaplama grubunda varsayılan kredi faiz oranı.
savings	SavingsOverTime Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı).

FinancialAnalysis

Belirli bir elektrik faturası boyutu için optimum güneş paneli düzeninin maliyetinin ve avantajlarının analizi.

Alanlar
monthly_bill	Money Bu analizde varsayılan aylık elektrik faturası.
default_bill	bool Bu binanın bulunduğu alan için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. BuildingSolarPotential kapsamındaki tam olarak bir FinancialAnalysis için default_bill ayarlanmalıdır.
average_kwh_per_month	float Fatura boyutuna ve yerel elektrik fiyatlarına göre evin ortalama bir ayda ne kadar elektrik kullandığı.
financial_details	FinancialDetails Kullanılan finansman yönteminden bağımsız olarak geçerli olan finansal bilgiler.
leasing_savings	LeasingSavings Güneş panellerini kiralamanın maliyeti ve avantajları.
cash_purchase_savings	CashPurchaseSavings Güneş panellerini nakit olarak satın almanın maliyeti ve avantajları.
financed_purchase_savings	FinancedPurchaseSavings Satın alma işlemini finanse ederek güneş panelleri satın almanın maliyeti ve avantajı.
panel_config_index	int32 Bu fatura boyutu için optimum güneş paneli düzeninin solar_panel_configs dizinindeki dizini. Bu değer, düzen olmadığını belirten -1 olabilir. Bu durumda, kalan alt mesajlar atlanır.

FinancialDetails

Finansal analizin ayrıntıları. Bu ayrıntıların bazıları zaten daha üst düzeylerde depolanmaktadır (ör. cep harçlığı maliyeti). Toplam para tutarları, SolarPotential alanındaki panel_lifetime_years 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 out_of_pocket_cost alanında belirtilir.

Alanlar
initial_ac_kwh_per_year	float Güneş panellerinin ilk yıl içinde kaç AC kWh üreteceğini tahmin ediyoruz.
remaining_lifetime_utility_bill	Money Panellerin kullanım ömrü boyunca güneş enerjisi tarafından üretilmeyen elektrik için altyapı hizmeti faturası.
federal_incentive	Money Federal teşviklerden kullanılabilecek para miktarı; bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir.
state_incentive	Money Eyalet teşviklerinden yararlanılabilen para tutarı. Bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir.
utility_incentive	Money Kamu teşviklerinden kullanılabilecek para tutarı. Bu, kullanıcı panelleri satın alırsa (kredi ile veya kredisiz) geçerlidir.
lifetime_srec_total	Money 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_of_electricity_without_solar	Money Kullanıcının, güneş paneli kurmasaydı kullanım ömrü boyunca ödeyeceği toplam elektrik maliyeti.
net_metering_allowed	bool Net sayaca izin verilip verilmediğini belirtir.
solar_percentage	float 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_exported_to_grid	float Ü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.

FindClosestBuildingInsightsRequest

Solar.FindClosestBuildingInsights için istek mesajı.

Alanlar
location	LatLng Zorunlu. API'nin bilinen en yakın binayı aradığı boylam ve enlem.
required_quality	ImageryQuality İ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.

GetDataLayersRequest

Solar.GetDataLayers için istek mesajı.

Alanlar
location	LatLng Zorunlu. Veri alınacak bölgenin merkezinin boylamı ve enlemi.
radius_meters	float Zorunlu. Verilerin döndürülmesi gereken merkez noktayı çevreleyen bölgeyi tanımlayan, metre cinsinden yarıçap. Bu değerle ilgili sınırlamalar şunlardır: 100 metreye kadar herhangi bir değer her zaman belirtilebilir. radius_meters <= pixel_size_meters * 1000 olduğu sürece 100 m'den uzun değerler belirtilebilir. Ancak 175 m'den uzun değerler için istekteki DataLayerView, aylık akış veya saatlik gölge içermemelidir.
view	DataLayerView İsteğe bağlı. Döndürülecek verilerin istenen alt kümesi.
required_quality	ImageryQuality İ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.
pixel_size_meters	float İsteğe bağlı. Döndürülecek verilerin piksel başına metre cinsinden minimum ölçeği. 0,1 (bu alan açıkça ayarlanmamışsa varsayılan değer), 0,25, 0,5 ve 1,0 değerleri desteklenir. Normal çözünürlüğü pixel_size_meters'ten az olan görüntü bileşenleri, pixel_size_meters tarafından belirtilen çözünürlükte döndürülür. Normal çözünürlüğü pixel_size_meters'e eşit veya pixel_size_meters'ten büyük olan görüntü bileşenleri, normal çözünürlükte döndürülür.
exact_quality_required	bool İsteğe bağlı. Görüntülerin tam kalitede olmasının zorunlu olup olmadığı. Yanlış olarak ayarlanırsa required_quality alanı, minimum gerekli kalite olarak yorumlanır. Bu durumda, required_quality ORTAYA ayarlandığında YÜKSEK kaliteli görüntüler döndürülebilir. Doğru olarak ayarlanırsa required_quality tam olarak gerekli kalite olarak yorumlanır ve required_quality MEDIUM olarak ayarlanırsa yalnızca MEDIUM kalitesinde görüntüler döndürülür.

GetGeoTiffRequest

Solar.GetGeoTiff için istek mesajı.

Alanlar
id	string Zorunlu. İstenen öğenin kimliği.

ImageryQuality

Bazı API sonuçlarını hesaplamak için kullanılan görüntülerin kalitesi.

Not: Görüntü kalitesi düzeyinden bağımsız olarak DSM çıkışları her zaman 0, 1 m/piksel, aylık akış çıkışları her zaman 0, 5 m/piksel ve saatlik gölge çıkışları her zaman 1 m/piksel çözünürlüktedir.

Sıralamalar
IMAGERY_QUALITY_UNSPECIFIED	Kalite bilinmiyor.
HIGH	Güneş verileri, düşük rakımda çekilen ve 0,1 m/piksel çözünürlükte işlenen havadan görüntülerden elde edilir.
MEDIUM	Güneş enerjisi verileri, yüksek rakımda çekilen ve 0,25 m/piksel çözünürlükte işlenen gelişmiş havadan görüntülerden elde edilir.
LOW	Güneş enerjisi verileri, 0,25 m/piksel çözünürlükte işlenen gelişmiş uydu görüntülerinden elde edilir.
BASE	Güneş enerjisi verileri, 0,25 m/piksel çözünürlükte işlenen gelişmiş uydu görüntülerinden elde edilir.

LatLngBox

Enlem/boylam koordinatlarında bir sınırlayıcı kutu.

Alanlar
sw	LatLng Kutunun güneybatı köşesi.
ne	LatLng Kutunun kuzeydoğu köşesi.

LeasingSavings

Belirli bir elektrik tüketimine sahip belirli bir güneş paneli yapılandırmasının kiralanmasının maliyeti ve avantajı.

Alanlar
leases_allowed	bool 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_supported	bool 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, leases_allowed ile ilgili değildir: Bazı bölgelerde kiralamaya izin verilir ancak finansal modeller tarafından ele alınmayan koşullarda.
annual_leasing_cost	Money Tahmini yıllık kiralama maliyeti.
savings	SavingsOverTime Kullanım ömrü boyunca ne kadar tasarruf sağlandığı (veya sağlanmadığı).

RoofSegmentSizeAndSunshineStats

Bir çatı segmentinin boyutu ve güneşli olma yüzdeleri hakkında bilgi.

Alanlar
stats	SizeAndSunshineStats Çatı segmenti için toplam boyut ve güneş ışığı yüzdeleri.
center	LatLng Çatı segmentinin merkezine yakın bir nokta.
bounding_box	LatLngBox Çatı segmentinin sınırlayıcı kutusu.
pitch_degrees	float Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik.
azimuth_degrees	float Çatı segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (pitch_degrees 0'a çok yakın) azimut iyi tanımlanmaz. Bu nedenle tutarlılık için azimutu keyfi olarak 0 (Kuzey) olarak tanımlarız.
plane_height_at_center_meters	float center ile belirtilen noktada, çatı segmenti düzleminin deniz seviyesinden yüksekliği (metre cinsinden). Bu değer, eğim, azimut ve merkez konumla birlikte çatı segmenti düzlemindeki tüm noktaları tanımlar.

RoofSegmentSummary

Binanın üzerine yerleştirilmiş bir dizi panelin bulunduğu çatı segmenti hakkında bilgi.

Alanlar
panels_count	int32 Bu segmentteki toplam panel sayısı.
yearly_energy_dc_kwh	float 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 ne kadar güneş ışığı enerjisi yakaladığı.
pitch_degrees	float Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = zemine paralel, 90 = zemine dik.
azimuth_degrees	float Çatı segmentinin gösterdiği pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (pitch_degrees 0'a çok yakın) azimut iyi tanımlanmaz. Bu nedenle tutarlılık için azimutu keyfi olarak 0 (Kuzey) olarak tanımlarız.
segment_index	int32 İlgili RoofSegmentSizeAndSunshineStats için roof_segment_stats'teki dizin.

SavingsOverTime

Farklı finansman yöntemleri arasında paylaşılan finansal bilgiler.

Alanlar
savings_year1	Money Panel kurulumundan sonraki ilk yıl içinde elde edilen tasarruf.
savings_year20	Money Panel kurulumundan sonraki ilk yirmi yıl içinde elde edilen tasarruf.
present_value_of_savings_year20	Money Varsayılan indirim oranı kullanılarak 20 yıllık kümülatif tasarrufların bugünkü değeri nedir?
savings_lifetime	Money Panelin tüm kullanım ömrü boyunca elde edilen tasarruf.
present_value_of_savings_lifetime	Money Varsayılan indirim oranı kullanılarak, kümülatif yaşam boyu tasarrufların bugünkü değeri nedir?
financially_viable	bool Bu senaryoyu finansal açıdan uygun olup olmadığını gösterir. Finansal açıdan uygunluğu düşük olan senaryolar (ör. para kaybeden) için yanlış olur.

SizeAndSunshineStats

Bir çatıya veya çatının bir bölümüne ait boyut ve güneşlenme yüzdeleri.

Alanlar
area_meters2	float Ç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_quantiles[]	float 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, max_sunshine_hours_per_year gibi yıllık kW/sa/kW cinsindendir.
ground_area_meters2	float Çatı veya çatı segmentinin kapladığı yer ayak izi alanı (m2).

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 panel_height_meters, panel_width_meters ve panel_capacity_watts alanlarına bakın.

Alanlar
center	LatLng Panelin ortası.
orientation	SolarPanelOrientation Panelin yönü.
yearly_energy_dc_kwh	float Bu düzenin bir yıl boyunca DC kW-sa cinsinden yakaladığı güneş ışığı enerjisi miktarı.
segment_index	int32 Bu panelin yerleştirildiği çatı segmentine karşılık gelen RoofSegmentSizeAndSunshineStats içindeki roof_segment_stats dizini.

SolarPanelConfig

SolarPanelConfig, güneş panellerinin çatıya yerleştirilme şeklini tanımlar.

Alanlar
panels_count	int32 Toplam panel sayısı. Bunun, roof_segment_summaries'teki ilgili alanlarla (toplamı) aynı olduğunu unutmayın.
yearly_energy_dc_kwh	float 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_segment_summaries[]	RoofSegmentSummary Bu düzende en az bir panel taşıyan her çatı segmentinin üretimiyle ilgili bilgiler. roof_segment_summaries[i], boyutu, beklenen üretimi ve yönü dahil olmak üzere i. çatı segmentini tanımlar.

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.

SolarPotential

Bir binanın güneş enerjisi potansiyeli hakkında bilgiler. Bu dosyadaki bazı alanlar "paneller" şeklinde tanımlanır. panel_capacity_watts, panel_height_meters ve panel_width_meters alanları, bu hesaplamalarda kullanılan panel modelinin parametrelerini açıklar.

Alanlar
max_array_panels_count	int32 Maksimum dizi boyutu (yani çatıya sığabilecek maksimum panel sayısı).
panel_capacity_watts	float Hesaplamalarda kullanılan panelin watt cinsinden kapasitesi.
panel_height_meters	float Hesaplamalarda kullanılan panelin dikey yönde metre cinsinden yüksekliği.
panel_width_meters	float Hesaplamalarda kullanılan panelin dikey yönde genişliği (metre cinsinden).
panel_lifetime_years	int32 Güneş panellerinin beklenen yaşam süresi (yıl cinsinden). Bu değer, finansal hesaplamalarda kullanılır.
max_array_area_meters2	float Maksimum dizinin metrekare cinsinden boyutu.
max_sunshine_hours_per_year	float Ç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_offset_factor_kg_per_mwh	float Ş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_roof_stats	SizeAndSunshineStats Çatının bir çatı segmentine atanan kısmı için toplam boyut ve güneş ışığı yüzdelik dilimleri. Adına rağmen, binanın tamamı bu kapsamda olmayabilir. Şu sayfaya göz atın: building_stats.
building_stats	SizeAndSunshineStats Ç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. whole_roof_stats'teki çatı alanının building_stats ve whole_roof_stats'nin zemin alanlarının oranına göre ölçeklendirilmesiyle daha güvenilir bir bina çatı alanı elde edilebilir.
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats Her çatı segmenti için boyut ve güneş ışığı yüzdelik dilimleri.
solar_panels[]	SolarPanel Her SolarPanel, tek bir güneş panelini tanımlar. Bunlar, panel düzeni algoritmasının yerleştirdiği sırayla listelenir. Bu genellikle (her zaman olmasa da) yıllık enerji üretiminin azalan sırasına göre yapılır.
solar_panel_configs[]	SolarPanelConfig Her SolarPanelConfig, çatıdaki güneş panellerinin farklı bir düzenini tanımlar. Panel sayısı arttıkça sırayla gösterilir. panels_count=N olan SolarPanelConfig, solar_panels listesindeki ilk N paneli temel alır. Bu alan yalnızca bir çatıya en az 4 panel sığabiliyorsa doldurulur.
financial_analyses[]	FinancialAnalysis FinancialAnalysis, belirli bir aylık fatura ve belirli bir elektrik sağlayıcı varken güneş enerjisine geçişten elde edilen tasarrufu gösterir. Aylık fatura tutarının arttığı sırayla gösterilir. Bu alan, Solar API'nin finansal hesaplamalar yapmak için yeterli bilgiye sahip olmadığı bölgelerdeki binalar için boş olur.