با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Solar API داده های پتانسیل خورشیدی را از طریق buildingInsights و dataLayers پایانی فراهم می کند. برای استفاده از داده های Solar API، درک مفاهیم زیر ممکن است مفید باشد:
پتانسیل خورشیدی یک ساختمان تا حد زیادی بر اساس میزان نور خورشیدی است که دریافت می کند و عوامل دیگر. تابش خورشیدی مقدار نوری است که به یک منطقه معین می‌تابد، در حالی که تابش خورشیدی اندازه‌گیری میانگین تابش خورشیدی است که یک منطقه در طول زمان دریافت می‌کند.
یک کیلووات (کیلووات) اندازه‌گیری توان یا نرخی است که چیزی در آن انرژی مصرف می‌کند، در حالی که کیلووات ساعت (کیلووات ساعت) اندازه‌گیری انرژی مصرف‌شده یا ظرفیت انرژی است. تابش خورشیدی بر حسب کیلووات و تابش خورشیدی بر حسب کیلووات ساعت اندازه گیری می شود.
1 کیلووات ساعت / کیلووات برابر با 1 ساعت خورشیدی است که به عنوان یک ساعت تعریف می شود که در آن شدت نور خورشید به طور متوسط به 1000 وات (1 کیلووات) انرژی در هر متر مربع می رسد.
به عنوان مثال، اگر بخشی از سقف دارای تابش خورشیدی 2000 کیلووات ساعت در کیلووات در سال باشد، یک آرایه پنل خورشیدی 1 کیلوواتی که در آنجا قرار داده شده است، 2000 کیلووات ساعت در سال تولید می کند. یک آرایه 4 کیلوواتی که در همان مکان قرار می گیرد، 8000 کیلووات ساعت در سال تولید می کند.
شرایط تست استاندارد یک معیار استاندارد صنعتی است که برای تعیین توان خروجی پنل خورشیدی استفاده می شود. در STC، میزان توان خروجی یک پنل خورشیدی به حداکثر توان یا ظرفیت آن تبدیل می شود. یک پانل 1 کیلوواتی 1 کیلووات ساعت انرژی تحت STC تولید می کند.
چندک آفتابی و آفتابی
Solar API "آفتابی" را به عنوان سطح نور خورشید دریافتی توسط بخش خاصی از سقف نسبت به بقیه سقف، به طور متوسط سالانه تعریف می کند. برخی از قسمت‌های سقف ممکن است تیره‌تر از بقیه باشند، به دلیل سایه ساختمان‌های مجاور یا پوشش درختان، در حالی که سایر قسمت‌های سقف ممکن است همیشه به طور کامل در معرض آسمان باشند و بنابراین نور خورشید بیشتری دریافت کنند.
فیلد sunshineQuantiles در پاسخ buildingInsights 11 سطل یا دهک از آفتابی بودن سقف یا بخشی از سقف را ارائه می‌کند. Solar API همه نقاط روی سقف را می گیرد، آنها را بر اساس "آفتابی بودن" آنها مرتب می کند و بالاترین، پایین ترین و 9 مقدار میانی را با فاصله مساوی مشخص می کند.
به عنوان مثال، فرض کنید که آفتابی ترین قسمت (1٪) یک سقف معین، 1100 کیلووات ساعت / کیلووات / سال دریافت می کند، در حالی که تاریک ترین قسمت (همچنین 1٪) همان سقف، 400 کیلووات ساعت / کیلووات / سال دریافت می کند. تاریک ترین 20 درصد سقف بعدی 500 کیلووات ساعت/کیلووات در سال دریافت می کند. 50% آفتابی بعدی سقف 900 کیلووات ساعت/کیلووات در سال دریافت می کند. 28 درصد باقیمانده 1000 کیلووات ساعت در کیلووات در سال دریافت می کنند.
رسترها
نقطه پایانی dataLayers اطلاعات خورشیدی کدگذاری شده در GeoTIFF ها را برمی گرداند که نوعی شطرنجی هستند.
رستر از ماتریسی از سلول ها یا پیکسل ها تشکیل شده است که در ردیف ها و ستون ها مرتب شده اند. هر پیکسل حاوی مقداری است که اطلاعات مربوط به آن مکان را نشان می دهد، مانند ارتفاع، تاج درخت، نور خورشید و غیره.
رسترها داده های گسسته و پیوسته را ذخیره می کنند. داده های گسسته ، مانند پوشش زمین یا نوع خاک، موضوعی یا طبقه ای هستند. داده های پیوسته پدیده هایی را نشان می دهد که هیچ مرز مشخصی ندارند، مانند ارتفاع یا تصاویر هوایی.
رسترها از باندهایی تشکیل شده‌اند که ویژگی‌های مختلف یک مجموعه داده را اندازه‌گیری می‌کنند. رسترها می توانند یک باند یا چند باند داشته باشند. هر باند از ماتریسی از سلول ها یا پیکسل ها تشکیل شده است که اطلاعات را ذخیره می کند. پیکسل ها می توانند مقادیر شناور یا عدد صحیح را ذخیره کنند.
عمق بیت یک پیکسل تعداد مقادیری را که یک پیکسل می تواند ذخیره کند، بر اساس فرمول 2 n نشان می دهد که n عمق بیت است. به عنوان مثال، یک پیکسل 8 بیتی می تواند حداکثر 256 (2 8 ) مقدار از 0 تا 255 را ذخیره کند.
شار
شما می توانید نقشه های شار را با استفاده از نقطه پایانی dataLayers درخواست کنید. Solar API شار را به عنوان مقدار سالانه نور خورشید روی سقف ها بر حسب کیلووات ساعت/کیلووات/سال تعریف می کند. در محاسبه شار، Solar API متغیرهای زیر را در نظر می گیرد:
اطلاعات مکان: Solar API از داده های تابش خورشیدی ساعتی از مجموعه های مختلف آب و هوا استفاده می کند، که معمولاً در یک شبکه 4 تا 10 کیلومتری هستند. API موقعیت خورشید را در آسمان در هر ساعت از سال محاسبه می کند. این بستگی به مکان دارد و در نتیجه ممکن است متفاوت باشد.
الگوهای آب و هوا (ابرها): اینها در داده های تابش خورشیدی به حساب می آیند.
سایه از موانع نزدیک: سایه از درختان، ساختمان های دیگر، و سایر قسمت های سقف در محاسبات در نظر گرفته می شود.
جهت: شیب و آزیموت هر قسمت از سقف.
بازده واقعی: مقادیر محاسبه شده توسط Solar API مستقل از بازده پانل هستند. برای محاسبه تولید انرژی، باید در کیلووات پنل ها ضرب کنید و سایر تلفات سیستم را محاسبه کنید. برای اطلاعات بیشتر، به محاسبه هزینه ها و صرفه جویی های خورشیدی مراجعه کنید.
Solar API متغیرهای زیر را در نظر نمی گیرد:
راندمان اینورتر و سایر تلفات: بیشتر مقادیر بر حسب کیلووات ساعت DC محاسبه می شوند، اما برخی از آنها با فرض بازده سیستم 85% به کیلووات ساعت متناوب تبدیل می شوند.
تاریخ آخرین بهروزرسانی 2025-04-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-04-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Solar API offers solar potential data for buildings, primarily focusing on sunlight exposure and utilizing two endpoints: \u003ccode\u003ebuildingInsights\u003c/code\u003e and \u003ccode\u003edataLayers\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSolar irradiance quantifies the amount of sunlight on a surface, while solar insolation measures the average irradiance over time, both crucial for determining a building's solar potential.\u003c/p\u003e\n"],["\u003cp\u003eSunniness is a relative measure of sunlight received by different roof sections, categorized into quantiles to represent variations in exposure due to shading.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edataLayers\u003c/code\u003e endpoint provides solar information through GeoTIFF rasters, which are grid-based images containing pixel values representing solar characteristics like flux.\u003c/p\u003e\n"],["\u003cp\u003eFlux, representing annual sunlight on roofs in kWh/kW/year, is calculated by the Solar API considering factors like location, weather, shade, roof orientation, and inherent efficiency.\u003c/p\u003e\n"]]],["The Solar API uses the buildingInsights and dataLayers endpoints to provide solar potential data. Key concepts include solar irradiance (light on an area) and insolation (average irradiance over time), measured in kilowatts (kW) and kilowatt-hours (kWh). Sunniness, quantified in 11 deciles, describes a roof's relative sunlight exposure. Rasters, composed of pixels with value data, store discrete and continuous information. Flux, the annual sunlight on roofs (kWh/kW/year), factors in location, weather, shading, and roof orientation.\n"],null,["# Solar API Concepts\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Solar API will no longer be returned. [Learn more](/maps/comms/eea/solar).\n\nThe Solar API provides solar potential data through the\n[buildingInsights](/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest) and [dataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers/get) endpoints. To use Solar API data,\nunderstanding the following concepts may be helpful:\n\n- [Solar irradiance and insolation](#solar-irradiance)\n- [Sunniness and sunshine quantiles](#sunniness)\n- [Rasters](#rasters)\n- [Flux](#flux)\n\nSolar irradiance and insolation\n-------------------------------\n\nA building's [solar potential](/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest#solarpotential) is largely based on the amount of sunlight it\nreceives, along with other factors. *Solar irradiance* is the amount of light\nthat falls on a given area, while *solar insolation* is a measurement of the\naverage solar irradiance an area receives over time.\n\nA *kilowatt* (kW) is a measure of *power* , or the rate at which something uses\nenergy, while a *kilowatt-hour* (kWh) is a measure of *energy* used or energy\ncapacity. Solar irradiance is measured in kilowatts, while solar insolation is\nmeasured in kilowatt-hours.\n\n1 kWh/kW equals 1 sun hour, which is defined as one hour where the intensity of\nsunlight reaches an average of 1,000 Watts (1 kilowatt) of energy per square\nmeter.\n\nFor example, if a part of a roof has a solar insolation of 2000 kWh/kW/year, a 1\nkW solar panel array placed there will produce 2000 kWh/year. A 4 kW array\nplaced in the same location will produce 8000 kWh/year.\n\n[Standard Test\nConditions](https://footprinthero.com/standard-test-conditions) are\nan industry standard benchmark used to determine solar panel power output. At\nSTC, the amount of power a solar panel outputs becomes its maximum power rating,\nor capacity. A 1 kW panel will generate 1 kWh of energy under STC.\n\nSunniness and sunshine quantiles\n--------------------------------\n\nThe Solar API defines \"sunniness\" as the level of sunlight received by a\nparticular section of a roof relative to the rest of the roof, annually on\naverage. Some parts of a roof may be darker than others, due to shade from\nnearby buildings or tree cover, while other parts of a roof may be fully exposed\nto the sky at all times and therefore receive more sunlight.\n\nThe [sunshineQuantiles](/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest#sizeandsunshinestats) field in the [buildingInsights](/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest) response provides 11\nbuckets, or deciles, of the sunniness of a roof or part of a roof. The\nSolar API takes all of the points on the roof, sorts them by their\n\"sunniness,\" and identifies the highest, lowest, and 9 intermediate evenly\nspaced values.\n\nFor example, assume that the sunniest part (1%) of a given roof receives\n1100 kWh/kW/year, while the darkest part (also 1%) of the same roof\nreceives 400 kWh/kW/year. The next darkest 20% of the roof receives 500\nkWh/kW/year. The next sunniest 50% of the roof receives 900 kWh/kW/year.\nThe remaining 28% receives 1000 kWh/kW/year.\n\nRasters\n-------\n\nThe [dataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers/get) endpoint returns solar information encoded in [GeoTIFFs](/maps/documentation/solar/geotiff), which\nare a type of raster.\n\nA *raster* is composed of a matrix of cells, or *pixels*, arranged in rows and\ncolumns. Each pixel contains a value that represents information about that\nlocation, such as elevation, tree canopy, sunlight, among others.\n\nRasters store *discrete* and *continuous* data. *Discrete* data, such as land\ncover or soil type, is thematic, or categorical. *Continuous* data represents\nphenomena that have no clear boundaries, such as elevation or aerial imagery.\n\nRasters are composed of *bands* , which measure different characteristics of a\ndataset. Rasters can have a single band or multiple bands. Each band is composed\nof a matrix of cells, or *pixels*, which store information. Pixels can store\nfloat or integer values.\n\nThe *bit depth* of a pixel indicates the number of values that a pixel can\nstore, based on the formula 2^n^, where *n* is the bit depth. For\nexample, an 8-bit pixel can store up to 256 (2^8^) values ranging from\n0 to 255.\n\nFlux\n----\n\nYou can request [flux maps](/maps/documentation/solar/data-layers) using the [dataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers/get) endpoint. The\nSolar API defines *flux* as the annual amount of sunlight on roofs in\nkWh/kW/year. In calculating flux, the Solar API takes the following\nvariables into account:\n\n- **Location information:** The Solar API uses hourly solar irradiance data from various weather sets, which are typically on a 4 to 10 km grid. The API computes the position of the sun in the sky at each hour of the year. This is location-dependent and may vary as a result.\n- **Weather patterns (clouds):** These are accounted for in the solar irradiance data.\n- **Shade from nearby obstacles:** Shading from trees, other buildings, and other parts of the roof are taken into account in calculations.\n- **Orientation:** The pitch and azimuth of each part of the roof.\n- **True efficiency:** The values computed by the Solar API are independent of the panel efficiency. To calculate energy production, you must multiply by the kilowattage of the panels and factor in other system losses. For more information, see [Calculate solar costs and\n savings](/maps/documentation/solar/calculate-costs-us).\n\nThe Solar API does not take the following variables into account:\n\n- **Inverter efficiency and other losses:** Most values are computed in DC kWh, but some are converted to AC kWh assuming an 85% system efficiency.\n- **Soiling and snow:** These are not included in the calculations."]]
