Solar API のコンセプト
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Solar API は、buildingInsights エンドポイントと dataLayers エンドポイントを介して太陽光発電のポテンシャル データを提供します。Solar API データを使用するには、次のコンセプトを理解しておくと役立ちます。
太陽放射照度と日射量
建物の太陽光発電のポテンシャルは、主に、太陽光発電量やその他の要因によって変化します。日射照度は特定のエリアに当たる光の量であり、日射量はあるエリアが時間の経過とともに受ける平均日射照度の測定値です。
キロワット(kW)は電力(エネルギーを使用する速度)の尺度であり、キロワット時間(kWh)はエネルギー使用またはエネルギー容量の尺度です。太陽放射照度はキロワットで測定され、日射量はキロワット時で測定されます。
1 kWh/kW は 1 日時間に相当します。日光の強さが平均 1,000 ワット(1 キロワット)のエネルギーに達する 1 時間に相当します。
たとえば、屋根のある部分の日射量が 2, 000 kWh/kW/年の場合、その部分に配置した 1 kW の太陽光パネルの発電量は 2, 000 kWh/年になります。4 kW アレイを同じ場所に配置すると、8,000 kWh/年になります。
標準テスト条件は、太陽光パネルの発電出力を決定するために使用される業界標準のベンチマークです。STC では、太陽光パネルが出力する電力量が最大電力定格、つまり容量になります。1 kW のパネルで 1 kWh のエネルギーが STC 下で発電される。
日当たりと太陽光の分位数
Solar API では、「日照量」を、屋根の他の部分に対する屋根の特定の部分が受ける日射量の年間平均として定義します。近くの建物や樹木で日陰になる部分が他の部分より暗くなる場合や、屋根の他の部分は常に空に露出し、日光をより多く受け取れる部分があります。
buildingInsights レスポンスの sunshineQuantiles フィールドには、屋根または屋根の一部における日当たり度を 11 のバケット(十分位数)で指定します。Solar API は、屋根のすべてのポイントを取得して「日当たり」で並べ替え、等間隔の最高値、最低値、9 個の中間値を特定します。
たとえば、ある屋根の最も日当たりの良い部分(1%)は 1,100 kWh/kW/年を受信し、同じ屋根の最も暗い部分(同じ 1%)は 400 kWh/kW/年を受け取っているとします。次に最も暗い 20% の屋根の電力は 500 kWh/kW/年です。次に最も日当たりが強い屋根の 50% では 900 kWh/kW/年の電力を受信できます。残りの 28% は 1,000 kWh/kW/年の電力供給を受けます。
ラスター
dataLayers エンドポイントは、GeoTIFFs(ラスターの一種)でエンコードされた太陽光情報を返します。
ラスターは、行と列で構成される、セルのマトリックス(ピクセル)で構成されます。各ピクセルには、標高、樹木エリア、日照など、その場所に関する情報を表す値が含まれます。
ラスターには、離散データと連続データが保存されます。土地被覆や土壌の種類などの離散データは、テーマ別またはカテゴリ別です。連続データは、標高や航空画像など、明確な境界がない現象を表します。
ラスターは、データセットのさまざまな特性を表す「バンド」で構成されます。ラスターには 1 つのバンドを使用することも、複数のバンドを設定することもできます。各帯域は、情報を格納するセルのマトリックス(ピクセル)で構成されます。ピクセルには浮動小数点値または整数値を格納できます。
ピクセルのビット深度は、ピクセルに格納できる値の数を式 2n に基づいて示します。ここで、n はビット深度です。たとえば、8 ビット ピクセルは 0 ~ 255 の範囲で最大 256 個(28)の値を格納できます。

フラックス
フラックス マップをリクエストするには、dataLayers エンドポイントを使用します。Solar API では、屋根にかかる年間太陽光量としてフラックス(kWh/kW/年)を定義しています。フラックスの計算では、Solar API は次の変数を考慮します。
- 位置情報: Solar API は、さまざまな気象セット(通常は 4 ~ 10 km のグリッド)から 1 時間ごとの太陽放射照度データを使用します。この API は、空にある太陽の位置を時間ごとに計算します。これは地域によって異なるため、結果が変わる可能性があります。
- 天候パターン(雲): 太陽放射照度データに含まれます。
- 近くの障害物による日陰: 計算では、木、他の建物、屋根の他の部分による日陰が考慮されます。
- 向き: 屋根の各部分のピッチと方位角。
- 真の効率: Solar API によって計算される値は、パネルの効率とは関係ありません。発電量を計算するには、パネルのキロワットを掛け、他のシステム損失も考慮する必要があります。詳しくは、太陽光発電のコストと節約額を計算するをご覧ください。
Solar API では以下の変数は考慮されません。
- インバータの効率とその他の損失: ほとんどの値は DC kWh で計算されますが、一部はシステム効率 85% と仮定して AC kWh に変換します。
- 汚れと雪: これらは計算には含まれません。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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."]]