Package google.maps.solar.v1

インデックス

Solar

Solar API のサービス定義。

FindClosestBuildingInsights

rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights)

クエリポイントに最も近い重心を持つ建物を検索します。クエリポイントから約 50 m 以内に建物がない場合、コード NOT_FOUND のエラーが返されます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
GetDataLayers

rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers)

ある地点の位置周辺地域の太陽光発電に関する情報を取得します。位置情報がカバレッジエリア外にある場合は、コード NOT_FOUND のエラーを返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
GetGeoTiff

rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody)

ID で画像を返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

BuildingInsights

Solar.FindClosestBuildingInsights に対するレスポンス メッセージです。建物の位置、面積、太陽光発電のポテンシャルに関する情報。

フィールド
name

string

建物のリソース名(buildings/{place_id} 形式)。

center

LatLng

建物の中心付近のポイント。

bounding_box

LatLngBox

建物の境界ボックス。

imagery_date

Date

基盤となる画像が取得された日付。これはおおよその値です。

imagery_processed_date

Date

この画像の処理が完了した日時。

postal_code

string

郵便番号(例: 米国の郵便番号)を入力します。

administrative_area

string

この建物が含まれる行政区域 1(米国では州など)。たとえば、米国では「MA」または「CA」という略称が使用されます。

statistical_area

string

統計圏(例: 米国の国勢調査区)を入力します。

region_code

string

この建物が存在する国(または地域)の地域コード。

solar_potential

SolarPotential

建物の太陽光発電のポテンシャル。

imagery_quality

ImageryQuality

この建物のデータを計算するために使用された画像の品質。

CashPurchaseSavings

特定の電力使用量で特定の構成の太陽光パネルを直接購入する場合の費用とメリット。

フィールド
out_of_pocket_cost

Money

税制優遇措置前の初期費用: 自己負担で支払う金額。税制優遇措置後の upfront_cost とは対照的です。

upfront_cost

Money

税制優遇後の初期費用: 1 年目に支払う必要のある金額です。税制優遇措置が適用される前の out_of_pocket_cost とは対照的です。

rebate_value

Money

すべての税金還付の金額。

savings

SavingsOverTime

ライフタイム期間でどれだけ節約できるか(またはできないか)。

payback_years

float

投資回収までの年数。負の値は、ライフタイム期間内に収益が得られないことを示します。

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/ピクセルです。GetDataLayersRequestpixel_size_meters 値が指定されている場合、GeoTIFF ファイルの最小解像度はその値になります。

フィールド
imagery_date

Date

この地域のソース画像(他のすべてのデータが派生する画像)が撮影された日時。画像が複数日にわたって撮影されている可能性があるため、多少の誤差が生じる可能性があります。

imagery_processed_date

Date

この画像の処理が完了した日時。

dsm_url

string

地域の DSM(数値表層モデル)の画像の URL。値は EGM96 ジオイド(海面)からの高さ(メートル)です。無効な場所(データがない場所)は -9999 として保存されます。

rgb_url

string

対象地域の RGB データ(航空写真)の画像の URL。

mask_url

string

建物マスク画像の URL: ピクセルごとに 1 ビットで、そのピクセルが屋根の一部と見なされるかどうかを示します。

annual_flux_url

string

地域の年間フラックス マップ(屋根に当たる年間日光)の URL。値は kWh/kW/年です。これはマスクなしのフルクスです。フルクスは、建物の屋上だけでなく、すべての場所で計算されます。無効な場所は -9999 として保存されます。測定範囲外の場所は無効になります。また、測定範囲内でも、フリュークスを計算できなかった場所も無効になります。

monthly_flux_url

string

地域の月ごとのフルス マップ(屋根に当たる日光、月別)の URL。値は kWh/kW/年です。この URL が指す GeoTIFF には、1 月から 12 月に対応する 12 個のバンドが順番に含まれます。

hourly_shade_urls[]

string

