Method: buildingInsights.findClosest

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

HTTP リクエスト

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
location

object (LatLng)

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

enum (ImageryQuality)

省略可。結果で許容される最小品質レベル。これより品質の低い結果は返されません。これを指定しないと、高品質のみに制限することと同じになります。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

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

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
フィールド
name

string

建物のリソース名（building/<place ID> 形式）。
center

object (LatLng)

建物の中心付近の地点。
boundingBox

object (LatLngBox)

建物の境界ボックス。
imageryDate

object (Date)

基盤となる画像が取得された日付。これは概算値です。
imageryProcessedDate

object (Date)

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

string

郵便番号（例:米国の郵便番号など）。
administrativeArea

string

この建物を含む行政区域 1（例: 米国の州）。（例: 米国では「MA」や「CA」）。
statisticalArea

string

統計領域（例:（米国国勢調査地域）に基づいてこの建物が配置されている。
regionCode

string

この建物がある国（または地域）の地域コード。
solarPotential

object (SolarPotential)

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

enum (ImageryQuality)

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

承認スコープ

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

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

LatLngBox

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

JSON 表現 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
フィールド
sw

object (LatLng)

箱の南西の角。
ne

object (LatLng)

箱の北東の角。

SolarPotential

建物の太陽光発電のポテンシャルに関する情報。このパネルの多くのフィールドは、「パネル」の観点から定義されています。panelCapacityWatts、panelHeightMeters、panelWidthMeters の各フィールドには、これらの計算で使用されるパネルのモデルのパラメータを記述します。

