Solar API 개념
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Solar API는 buildingInsights 및 dataLayers 엔드포인트를 통해 태양광 잠재 데이터를 제공합니다. Solar API 데이터를 사용하려면
다음 개념을 이해하면 도움이 될 수 있습니다.
일사량 및 일사량
건물의 태양광 발전량은 주로 다른 요소와 함께 건물에서 받는 일광량의 영향을 받습니다. 태양 조도는 특정 영역에서 발생하는 빛의 양이고, 태양 일사량은 시간 경과에 따라 특정 구역에서 받는 평균 태양 조도의 측정값입니다.
킬로와트 (kW)는 전력 또는 에너지를 사용하는 비율을 의미하며 킬로와트시 (kWh)는 사용된 에너지 또는 에너지 용량을 측정합니다. 태양광 조도는 킬로와트 단위로 측정되고 태양광 일사량은 킬로와트시로 측정됩니다.
1kWh/kW는 1시간이며 햇빛의 강도가 제곱미터당 평균 1,000와트 (1킬로와트)의 에너지에 도달하는 1시간으로 정의됩니다.
예를 들어 지붕의 일부에 2, 000kWh/kW/년의 태양열 일사량이 있는 경우 여기에 설치된 1kW 태양 전지판 배열은 연간 2, 000kWh를 생산할 수 있습니다. 동일한 위치에 배치된 4kW 배열은 연간 8,000kWh를 생성합니다.
표준 테스트 조건은 태양광 패널 전력 출력을 결정하는 데 사용되는 업계 표준 벤치마크입니다. STC에서는 태양광 패널이 출력하는 전력량이 최대 전력 정격 또는 용량이 됩니다. STC 아래에서 1kW 패널은 1kWh 에너지를 생성합니다.
햇빛 및 햇빛 분위수
Solar API에서는 '햇빛의 강도'를 매년 평균 지붕의 나머지 부분과 비교하여 지붕의 특정 부분에서 받는 햇빛의 수준을 정의합니다. 지붕의 일부는 근처 건물이나 나무로 덮인 그늘로 인해 다른 부분보다 어두울 수 있으며 지붕의 다른 부분은 항상 하늘에 완전히 노출되어 더 많은 햇빛을 받을 수 있습니다.
buildingInsights 응답의 sunshineQuantiles 필드는 지붕 또는 지붕 일부의 햇살을 나타내는 11개의 버킷 또는 십분위수를 제공합니다. Solar API는 지붕에 있는 모든 점을 가져와 '윤정'에 따라 정렬하고 가장 높은 값, 가장 낮은 값, 9개의 중간 균등 간격 값을 식별합니다.
예를 들어 특정 지붕에서 가장 햇볕이 강한 부분 (1%)은 1, 100kWh/kW/년을 받는 반면, 같은 지붕의 가장 어두운 부분 (마찬가지 1%)은 400kWh/kW/년을 받는다고 가정해 보겠습니다. 지붕에서 그 다음으로 어두운 20%는 연간 500kWh/kW를 받습니다. 지붕에서 다음으로 가장 햇볕이 잘 드는 50%에 달하는 에너지가 연간 900kWh/kW입니다.
나머지 28%는 연간 1,000kWh/kW입니다.
래스터
dataLayers 엔드포인트는 래스터 유형인 GeoTIFFs로 인코딩된 태양광 정보를 반환합니다.
래스터는 행과 열로 구성된 셀 행렬 또는 픽셀로 구성됩니다. 각 픽셀에는 고도, 트리 캐노피, 햇빛 등 해당 위치에 관한 정보를 나타내는 값이 포함됩니다.
래스터는 불연속 및 연속 데이터를 저장합니다. 토지 피복이나 토양 유형과 같은 개별 데이터는 주제별 또는 범주형입니다. 연속 데이터는 고도 또는 항공 이미지와 같이 명확한 경계가 없는 현상을 나타냅니다.
래스터는 데이터 세트의 다양한 특성을 측정하는 대역으로 구성됩니다. 래스터에는 단일 밴드 또는 여러 밴드가 있을 수 있습니다. 각 밴드는 정보를 저장하는
셀 행렬 또는 픽셀로 구성됩니다. 픽셀은 부동 소수점 값 또는 정수 값을 저장할 수 있습니다.
픽셀의 비트 심도는 2n 수식에 따라 픽셀이 저장할 수 있는 값의 개수를 나타냅니다. 여기서 n은 비트 심도입니다. 예를 들어 8비트 픽셀은 0~255의 범위에서 최대 256 (28)개의 값을 저장할 수 있습니다.
플럭스
dataLayers 엔드포인트를 사용하여 플럭스 맵을 요청할 수 있습니다. Solar API에서는 플럭스를 지붕 위의 연간 태양광 양(kWh/kW/년)으로 정의합니다. 자속을 계산할 때 Solar API는 다음 변수를 고려합니다.
- 위치 정보: Solar API는 일반적으로 4~10km 그리드에 있는 다양한 기상 집합의 시간당 일사량 데이터를 사용합니다.
이 API는 매년 매 시간에 하늘에서 태양의 위치를 계산합니다. 이는 위치에 따라 다르며 따라서 달라질 수 있습니다.
- 기상 패턴 (구름): 태양 조도 데이터에 반영됩니다.
- 근처 장애물로 인한 그늘: 나무, 다른 건물 및 지붕의 다른 부분에서 비롯된 음영이 계산에 반영됩니다.
- 방향: 지붕 각 부분의 피치 및 방위각입니다.
- 실제 효율성: Solar API에서 계산한 값은 패널 효율성과 무관합니다. 에너지 생산을 계산하려면 패널의 킬로와트를 곱하고 다른 시스템 손실을 고려해야 합니다. 자세한 내용은 태양광 에너지 비용 및 절감액 계산하기를 참고하세요.
Solar API는 다음 변수를 고려하지 않습니다.
- 인버터 효율 및 기타 손실: 대부분의 값은 DC kWh 단위로 계산되지만, 일부 값은 시스템 효율성이 85%라고 가정할 때 AC kWh로 변환됩니다.
- 밑바닥 쌓기 및 눈: 이러한 값은 계산에 포함되지 않습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-06-26(UTC)
[null,null,["최종 업데이트: 2024-06-26(UTC)"],[[["\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."]]