1 月から 12 月までの 12 個の URL(1 時間ごとの日陰)。各 GeoTIFF には、1 日の 24 時間に対応する 24 個のバンドが含まれます。各ピクセルは 32 ビットの整数で、その月の(最大)31 日に対応しています。1 ビットは、対応する場所がその月のその日、その時間帯に太陽を見ることができることを意味します。無効な位置情報は -9999 として保存されます(負の値であるため、ビット 31 が設定されています。有効な値ではビット 31 を設定できません。これは、月末の 32 日目に相当するためです)。

例を挙げましょう。6 月 22 日午後 4 時に、ある点(ピクセル位置(x, y))に太陽が当たっていたかどうかを確認するには、次のようにします。

  1. このリストの 6 番目の URL(6 月に対応)を取得します。
  2. 17 番目のチャネル(午後 4 時に対応)を検索します。
  3. (x, y)の 32 ビット値を読み取ります。
  4. 値のビット 21(月 22 日に対応)を読み取ります。
  5. そのビットが 1 の場合、その場所は 6 月 22 日午後 4 時に太陽を観測しました。

より正式には、month(1 ~ 12)、day(1 ~最大月数、2 月は 28 日)、hour(0 ~ 23)が指定されている場合、(x, y) の位置にあるその月/日/時間の日陰/日光は、次のビットになります。

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

ここで、(x, y) は空間インデックス、[month - 1]month - 1 番目の URL の取得(ゼロからのインデックス登録)、[hour] はチャネルへのインデックス登録、最終的なゼロ以外の結果は「晴れ」を意味します。うるう年はなく、夏時間もありません(すべての日は 24 時間で、正午は常に「標準時」の正午です)。

imagery_quality

ImageryQuality

結果の画像の品質。

FinancedPurchaseSavings

特定の電力使用量で特定の構成の太陽光パネルを購入するためにローンを使用する場合の費用とメリット。

フィールド
annual_loan_payment

Money

ローンの年間支払い額。

rebate_value

Money

すべての税額控除の金額(連邦投資税額控除(ITC)を含む)。

loan_interest_rate

float

この一連の計算で想定されるローンの利率。

savings

SavingsOverTime

ライフタイム期間でどれだけ節約できるか(またはできないか)。

FinancialAnalysis

特定の電気料金の金額に最適な太陽光発電システムのレイアウトの費用とメリットを分析します。

フィールド
monthly_bill

Money

この分析で想定する毎月の電気代。

default_bill

bool

この請求書サイズが、この建物がある地域のデフォルトの請求書として選択されているかどうか。BuildingSolarPotentialFinancialAnalysisdefault_bill を設定する必要があります。

average_kwh_per_month

float

請求額と地域の電気料金に基づく、家で 1 か月あたりに使用される電力量。

financial_details

FinancialDetails

使用される融資方法に関係なく適用される財務情報。

leasing_savings

LeasingSavings

太陽光パネルのリースの費用とメリット。

cash_purchase_savings

CashPurchaseSavings

現金で太陽光パネルを購入する場合の費用とメリット。

financed_purchase_savings

FinancedPurchaseSavings

太陽光パネルの購入に融資を利用した場合の費用とメリット。

panel_config_index

int32

この請求額に最適なソーラー レイアウトの solar_panel_configs 内のインデックス。レイアウトがないことを表す -1 にすることもできます。この場合、残りのサブメッセージは省略されます。

FinancialDetails

財務分析の詳細。これらの詳細情報の一部は、すでに上位レベルに保存されています(自己負担額など)。合計金額は、SolarPotentialpanel_lifetime_years フィールドで定義された全期間のものです。注: パネルの購入にかかる自己負担額は、CashPurchaseSavingsout_of_pocket_cost フィールドに指定します。

フィールド
initial_ac_kwh_per_year

float

太陽光パネルが初年度に生成すると想定される AC kWh 数。

remaining_lifetime_utility_bill

Money

太陽光発電で発電されなかった電力の使用量に対する公共料金(パネルの寿命分)。

federal_incentive

Money

連邦政府の補助金から利用できる金額。これは、ユーザーがパネルを購入する場合(ローンありまたはローンなし)に適用されます。

state_incentive

Money

州の補助金から利用できる金額。これは、ユーザーがパネルを(ローンありまたはローンなしで)購入する場合に適用されます。

utility_incentive

Money