JSON 表現 
{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
フィールド
maxArrayPanelsCount

integer

最大配列のサイズ、つまり屋根に収まるパネルの最大数。
panelCapacityWatts

number

計算に使用するパネルの容量（ワット単位）。
panelHeightMeters

number

計算で使用するパネルの高さ（縦向き）。メートル単位で表します。
panelWidthMeters

number

計算で使用されるパネルの幅（縦向き）。
panelLifetimeYears

integer

ソーラーパネルの予想耐用年数（年単位）。これは財務計算に使用されます。
maxArrayAreaMeters2

number

最大配列のサイズ（平方メートル単位）。
maxSunshineHoursPerYear

number

屋根の任意の地点における 1 年間の最大日照時間。日照時間は、1 年間に受けた日射量（エネルギー）の合計量を表します。1 日照時間 = 1 kWh あたり 1 kWh（ここで、kW は標準試験条件下での容量の kW を指します）。
carbonOffsetFactorKgPerMwh

number

電力網電力 1 MWh あたりの CO2 排出量換算量。これは、電力網の電力を太陽光発電で置き換えた二酸化炭素排出原単位を測定したものです。
wholeRoofStats

object (SizeAndSunshineStats)

屋根セグメントに割り当てられた屋根の部分の合計サイズと日射量分位数。名前に反して、建物全体を収めているとは限りません。buildingStatsをご確認ください。
buildingStats

object (SizeAndSunshineStats)

一部の屋根セグメントに割り当てられていない屋根の部分を含む、建物全体のサイズと日照量の分位数。これらの部品の向きは正確に把握されていないため、屋根面積の推定値は信頼性に欠けますが、地面積の推定は信頼性があります。wholeRoofStats から屋根面積を buildingStats と wholeRoofStats の地面積の比率でスケーリングすることで、より信頼性の高い建物全体の屋根面積が得られる可能性があります。
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

各屋根セグメントのサイズと日照量の分位数。
solarPanels[]

object (SolarPanel)

各 SolarPanel は 1 つのソーラーパネルを表します。これらは、パネル レイアウト アルゴリズムが配置した順に表示されます。これは常にではありませんが、通常は年間エネルギー生産の高い順に行われます。
solarPanelConfigs[]

object (SolarPanelConfig)

各 SolarPanelConfig は、屋根上の太陽光発電パネルのさまざまな配置を示します。パネルは数が多い順に表示されます。panelsCount=N である SolarPanelConfig は、solarPanels リストの最初の N 個のパネルに基づきます。このフィールドは、屋根に 4 つ以上のパネルが取り付けられる場合にのみ入力されます。
financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis は、特定の月額料金と特定の電力会社を前提として、太陽光発電に移行することで節約できる金額です。これらは、毎月の請求額が大きい順に表示されています。Solar API が財務計算を実行するのに十分な情報を持たないエリアの建物の場合、このフィールドは空になります。

SizeAndSunshineStats

屋根または屋根の一部のサイズと日当たりの分位数。

JSON 表現 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
フィールド
areaMeters2

number

屋根または屋根セグメントの面積（m^2 単位）。これは、地面のフットプリントの領域ではなく、屋根の領域（傾斜を考慮したもの）です。
sunshineQuantiles[]

number

地域全体の点ごとの日当たりの分位。値が N 個ある場合、これは (N-1) 個分を表します。たとえば、値が 5 つある場合は、四分位（最小、25%、50%、75%、最大）になります。値は年間の kWh/kW で表します（例: maxSunshineHoursPerYear）。
groundAreaMeters2

number

屋根または屋根セグメントで覆われている敷地面積（m^2 単位）。

RoofSegmentSizeAndSunshineStats

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

JSON 表現 
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
フィールド
stats

object (SizeAndSunshineStats)

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

object (LatLng)

屋根セグメントの中心付近のポイント。
boundingBox

object (LatLngBox)

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

number

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

number

屋根セグメントが指しているコンパスの方向。0 = 北、90 = 東、180 = 南です。「平坦」な屋根セグメント（pitchDegrees が 0 に非常に近い）の場合、方位角は明確に定義されていないため、一貫性を保つために任意で 0（北）と定義します。
planeHeightAtCenterMeters

number

center で指定された地点における屋根セグメントの平面の高さ（海抜メートル）。ピッチ、方位角、中心位置とともに、屋根セグメントの平面を完全に定義します。

SolarPanel

SolarPanel は、1 つのソーラーパネルの位置、向き、生産量を表します。パネルのパラメータについては、SolarPotential の panelHeightMeters、panelWidthMeters、panelCapacityWatts フィールドをご覧ください。

JSON 表現 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
フィールド
center

object (LatLng)

パネルの中央。
orientation

enum (SolarPanelOrientation)

パネルの向き。
yearlyEnergyDcKwh

number

このレイアウトが 1 年間に取り込む太陽光エネルギーの量（DC kWh 単位）。
segmentIndex

integer

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

SolarPanelOrientation

ソーラーパネルの向き。これは、パネルが配置されている屋根セグメントの方位を基準として解釈する必要があります。

列挙型
SOLAR_PANEL_ORIENTATION_UNSPECIFIED パネルの向きは不明です。
LANDSCAPE LANDSCAPE パネルの長辺は、配置先の屋根セグメントの方位角と直角になります。
PORTRAIT PORTRAIT パネルの長辺は、配置先の屋根セグメントの方位方向と平行です。

SolarPanelConfig

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

JSON 表現 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
フィールド
panelsCount

integer

パネルの合計数。これは、roofSegmentSummaries の対応するフィールド（合計）と同じく冗長であるので注意してください。
yearlyEnergyDcKwh

number

上記のパネルを前提とした場合、このレイアウトで 1 年間に取り込む太陽光エネルギーの量（DC kWh 単位）。
roofSegmentSummaries[]

object (RoofSegmentSummary)

このレイアウトで 1 つ以上のパネルを取り付けている各屋根セグメントの生産に関する情報。roofSegmentSummaries[i] は、i 番目の屋根セグメントについて、サイズ、予想される生成物、向きなどを記述します。

RoofSegmentSummary

複数のパネルが配置された、建物の屋根セグメントに関する情報。

JSON 表現 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
フィールド
panelsCount

integer

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

number

上記のパネルを前提とした場合、レイアウトのこの部分が 1 年間に取り込む太陽光エネルギーの量（DC kWh 単位）。
pitchDegrees

number

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

number

屋根セグメントが指しているコンパスの方向。0 = 北、90 = 東、180 = 南です。「平坦」な屋根セグメント（pitchDegrees が 0 に非常に近い）の場合、方位角は明確に定義されていないため、一貫性を保つために任意で 0（北）と定義します。
segmentIndex

integer

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

FinancialAnalysis

特定の電気料金の請求書の大きさに応じた最適な太陽光発電レイアウトのコストとメリットの分析。

JSON 表現 
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
フィールド
monthlyBill

object (Money)

この分析で想定されている毎月の電気代です。
defaultBill

boolean

この建物がある地域のデフォルトの請求として選択した請求サイズかどうか。BuildingSolarPotential 内の 1 つの FinancialAnalysis にのみ defaultBill を設定する必要があります。
averageKwhPerMonth

number

1 か月の平均的な家庭の電力使用量（請求書の大きさと地域の電気料金に基づく）。
financialDetails

object (FinancialDetails)

使用するローン方法に関係なく適用される財務情報。
leasingSavings

object (LeasingSavings)

太陽光発電パネルをリースする費用とメリット。
cashPurchaseSavings

object (CashPurchaseSavings)

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

object (FinancedPurchaseSavings)

ソーラーパネルを購入する際のコストとメリット。
panelConfigIndex

integer

この請求金額の最適な太陽光発電レイアウトの solarPanelConfigs のインデックス。-1 の場合は、レイアウトがないことを示します。この場合、残りのサブメッセージは表示されません。

お金

金額をその通貨タイプで表します。

JSON 表現 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
フィールド
currencyCode

string

ISO 4217 で定義されている 3 文字の通貨コード。
units

string (int64 format)

金額の単位。たとえば、currencyCode が "USD" の場合、1 単位は 1 米ドルです。
nanos

integer

金額のナノ（10^-9）単位の数。値は -999,999,999～+999,999,999 の範囲（両端を含む）で指定する必要があります。units が正の場合、nanos は正または 0 でなければなりません。units がゼロの場合、nanos は正、ゼロ、負の値のいずれかになります。units が負の場合、nanos は負または 0 でなければなりません。たとえば、$-1.75 は units=-1、nanos=-750,000,000 と表されます。

FinancialDetails

財務分析の詳細。これらの詳細情報の一部は、すでに上位レベルで保存されています（自己負担額など）。合計金額は、SolarPotential の panelLifetimeYears フィールドで定義された全期間における金額です。注: パネル購入の自己負担額は、CashPurchaseSavings の outOfPocketCost フィールドで示されます。

JSON 表現 
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
フィールド
initialAcKwhPerYear

number

太陽光発電が初年度に発電されると Google が考える AC kWh の数。
remainingLifetimeUtilityBill

object (Money)

太陽光発電以外の電気料金で、パネルの耐用年数に対する公共料金の請求書です。
federalIncentive

object (Money)

連邦インセンティブから利用できる金額。これは、ユーザーが（ローンの有無にかかわらず）パネルを購入する場合に適用されます。
stateIncentive

object (Money)

州のインセンティブから利用できる金額。これは、ユーザーが（ローンの有無にかかわらず）パネルを購入する場合に適用されます。
utilityIncentive

object (Money)

公共料金のインセンティブから得られる金額。これは、ユーザーが（ローンの有無にかかわらず）パネルを購入する場合に適用されます。
lifetimeSrecTotal

object (Money)

太陽光発電の再生可能エネルギー クレジットからユーザーがパネルの耐用期間を通じて受け取る金額。これは、ユーザーが（ローンの有無にかかわらず）パネルを購入する場合に適用されます。
costOfElectricityWithoutSolar

object (Money)

太陽光発電を設置しなかった場合にユーザーが全期間に支払ったであろう電力の総額。
netMeteringAllowed

boolean

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

number

太陽光発電で供給されるユーザーの電力の割合（0 ～ 100）。初年度のみ有効ですが、その後の数年間もほぼ有効です。
percentageExportedToGrid

number

太陽光発電の第 1 四半期を基準として、太陽光発電として想定した発電量の割合（0 ～ 100）を電力網にエクスポートしました。これは、正味メータリングが許可されていない場合の計算に影響します。

LeasingSavings

特定の電力使用量を持つ特定の構成の太陽光発電パネルをリースすることのコストとメリット。

JSON 表現 
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
フィールド
leasesAllowed

boolean

この法律でリースが許可されるかどうか（州によってはリースが許可されない）。このフィールドが false の場合、このメッセージの値はおそらく無視されます。
leasesSupported

boolean

リースが財務計算エンジンによってこの項目でサポートされているかどうか。このフィールドが false の場合、このメッセージの値はおそらく無視されます。これは leasesAllowed とは無関係です。地域によってはリースが許可されますが、その条件は財務モデルによって処理されません。
annualLeasingCost

object (Money)

年間リース費用の見積もり額。
savings

object (SavingsOverTime)

全期間で節約される金額（または節約されない金額）です。

SavingsOverTime

異なるローン方法間で共有される財務情報。

JSON 表現 
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
フィールド
savingsYear1

object (Money)

パネル設置後 1 年でコストを削減。
savingsYear20

object (Money)

パネル設置後 20 年間でコストを節約。
presentValueOfSavingsYear20

object (Money)

想定した割引率を使用した場合、20 年間の累積削減額の現在価値はいくらですか。
savingsLifetime

object (Money)

パネルのライフタイム全体の節約。
presentValueOfSavingsLifetime

object (Money)

仮定した割引率を使用した場合、累積のライフタイム節約の現在価値はいくらですか。
financiallyViable

boolean

このシナリオが経済的に実現可能かどうかを示します。経済的な実現可能性が低いシナリオ（資金の損失など）では false になります。

CashPurchaseSavings

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

JSON 表現 
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
フィールド
outOfPocketCost

object (Money)

税制優遇措置前の初期費用: 自己負担額。upfrontCost は税制優遇措置の後です。
upfrontCost

object (Money)

税制優遇措置適用後の初期費用: 初年度に支払う必要がある金額です。outOfPocketCost（税制前）とは対照的です。
rebateValue

object (Money)

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

object (SavingsOverTime)

全期間で節約される金額（または節約されない金額）です。
paybackYears

number

投資回収までの年数。負の値は、ライフタイム期間内に投資が返済されないことを意味します。

FinancedPurchaseSavings

ローンを利用して、特定の電力使用量の太陽光発電パネルの特定の構成を購入した場合のコストとメリット。

JSON 表現 
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
フィールド
annualLoanPayment

object (Money)

年単位のローン返済。
rebateValue

object (Money)

すべての税金の還付額（連邦投資税額控除（ITC）を含む）。
loanInterestRate

number

この計算セットで想定されるローンの金利。
savings

object (SavingsOverTime)

全期間で節約される金額（または節約されない金額）です。