- HTTP リクエスト
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- 金額
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- 試してみる
クエリ ポイントに最も近い建物を探します。クエリ ポイントから約 50 m 以内に建物がない場合、コード NOT_FOUND
のエラーを返します。
HTTP リクエスト
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
location |
必須。API が最も近い既知の建物を検索する場所の経度と緯度。 |
requiredQuality |
省略可。結果で許容される最小品質レベル。これより品質の低い結果は返されません。これを指定しないと、高品質のみに制限することと同じになります。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
Solar.FindClosestBuildingInsights
に対するレスポンス メッセージです。建物の位置、面積、太陽光発電のポテンシャルに関する情報。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "name": string, "center": { object ( |
フィールド | |
---|---|
name |
建物のリソース名( |
center |
建物の中心付近の地点。 |
boundingBox |
建物の境界ボックス。 |
imageryDate |
基盤となる画像が取得された日付。これは概算値です。 |
imageryProcessedDate |
この画像の処理が完了した日時。 |
postalCode |
郵便番号(例:米国の郵便番号など)。 |
administrativeArea |
この建物を含む行政区域 1(例: 米国の州)。(例: 米国では「MA」や「CA」)。 |
statisticalArea |
統計領域(例:(米国国勢調査地域)に基づいてこの建物が配置されている。 |
regionCode |
この建物がある国(または地域)の地域コード。 |
solarPotential |
建物の太陽光発電のポテンシャル。 |
imageryQuality |
この建物のデータを計算するために使用される画像の品質。 |
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
LatLngBox
緯度/経度座標の境界ボックス。
JSON 表現 |
---|
{ "sw": { object ( |
フィールド | |
---|---|
sw |
箱の南西の角。 |
ne |
箱の北東の角。 |
SolarPotential
建物の太陽光発電のポテンシャルに関する情報。このパネルの多くのフィールドは、「パネル」の観点から定義されています。panelCapacityWatts
、panelHeightMeters
、panelWidthMeters
の各フィールドには、これらの計算で使用されるパネルのモデルのパラメータを記述します。
JSON 表現 |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
フィールド | |
---|---|
maxArrayPanelsCount |
最大配列のサイズ、つまり屋根に収まるパネルの最大数。 |
panelCapacityWatts |
計算に使用するパネルの容量(ワット単位)。 |
panelHeightMeters |
計算で使用するパネルの高さ(縦向き)。メートル単位で表します。 |
panelWidthMeters |
計算で使用されるパネルの幅(縦向き)。 |
panelLifetimeYears |
ソーラーパネルの予想耐用年数(年単位)。これは財務計算に使用されます。 |
maxArrayAreaMeters2 |
最大配列のサイズ(平方メートル単位)。 |
maxSunshineHoursPerYear |
屋根の任意の地点における 1 年間の最大日照時間。日照時間は、1 年間に受けた日射量(エネルギー)の合計量を表します。1 日照時間 = 1 kWh あたり 1 kWh(ここで、kW は標準試験条件下での容量の kW を指します)。 |
carbonOffsetFactorKgPerMwh |
電力網電力 1 MWh あたりの CO2 排出量換算量。これは、電力網の電力を太陽光発電で置き換えた二酸化炭素排出原単位を測定したものです。 |
wholeRoofStats |
屋根セグメントに割り当てられた屋根の部分の合計サイズと日射量分位数。名前に反して、建物全体を収めているとは限りません。 |
buildingStats |
一部の屋根セグメントに割り当てられていない屋根の部分を含む、建物全体のサイズと日照量の分位数。これらの部品の向きは正確に把握されていないため、屋根面積の推定値は信頼性に欠けますが、地面積の推定は信頼性があります。 |
roofSegmentStats[] |
各屋根セグメントのサイズと日照量の分位数。 |
solarPanels[] |
各 |
solarPanelConfigs[] |
各 |
financialAnalyses[] |
|
SizeAndSunshineStats
屋根または屋根の一部のサイズと日当たりの分位数。
JSON 表現 |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
フィールド | |
---|---|
areaMeters2 |
屋根または屋根セグメントの面積(m^2 単位)。これは、地面のフットプリントの領域ではなく、屋根の領域(傾斜を考慮したもの)です。 |
sunshineQuantiles[] |
地域全体の点ごとの日当たりの分位。値が N 個ある場合、これは (N-1) 個分を表します。たとえば、値が 5 つある場合は、四分位(最小、25%、50%、75%、最大)になります。値は年間の kWh/kW で表します(例: |
groundAreaMeters2 |
屋根または屋根セグメントで覆われている敷地面積(m^2 単位)。 |
RoofSegmentSizeAndSunshineStats
屋根セグメントのサイズと日当たりの分位数に関する情報。
JSON 表現 |
---|
{ "stats": { object ( |
フィールド | |
---|---|
stats |
屋根セグメントの合計サイズと日照量分位数。 |
center |
屋根セグメントの中心付近のポイント。 |
boundingBox |
屋根セグメントの境界ボックス。 |
pitchDegrees |
理論上の地面に対する屋根セグメントの角度。0 = 地面と平行、90 = 地面と垂直 |
azimuthDegrees |
屋根セグメントが指しているコンパスの方向。0 = 北、90 = 東、180 = 南です。「平坦」な屋根セグメント( |
planeHeightAtCenterMeters |
|
SolarPanel
SolarPanel は、1 つのソーラーパネルの位置、向き、生産量を表します。パネルのパラメータについては、SolarPotential
の panelHeightMeters
、panelWidthMeters
、panelCapacityWatts
フィールドをご覧ください。
JSON 表現 |
---|
{ "center": { object ( |
フィールド | |
---|---|
center |
パネルの中央。 |
orientation |
パネルの向き。 |
yearlyEnergyDcKwh |
このレイアウトが 1 年間に取り込む太陽光エネルギーの量(DC kWh 単位)。 |
segmentIndex |
このパネルが配置されている屋根セグメントに対応する |
SolarPanelOrientation
ソーラーパネルの向き。これは、パネルが配置されている屋根セグメントの方位を基準として解釈する必要があります。
列挙型 | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
パネルの向きは不明です。 |
LANDSCAPE |
LANDSCAPE パネルの長辺は、配置先の屋根セグメントの方位角と直角になります。 |
PORTRAIT |
PORTRAIT パネルの長辺は、配置先の屋根セグメントの方位方向と平行です。 |
SolarPanelConfig
SolarPanelConfig は、屋根上の太陽光パネルの特定の配置を表します。
JSON 表現 |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
フィールド | |
---|---|
panelsCount |
パネルの合計数。これは、 |
yearlyEnergyDcKwh |
上記のパネルを前提とした場合、このレイアウトで 1 年間に取り込む太陽光エネルギーの量(DC kWh 単位)。 |
roofSegmentSummaries[] |
このレイアウトで 1 つ以上のパネルを取り付けている各屋根セグメントの生産に関する情報。 |
RoofSegmentSummary
複数のパネルが配置された、建物の屋根セグメントに関する情報。
JSON 表現 |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
フィールド | |
---|---|
panelsCount |
このセグメントのパネルの合計数。 |
yearlyEnergyDcKwh |
上記のパネルを前提とした場合、レイアウトのこの部分が 1 年間に取り込む太陽光エネルギーの量(DC kWh 単位)。 |
pitchDegrees |
理論上の地面に対する屋根セグメントの角度。0 = 地面と平行、90 = 地面と垂直 |
azimuthDegrees |
屋根セグメントが指しているコンパスの方向。0 = 北、90 = 東、180 = 南です。「平坦」な屋根セグメント( |
segmentIndex |
対応する |
FinancialAnalysis
特定の電気料金の請求書の大きさに応じた最適な太陽光発電レイアウトのコストとメリットの分析。
JSON 表現 |
---|
{ "monthlyBill": { object ( |
フィールド | |
---|---|
monthlyBill |
この分析で想定されている毎月の電気代です。 |
defaultBill |
この建物がある地域のデフォルトの請求として選択した請求サイズかどうか。 |
averageKwhPerMonth |
1 か月の平均的な家庭の電力使用量(請求書の大きさと地域の電気料金に基づく)。 |
financialDetails |
使用するローン方法に関係なく適用される財務情報。 |
leasingSavings |
太陽光発電パネルをリースする費用とメリット。 |
cashPurchaseSavings |
太陽光パネルを現金で購入する費用とメリット。 |
financedPurchaseSavings |
ソーラーパネルを購入する際のコストとメリット。 |
panelConfigIndex |
この請求金額の最適な太陽光発電レイアウトの |
お金
金額をその通貨タイプで表します。
JSON 表現 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
フィールド | |
---|---|
currencyCode |
ISO 4217 で定義されている 3 文字の通貨コード。 |
units |
金額の単位。たとえば、 |
nanos |
金額のナノ(10^-9)単位の数。値は -999,999,999~+999,999,999 の範囲(両端を含む)で指定する必要があります。 |
FinancialDetails
財務分析の詳細。これらの詳細情報の一部は、すでに上位レベルで保存されています(自己負担額など)。合計金額は、SolarPotential
の panelLifetimeYears
フィールドで定義された全期間における金額です。注: パネル購入の自己負担額は、CashPurchaseSavings
の outOfPocketCost
フィールドで示されます。
JSON 表現 |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
フィールド | |
---|---|
initialAcKwhPerYear |
太陽光発電が初年度に発電されると Google が考える AC kWh の数。 |
remainingLifetimeUtilityBill |
太陽光発電以外の電気料金で、パネルの耐用年数に対する公共料金の請求書です。 |
federalIncentive |
連邦インセンティブから利用できる金額。これは、ユーザーが(ローンの有無にかかわらず)パネルを購入する場合に適用されます。 |
stateIncentive |
州のインセンティブから利用できる金額。これは、ユーザーが(ローンの有無にかかわらず)パネルを購入する場合に適用されます。 |
utilityIncentive |
公共料金のインセンティブから得られる金額。これは、ユーザーが(ローンの有無にかかわらず)パネルを購入する場合に適用されます。 |
lifetimeSrecTotal |
太陽光発電の再生可能エネルギー クレジットからユーザーがパネルの耐用期間を通じて受け取る金額。これは、ユーザーが(ローンの有無にかかわらず)パネルを購入する場合に適用されます。 |
costOfElectricityWithoutSolar |
太陽光発電を設置しなかった場合にユーザーが全期間に支払ったであろう電力の総額。 |
netMeteringAllowed |
ネットメータリングが許可されているかどうか。 |
solarPercentage |
太陽光発電で供給されるユーザーの電力の割合(0 ~ 100)。初年度のみ有効ですが、その後の数年間もほぼ有効です。 |
percentageExportedToGrid |
太陽光発電の第 1 四半期を基準として、太陽光発電として想定した発電量の割合(0 ~ 100)を電力網にエクスポートしました。これは、正味メータリングが許可されていない場合の計算に影響します。 |
LeasingSavings
特定の電力使用量を持つ特定の構成の太陽光発電パネルをリースすることのコストとメリット。
JSON 表現 |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
フィールド | |
---|---|
leasesAllowed |
この法律でリースが許可されるかどうか(州によってはリースが許可されない)。このフィールドが false の場合、このメッセージの値はおそらく無視されます。 |
leasesSupported |
リースが財務計算エンジンによってこの項目でサポートされているかどうか。このフィールドが false の場合、このメッセージの値はおそらく無視されます。これは |
annualLeasingCost |
年間リース費用の見積もり額。 |
savings |
全期間で節約される金額(または節約されない金額)です。 |
SavingsOverTime
異なるローン方法間で共有される財務情報。
JSON 表現 |
---|
{ "savingsYear1": { object ( |
フィールド | |
---|---|
savingsYear1 |
パネル設置後 1 年でコストを削減。 |
savingsYear20 |
パネル設置後 20 年間でコストを節約。 |
presentValueOfSavingsYear20 |
想定した割引率を使用した場合、20 年間の累積削減額の現在価値はいくらですか。 |
savingsLifetime |
パネルのライフタイム全体の節約。 |
presentValueOfSavingsLifetime |
仮定した割引率を使用した場合、累積のライフタイム節約の現在価値はいくらですか。 |
financiallyViable |
このシナリオが経済的に実現可能かどうかを示します。経済的な実現可能性が低いシナリオ(資金の損失など)では false になります。 |
CashPurchaseSavings
特定の電力使用量がある特定の構成の太陽光発電パネルを購入する場合の費用とメリット。
JSON 表現 |
---|
{ "outOfPocketCost": { object ( |
フィールド | |
---|---|
outOfPocketCost |
税制優遇措置前の初期費用: 自己負担額。 |
upfrontCost |
税制優遇措置適用後の初期費用: 初年度に支払う必要がある金額です。 |
rebateValue |
すべての税金還付の金額。 |
savings |
全期間で節約される金額(または節約されない金額)です。 |
paybackYears |
投資回収までの年数。負の値は、ライフタイム期間内に投資が返済されないことを意味します。 |
FinancedPurchaseSavings
ローンを利用して、特定の電力使用量の太陽光発電パネルの特定の構成を購入した場合のコストとメリット。
JSON 表現 |
---|
{ "annualLoanPayment": { object ( |
フィールド | |
---|---|
annualLoanPayment |
年単位のローン返済。 |
rebateValue |
すべての税金の還付額(連邦投資税額控除(ITC)を含む)。 |
loanInterestRate |
この計算セットで想定されるローンの金利。 |
savings |
全期間で節約される金額(または節約されない金額)です。 |