電力会社のインセンティブから利用できる金額。これは、ユーザーがパネルを(ローンありまたはローンなしで)購入する場合に適用されます。

lifetime_srec_total

Money

パネルの全期間にわたってユーザーが太陽光再生可能エネルギークレジットから受け取る金額。これは、ユーザーがパネルを購入した場合(ローンありまたはローンなし)に適用されます。

cost_of_electricity_without_solar

Money

太陽光発電システムを設置しなかった場合、ユーザーがライフタイム全体で支払う電気代合計。

net_metering_allowed

bool

ネット メータリングが許可されているかどうか。

solar_percentage

float

太陽光発電で供給される電力の割合(0 ~ 100)。最初の 1 年間は有効ですが、それ以降は概算です。

percentage_exported_to_grid

float

1 四半期の発電量に基づいて、グリッドに送電されたと想定される太陽光発電の割合(0 ~ 100)。これは、ネット メータリングが許可されていない場合に計算に影響します。

FindClosestBuildingInsightsRequest

Solar.FindClosestBuildingInsights のリクエスト メッセージです。

フィールド
location

LatLng

必須。API が既知の建物の中で最も近いものを検索する経度と緯度。

required_quality

ImageryQuality

省略可。結果で許可される最小品質レベル。この値より低い品質の結果は返されません。指定しなかった場合、品質が「高」の動画のみが検索対象になります。

GetDataLayersRequest

Solar.GetDataLayers のリクエスト メッセージです。

フィールド
location

LatLng

必須。データを取得する地域の中心の緯度と経度。

radius_meters

float

必須。中心点の周囲の領域を定義する半径(メートル単位)。この領域のデータが返されます。この値には次の制限があります。

  • 最大 100 m までの任意の値を指定できます。
  • radius_meters <= pixel_size_meters * 1000 であれば、100 m を超える値を指定できます。
  • ただし、値が 175 m を超える場合、リクエストの DataLayerView には月単位のフルークスや 1 時間あたりのシェードを含めることはできません。
view

DataLayerView

省略可。返されるデータのサブセット。

required_quality

ImageryQuality

省略可。結果で許可される最小品質レベル。この値より低い品質の結果は返されません。指定しなかった場合、品質が「高」の動画のみが検索対象になります。

pixel_size_meters

float

省略可。返されるデータの最小スケール(ピクセルあたりのメートル単位)。サポートされている値は、0.1(このフィールドが明示的に設定されていない場合のデフォルト)、0.25、0.5、1.0 です。通常の解像度が pixel_size_meters 未満の画像コンポーネントは、pixel_size_meters で指定された解像度で返されます。通常の解像度が pixel_size_meters 以上の画像コンポーネントは、その通常の解像度で返されます。

exact_quality_required

bool

省略可。画像の品質を厳密に指定するかどうか。false に設定すると、required_quality フィールドは必要な最小品質として解釈されます。たとえば、required_quality が MEDIUM に設定されている場合、高品質の画像が返されることがあります。true に設定すると、required_quality は正確に必要な品質として解釈され、required_qualityMEDIUM に設定されている場合は MEDIUM 品質の画像のみが返されます。

GetGeoTiffRequest

Solar.GetGeoTiff のリクエスト メッセージです。

フィールド
id

string

必須。リクエストされたアセットの 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

緯度/経度座標の境界ボックス。

フィールド
sw

LatLng

箱の南西の角。

ne

LatLng

ボックスの北東の角。

LeasingSavings

特定の電力使用量で特定の構成の太陽光パネルをリースする場合の費用とメリット。

フィールド
leases_allowed

bool

この地域で賃貸が許可されているかどうか(一部の州では賃貸が許可されていません)。このフィールドが false の場合、このメッセージの値は無視される可能性があります。

leases_supported

bool

この地域で、財務計算エンジンがリースをサポートしているかどうか。このフィールドが false の場合、このメッセージの値は無視される可能性があります。これは leases_allowed とは無関係です。一部の地域ではリースが許可されていますが、財務モデルで処理されない条件下で許可されています。

annual_leasing_cost

Money

年間の賃貸費用の見積もり。

savings

SavingsOverTime

