インデックス
Solar
(インターフェース)BuildingInsights
(メッセージ)CashPurchaseSavings
(メッセージ)DataLayerView
(列挙型)DataLayers
(メッセージ)FinancedPurchaseSavings
(メッセージ)FinancialAnalysis
(メッセージ)FinancialDetails
(メッセージ)FindClosestBuildingInsightsRequest
(メッセージ)GetDataLayersRequest
(メッセージ)GetGeoTiffRequest
(メッセージ)ImageryQuality
(列挙型)LatLngBox
(メッセージ)LeasingSavings
(メッセージ)RoofSegmentSizeAndSunshineStats
(メッセージ)RoofSegmentSummary
(メッセージ)SavingsOverTime
(メッセージ)SizeAndSunshineStats
(メッセージ)SolarPanel
(メッセージ)SolarPanelConfig
(メッセージ)SolarPanelOrientation
(列挙型)SolarPotential
(メッセージ)
Solar
Solar API のサービス定義。
FindClosestBuildingInsights |
---|
クエリポイントに最も近い重心を持つ建物を検索します。クエリポイントから約 50 m 以内に建物がない場合、コード
|
GetDataLayers |
---|
ある地点の位置周辺地域の太陽光発電に関する情報を取得します。位置情報がカバレッジエリア外にある場合は、コード
|
GetGeoTiff |
---|
ID で画像を返します。
|
BuildingInsights
Solar.FindClosestBuildingInsights
に対するレスポンス メッセージです。建物の位置、面積、太陽光発電のポテンシャルに関する情報。
フィールド | |
---|---|
name |
建物のリソース名( |
center |
建物の中心付近のポイント。 |
bounding_box |
建物の境界ボックス。 |
imagery_date |
基盤となる画像が取得された日付。これはおおよその値です。 |
imagery_processed_date |
この画像の処理が完了した日時。 |
postal_code |
郵便番号(例: 米国の郵便番号)を入力します。 |
administrative_area |
この建物が含まれる行政区域 1(米国では州など)。たとえば、米国では「MA」または「CA」という略称が使用されます。 |
statistical_area |
統計圏(例: 米国の国勢調査区)を入力します。 |
region_code |
この建物が存在する国(または地域)の地域コード。 |
solar_potential |
建物の太陽光発電のポテンシャル。 |
imagery_quality |
この建物のデータを計算するために使用された画像の品質。 |
CashPurchaseSavings
特定の電力使用量で特定の構成の太陽光パネルを直接購入する場合の費用とメリット。
フィールド | |
---|---|
out_of_pocket_cost |
税制優遇措置前の初期費用: 自己負担で支払う金額。税制優遇措置後の |
upfront_cost |
税制優遇後の初期費用: 1 年目に支払う必要のある金額です。税制優遇措置が適用される前の |
rebate_value |
すべての税金還付の金額。 |
savings |
ライフタイム期間でどれだけ節約できるか(またはできないか)。 |
payback_years |
投資回収までの年数。負の値は、ライフタイム期間内に収益が得られないことを示します。 |
DataLayerView
返される太陽光発電情報のサブセット。
列挙型 | |
---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
FULL と同じです。 |
DSM_LAYER |
DSM のみを取得します。 |
IMAGERY_LAYERS |
DSM、RGB、マスクを取得します。 |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
DSM、RGB、マスク、年間フラックスを取得します。 |
IMAGERY_AND_ALL_FLUX_LAYERS |
DSM、RGB、マスク、年間フラックス、月間フラックスを取得します。 |
FULL_LAYERS |
すべてのデータを取得します。 |
DataLayers
地域の太陽光発電の可能性に関する情報。実際のデータは、リクエストされた地域をカバーする複数の GeoTIFF ファイルに含まれており、このメッセージには URL が含まれています。DataLayers
メッセージの各文字列には、対応する GeoTIFF を取得できる URL が含まれています。これらの URL は、生成されてから数時間有効です。ほとんどの GeoTIFF ファイルの解像度は 0.1 m/ピクセルですが、月単位のフルクスのファイルは 0.5 m/ピクセル、1 時間単位のシェードのファイルは 1 m/ピクセルです。GetDataLayersRequest
で pixel_size_meters
値が指定されている場合、GeoTIFF ファイルの最小解像度はその値になります。
フィールド | |
---|---|
imagery_date |
この地域のソース画像(他のすべてのデータが派生する画像)が撮影された日時。画像が複数日にわたって撮影されている可能性があるため、多少の誤差が生じる可能性があります。 |
imagery_processed_date |
この画像の処理が完了した日時。 |
dsm_url |
地域の DSM(数値表層モデル)の画像の URL。値は EGM96 ジオイド(海面)からの高さ(メートル)です。無効な場所(データがない場所)は -9999 として保存されます。 |
rgb_url |
対象地域の RGB データ(航空写真)の画像の URL。 |
mask_url |
建物マスク画像の URL: ピクセルごとに 1 ビットで、そのピクセルが屋根の一部と見なされるかどうかを示します。 |
annual_flux_url |
地域の年間フラックス マップ(屋根に当たる年間日光)の URL。値は kWh/kW/年です。これはマスクなしのフルクスです。フルクスは、建物の屋上だけでなく、すべての場所で計算されます。無効な場所は -9999 として保存されます。測定範囲外の場所は無効になります。また、測定範囲内でも、フリュークスを計算できなかった場所も無効になります。 |
monthly_flux_url |
地域の月ごとのフルス マップ(屋根に当たる日光、月別)の URL。値は kWh/kW/年です。この URL が指す GeoTIFF には、1 月から 12 月に対応する 12 個のバンドが順番に含まれます。 |
hourly_shade_urls[] |
1 月から 12 月までの 12 個の URL(1 時間ごとの日陰)。各 GeoTIFF には、1 日の 24 時間に対応する 24 個のバンドが含まれます。各ピクセルは 32 ビットの整数で、その月の(最大)31 日に対応しています。1 ビットは、対応する場所がその月のその日、その時間帯に太陽を見ることができることを意味します。無効な位置情報は -9999 として保存されます(負の値であるため、ビット 31 が設定されています。有効な値ではビット 31 を設定できません。これは、月末の 32 日目に相当するためです)。 例を挙げましょう。6 月 22 日午後 4 時に、ある点(ピクセル位置(x, y))に太陽が当たっていたかどうかを確認するには、次のようにします。
より正式には、
ここで、 |
imagery_quality |
結果の画像の品質。 |
FinancedPurchaseSavings
特定の電力使用量で特定の構成の太陽光パネルを購入するためにローンを使用する場合の費用とメリット。
フィールド | |
---|---|
annual_loan_payment |
ローンの年間支払い額。 |
rebate_value |
すべての税額控除の金額(連邦投資税額控除(ITC)を含む)。 |
loan_interest_rate |
この一連の計算で想定されるローンの利率。 |
savings |
ライフタイム期間でどれだけ節約できるか(またはできないか)。 |
FinancialAnalysis
特定の電気料金の金額に最適な太陽光発電システムのレイアウトの費用とメリットを分析します。
フィールド | |
---|---|
monthly_bill |
この分析で想定する毎月の電気代。 |
default_bill |
この請求書サイズが、この建物がある地域のデフォルトの請求書として選択されているかどうか。 |
average_kwh_per_month |
請求額と地域の電気料金に基づく、家で 1 か月あたりに使用される電力量。 |
financial_details |
使用される融資方法に関係なく適用される財務情報。 |
leasing_savings |
太陽光パネルのリースの費用とメリット。 |
cash_purchase_savings |
現金で太陽光パネルを購入する場合の費用とメリット。 |
financed_purchase_savings |
太陽光パネルの購入に融資を利用した場合の費用とメリット。 |
panel_config_index |
この請求額に最適なソーラー レイアウトの |
FinancialDetails
財務分析の詳細。これらの詳細情報の一部は、すでに上位レベルに保存されています(自己負担額など)。合計金額は、SolarPotential
の panel_lifetime_years
フィールドで定義された全期間のものです。注: パネルの購入にかかる自己負担額は、CashPurchaseSavings
の out_of_pocket_cost
フィールドに指定します。
フィールド | |
---|---|
initial_ac_kwh_per_year |
太陽光パネルが初年度に生成すると想定される AC kWh 数。 |
remaining_lifetime_utility_bill |
太陽光発電で発電されなかった電力の使用量に対する公共料金(パネルの寿命分)。 |
federal_incentive |
連邦政府の補助金から利用できる金額。これは、ユーザーがパネルを購入する場合(ローンありまたはローンなし)に適用されます。 |
state_incentive |
州の補助金から利用できる金額。これは、ユーザーがパネルを(ローンありまたはローンなしで)購入する場合に適用されます。 |
utility_incentive |
電力会社のインセンティブから利用できる金額。これは、ユーザーがパネルを(ローンありまたはローンなしで)購入する場合に適用されます。 |
lifetime_srec_total |
パネルの全期間にわたってユーザーが太陽光再生可能エネルギークレジットから受け取る金額。これは、ユーザーがパネルを購入した場合(ローンありまたはローンなし)に適用されます。 |
cost_of_electricity_without_solar |
太陽光発電システムを設置しなかった場合、ユーザーがライフタイム全体で支払う電気代合計。 |
net_metering_allowed |
ネット メータリングが許可されているかどうか。 |
solar_percentage |
太陽光発電で供給される電力の割合(0 ~ 100)。最初の 1 年間は有効ですが、それ以降は概算です。 |
percentage_exported_to_grid |
1 四半期の発電量に基づいて、グリッドに送電されたと想定される太陽光発電の割合(0 ~ 100)。これは、ネット メータリングが許可されていない場合に計算に影響します。 |
FindClosestBuildingInsightsRequest
Solar.FindClosestBuildingInsights
のリクエスト メッセージです。
フィールド | |
---|---|
location |
必須。API が既知の建物の中で最も近いものを検索する経度と緯度。 |
required_quality |
省略可。結果で許可される最小品質レベル。この値より低い品質の結果は返されません。指定しなかった場合、品質が「高」の動画のみが検索対象になります。 |
GetDataLayersRequest
Solar.GetDataLayers
のリクエスト メッセージです。
フィールド | |
---|---|
location |
必須。データを取得する地域の中心の緯度と経度。 |
radius_meters |
必須。中心点の周囲の領域を定義する半径(メートル単位)。この領域のデータが返されます。この値には次の制限があります。
|
view |
省略可。返されるデータのサブセット。 |
required_quality |
省略可。結果で許可される最小品質レベル。この値より低い品質の結果は返されません。指定しなかった場合、品質が「高」の動画のみが検索対象になります。 |
pixel_size_meters |
省略可。返されるデータの最小スケール(ピクセルあたりのメートル単位)。サポートされている値は、0.1(このフィールドが明示的に設定されていない場合のデフォルト)、0.25、0.5、1.0 です。通常の解像度が |
exact_quality_required |
省略可。画像の品質を厳密に指定するかどうか。false に設定すると、 |
GetGeoTiffRequest
Solar.GetGeoTiff
のリクエスト メッセージです。
フィールド | |
---|---|
id |
必須。リクエストされたアセットの ID。 |
ImageryQuality
一部の API の結果の計算に使用される画像の品質。
注: 画像品質レベルにかかわらず、DSM 出力の解像度は常に 0.1 m/ピクセルで、月次フックスの出力の解像度は常に 0.5 m/ピクセルで、1 時間ごとの陰影の出力の解像度は常に 1 m/ピクセルです。
列挙型 | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
品質は不明です。 |
HIGH |
太陽光データは、低高度で撮影された航空画像から取得され、0.1 m/ピクセルで処理されます。 |
MEDIUM |
太陽光データは、高高度で撮影されたエンハンスト航空画像から取得され、ピクセルあたり 0.25 m で処理されます。 |
LOW |
太陽光データは、0.25 m/ピクセルで処理された高度な衛星画像から取得されます。 |
BASE |
太陽光データは、0.25 m/ピクセルで処理された高度な衛星画像から取得されます。 |
LatLngBox
緯度/経度座標の境界ボックス。
LeasingSavings
特定の電力使用量で特定の構成の太陽光パネルをリースする場合の費用とメリット。
フィールド | |
---|---|
leases_allowed |
この地域で賃貸が許可されているかどうか(一部の州では賃貸が許可されていません)。このフィールドが false の場合、このメッセージの値は無視される可能性があります。 |
leases_supported |
この地域で、財務計算エンジンがリースをサポートしているかどうか。このフィールドが false の場合、このメッセージの値は無視される可能性があります。これは |
annual_leasing_cost |
年間の賃貸費用の見積もり。 |
savings |
ライフタイム期間でどれだけ節約できるか(またはできないか)。 |
RoofSegmentSizeAndSunshineStats
屋根セグメントのサイズと日照量分位数に関する情報。
フィールド | |
---|---|
stats |
屋根セグメントの合計サイズと日射量分位数。 |
center |
屋根セグメントの中心付近の点。 |
bounding_box |
屋根セグメントの境界ボックス。 |
pitch_degrees |
理論上の地面に対して屋根セグメントの角度。0 = 地面と平行、90 = 地面に対して垂直。 |
azimuth_degrees |
屋根セグメントが向いているコンパス方位。0 = 北、90 = 東、180 = 南。「フラット」な屋根セグメント( |
plane_height_at_center_meters |
|
RoofSegmentSummary
建物の屋根セグメントに関する情報(パネルが設置されている)。
フィールド | |
---|---|
panels_count |
このセグメントのパネルの合計数。 |
yearly_energy_dc_kwh |
上記のパネルを前提として、このレイアウトのこの部分が 1 年間に集める太陽光エネルギーの量(DC kWh)。 |
pitch_degrees |
理論上の地面に対して屋根セグメントの角度。0 = 地面と平行、90 = 地面に対して垂直。 |
azimuth_degrees |
屋根セグメントが向いているコンパス方位。0 = 北、90 = 東、180 = 南。「フラット」な屋根セグメント( |
segment_index |
対応する |
SavingsOverTime
さまざまな支払い方法間で共有される財務情報。
フィールド | |
---|---|
savings_year1 |
パネル設置後の最初の 1 年間の節電額。 |
savings_year20 |
パネル設置後 20 年間の節約額。 |
present_value_of_savings_year20 |
想定された割引率を使用して、20 年間の累積貯蓄の現在価値はいくらですか。 |
savings_lifetime |
パネルの全期間における節約額。 |
present_value_of_savings_lifetime |
想定された割引率を使用して、生涯の累積節約額の現在価値はいくらですか。 |
financially_viable |
このシナリオが経済的に実行可能かどうかを示します。経済的な実行可能性が低いシナリオ(赤字など)では false になります。 |
SizeAndSunshineStats
屋根または屋根の一部の大きさと日照量の分位数。
フィールド | |
---|---|
area_meters2 |
屋根または屋根セグメントの面積(m2)。これは、地面の占有面積ではなく、屋根の面積(傾斜を考慮)です。 |
sunshine_quantiles[] |
地域全体の点群日照量の分位。ここに N 個の値がある場合、これは(N-1)分位を表します。たとえば、値が 5 個ある場合、四分位(最小値、25%、50%、75%、最大値)になります。値は |
ground_area_meters2 |
屋根または屋根セグメントで覆われている地面の占有面積(m²)。 |
SolarPanel
SolarPanel は、単一の太陽光パネルの位置、向き、生産を記述します。パネルのパラメータについては、SolarPotential
の panel_height_meters
、panel_width_meters
、panel_capacity_watts
フィールドをご覧ください。
フィールド | |
---|---|
center |
パネルの中央。 |
orientation |
パネルの向き。 |
yearly_energy_dc_kwh |
このレイアウトが 1 年間に集める太陽光エネルギーの量(DC kWh)。 |
segment_index |
このパネルが配置されている屋根セグメントに対応する |
SolarPanelConfig
SolarPanelConfig は、屋根に設置する太陽光パネルの特定の配置を表します。
フィールド | |
---|---|
panels_count |
パネルの合計数。これは、 |
yearly_energy_dc_kwh |
上記のパネルを想定した場合、このレイアウトで年間に集める太陽光エネルギーの量(DC kWh)。 |
roof_segment_summaries[] |
このレイアウトで 1 つ以上のパネルを搭載している各屋根セグメントの製造に関する情報。 |
SolarPanelOrientation
太陽光発電パネルの向き。これは、パネルが設置されている屋根セグメントの方位を基準に解釈する必要があります。
列挙型 | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
パネルの向きが不明です。 |
LANDSCAPE |
LANDSCAPE パネルの長辺は、設置されている屋根セグメントの方位方向に垂直です。 |
PORTRAIT |
PORTRAIT パネルの長辺は、設置されている屋根セグメントの方位方向と平行です。 |
SolarPotential
建物の太陽光発電のポテンシャルに関する情報。このファイル内の多くのフィールドは「パネル」という単位で定義されています。フィールド panel_capacity_watts
、panel_height_meters
、panel_width_meters
には、これらの計算で使用されるパネルのモデルのパラメータを指定します。
フィールド | |
---|---|
max_array_panels_count |
最大アレイのサイズ(屋根に設置できるパネルの最大数)。 |
panel_capacity_watts |
計算に使用されるパネルの容量(ワット)。 |
panel_height_meters |
計算に使用されるパネルの高さ(縦向き、メートル単位)。 |
panel_width_meters |
計算に使用するパネルの幅(縦向き、メートル単位)。 |
panel_lifetime_years |
ソーラーパネルの想定寿命(年)。これは財務計算で使用されます。 |
max_array_area_meters2 |
最大アレイのサイズ(平方メートル単位)。 |
max_sunshine_hours_per_year |
屋根の任意の場所における年間の日照時間の最大数。日照時間は、年間に受ける日射量(エネルギー)の合計量を測定したものです。1 日照時間 = 1 kW あたり 1 kWh(kW は標準テスト条件での容量のキロワット数を指します)。 |
carbon_offset_factor_kg_per_mwh |
送電電力 1 MWh あたりに相当する CO2 排出量。これは、太陽光発電によって置き換えられた電力網の二酸化炭素排出原単位の測定値です。 |
whole_roof_stats |
屋根セグメントに割り当てられた屋根部分の合計サイズと日照量分位数。名前が「建物」と付いていますが、建物全体が対象とは限りません。 |
building_stats |
屋根の一部が屋根セグメントに割り当てられていない場合も含め、建物全体のサイズと日射量分位数。これらの部分の向きが明確に特定されていないため、屋根面積の推定値は信頼できませんが、敷地面積の推定値は信頼できます。建物全体の屋根面積をより正確に把握するには、 |
roof_segment_stats[] |
各屋根セグメントのサイズと日射量分位数。 |
solar_panels[] |
各 |
solar_panel_configs[] |
各 |
financial_analyses[] |
|