Method: buildingInsights.findClosest

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

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。API が最も近い既知の建物を探す緯度と経度。
requiredQuality

enum (ImageryQuality)

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

boolean

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

enum (Experiment)

省略可。有効にする pre-GA テストを指定します。このフィールドを使用するリクエストは、Google Maps Platform サービス固有の規約に基づく一般提供前サービスとして分類されます。詳細については、リリース ステージの説明をご覧ください。
additionalInsights[]

enum (AdditionalInsights)

省略可。レスポンスに含める additionalInsights のリスト。

リクエストの本文

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

レスポンスの本文

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),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
フィールド
name

string

建物のリソース名（buildings/{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)

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

object (DetectedArrays)

建物で検出された太陽光パネル。このフィールドは、リクエストの FindClosestBuildingInsightsRequest.additional_insights に DETECTED_ARRAYS が含まれている場合にのみ入力されます。

認可スコープ

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

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

AdditionalInsights

BuildingInsights で返される屋根のジオメトリや太陽光パネル アレイなどの建物の追加情報。

列挙型
ADDITIONAL_INSIGHTS_UNSPECIFIED デフォルト値。デフォルトの BuildingInsights が返されます。
DETECTED_ARRAYS

検出された配列をレスポンスに含めるかどうかを決定します。

指定すると、レスポンスの detectedArrays フィールドに値が入力されます。

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 kWh / kW（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%、最大値）になります。値は maxSunshineHoursPerYear のように年間 kWh/kW で表されます。
groundAreaMeters2

number

屋根または屋根セグメントで覆われた地面のフットプリント面積（平方メートル）。

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 は、単一の太陽光パネルの位置、向き、発電量を記述します。パネルのパラメータについては、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 の FinancialAnalysis のうち 1 つだけに 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 には正数、0、または負数を指定できます。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

太陽光パネルが初年度に発電すると予想される 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)

税制優遇措置後の初期費用: 最初の 1 年間に支払う必要がある金額。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)

ライフサイクル期間中に節約できた金額（または節約できなかった金額）。

DetectedArrays

建物で検出された太陽光発電アレイに関する情報。

JSON 表現 
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
フィールド
detectionStatus

enum (DetectionStatus)

この建物の太陽光発電アレイの検出ステータスを示します。
latestCaptureDate

object (Date)

最新のソーラーアレイ データが取得された日時を示す日付。

DetectionStatus

この建物の太陽光発電アレイの検出ステータスを示します。

列挙型
DETECTION_STATUS_UNSPECIFIED ステータスは指定されていません。
DETECTION_STATUS_DATA_UNAVAILABLE この建物では、検出された太陽光発電パネルのデータを利用できません。
DETECTION_STATUS_ARRAYS_DETECTED この建物に少なくとも 1 つの太陽光発電設備が検出されました。
DETECTION_STATUS_NO_ARRAYS_DETECTED この建物では太陽光発電設備が検出されませんでした。