ライフタイム期間でどれだけ節約できるか(またはできないか)。

RoofSegmentSizeAndSunshineStats

屋根セグメントのサイズと日照量分位数に関する情報。

フィールド
stats

SizeAndSunshineStats

屋根セグメントの合計サイズと日射量分位数。

center

LatLng

屋根セグメントの中心付近の点。

bounding_box

LatLngBox

屋根セグメントの境界ボックス。

pitch_degrees

float

理論上の地面に対して屋根セグメントの角度。0 = 地面と平行、90 = 地面に対して垂直。

azimuth_degrees

float

屋根セグメントが向いているコンパス方位。0 = 北、90 = 東、180 = 南。「フラット」な屋根セグメント(pitch_degrees が 0 に非常に近い)の場合、方位は明確に定義されていないため、整合性を確保するために、任意で 0(北)と定義します。

plane_height_at_center_meters

float

center で指定されたポイントにおける屋根セグメント面の高さ(海抜、メートル)。ピッチ、方位、中心位置とともに、屋根セグメントの面が完全に定義されます。

RoofSegmentSummary

建物の屋根セグメントに関する情報(パネルが設置されている)。

フィールド
panels_count

int32

このセグメントのパネルの合計数。

yearly_energy_dc_kwh

float

上記のパネルを前提として、このレイアウトのこの部分が 1 年間に集める太陽光エネルギーの量(DC kWh)。

pitch_degrees

float

理論上の地面に対して屋根セグメントの角度。0 = 地面と平行、90 = 地面に対して垂直。

azimuth_degrees

float

屋根セグメントが向いているコンパス方位。0 = 北、90 = 東、180 = 南。「フラット」な屋根セグメント(pitch_degrees が 0 に非常に近い)の場合、方位は明確に定義されていないため、整合性を確保するために、任意で 0(北)と定義します。

segment_index

int32

対応する RoofSegmentSizeAndSunshineStatsroof_segment_stats のインデックス。

SavingsOverTime

さまざまな支払い方法間で共有される財務情報。

フィールド
savings_year1

Money

パネル設置後の最初の 1 年間の節電額。

savings_year20

Money

パネル設置後 20 年間の節約額。

present_value_of_savings_year20

Money

想定された割引率を使用して、20 年間の累積貯蓄の現在価値はいくらですか。

savings_lifetime

Money

パネルの全期間における節約額。

present_value_of_savings_lifetime

Money

想定された割引率を使用して、生涯の累積節約額の現在価値はいくらですか。

financially_viable

bool

このシナリオが経済的に実行可能かどうかを示します。経済的な実行可能性が低いシナリオ(赤字など)では false になります。

SizeAndSunshineStats

屋根または屋根の一部の大きさと日照量の分位数。

フィールド
area_meters2

float

屋根または屋根セグメントの面積(m2)。これは、地面の占有面積ではなく、屋根の面積(傾斜を考慮)です。

sunshine_quantiles[]

float

地域全体の点群日照量の分位。ここに N 個の値がある場合、これは(N-1)分位を表します。たとえば、値が 5 個ある場合、四分位(最小値、25%、50%、75%、最大値)になります。値は max_sunshine_hours_per_year のように年間の kWh/kW 単位です。

ground_area_meters2

float

屋根または屋根セグメントで覆われている地面の占有面積(m²)。

SolarPanel

SolarPanel は、単一の太陽光パネルの位置、向き、生産を記述します。パネルのパラメータについては、SolarPotentialpanel_height_meterspanel_width_meterspanel_capacity_watts フィールドをご覧ください。

フィールド
center

LatLng

パネルの中央。

orientation

SolarPanelOrientation

パネルの向き。

yearly_energy_dc_kwh

float

このレイアウトが 1 年間に集める太陽光エネルギーの量(DC kWh)。

segment_index

int32

このパネルが配置されている屋根セグメントに対応する RoofSegmentSizeAndSunshineStatsroof_segment_stats のインデックス。

SolarPanelConfig

SolarPanelConfig は、屋根に設置する太陽光パネルの特定の配置を表します。

フィールド
panels_count

int32

パネルの合計数。これは、roof_segment_summaries 内の対応するフィールドの(合計)と重複することに注意してください。

yearly_energy_dc_kwh

float

上記のパネルを想定した場合、このレイアウトで年間に集める太陽光エネルギーの量(DC kWh)。

roof_segment_summaries[]

RoofSegmentSummary

このレイアウトで 1 つ以上のパネルを搭載している各屋根セグメントの製造に関する情報。roof_segment_summaries[i] は、サイズ、予想される生産量、向きなど、i 番目の屋根セグメントを表します。

SolarPanelOrientation

太陽光発電パネルの向き。これは、パネルが設置されている屋根セグメントの方位を基準に解釈する必要があります。

列挙型
SOLAR_PANEL_ORIENTATION_UNSPECIFIED パネルの向きが不明です。
LANDSCAPE LANDSCAPE パネルの長辺は、設置されている屋根セグメントの方位方向に垂直です。
PORTRAIT PORTRAIT パネルの長辺は、設置されている屋根セグメントの方位方向と平行です。

SolarPotential

建物の太陽光発電のポテンシャルに関する情報。このファイル内の多くのフィールドは「パネル」という単位で定義されています。フィールド panel_capacity_wattspanel_height_meterspanel_width_meters には、これらの計算で使用されるパネルのモデルのパラメータを指定します。

フィールド
max_array_panels_count

int32

最大アレイのサイズ(屋根に設置できるパネルの最大数)。

panel_capacity_watts

float

計算に使用されるパネルの容量(ワット)。

panel_height_meters

float

計算に使用されるパネルの高さ(縦向き、メートル単位)。

panel_width_meters

float

計算に使用するパネルの幅(縦向き、メートル単位)。

panel_lifetime_years

int32

ソーラーパネルの想定寿命(年)。これは財務計算で使用されます。

max_array_area_meters2

float

最大アレイのサイズ(平方メートル単位)。

max_sunshine_hours_per_year

float

屋根の任意の場所における年間の日照時間の最大数。日照時間は、年間に受ける日射量(エネルギー)の合計量を測定したものです。1 日照時間 = 1 kW あたり 1 kWh(kW は標準テスト条件での容量のキロワット数を指します)。

carbon_offset_factor_kg_per_mwh

float

送電電力 1 MWh あたりに相当する CO2 排出量。これは、太陽光発電によって置き換えられた電力網の二酸化炭素排出原単位の測定値です。

whole_roof_stats

SizeAndSunshineStats

屋根セグメントに割り当てられた屋根部分の合計サイズと日照量分位数。名前が「建物」と付いていますが、建物全体が対象とは限りません。building_stats をご覧ください。

building_stats

SizeAndSunshineStats

屋根の一部が屋根セグメントに割り当てられていない場合も含め、建物全体のサイズと日射量分位数。これらの部分の向きが明確に特定されていないため、屋根面積の推定値は信頼できませんが、敷地面積の推定値は信頼できます。建物全体の屋根面積をより正確に把握するには、whole_roof_stats の屋根面積を、building_statswhole_roof_stats の敷地面積の比率でスケーリングします。

roof_segment_stats[]

RoofSegmentSizeAndSunshineStats

各屋根セグメントのサイズと日射量分位数。

solar_panels[]

SolarPanel

SolarPanel は 1 つのソーラーパネルを表します。パネル レイアウト アルゴリズムが配置した順序で表示されます。通常は、年間のエネルギー生産量の降順に並べられますが、必ずしもそうとは限りません。

solar_panel_configs[]

SolarPanelConfig

SolarPanelConfig は、屋根に設置する太陽光発電パネルの異なる配置を表します。パネル数の順に並んでいます。panels_count=N の SolarPanelConfig は、solar_panels リストの最初の N 個のパネルに基づいています。このフィールドは、屋根に 4 枚以上のパネルを設置できる場合にのみ入力されます。

financial_analyses[]

FinancialAnalysis

FinancialAnalysis は、特定の月額請求額と特定の電力会社を前提として、太陽光発電に切り替えた場合の節約額を示します。月額請求額の増加順に表示されます。Solar API に財務計算を行うのに十分な情報がない場合、このフィールドは空になります。