REST Resource: dataLayers

リソース: DataLayers

地域の太陽光発電の可能性に関する情報。実際のデータは、リクエストされたリージョンをカバーする複数の GeoTIFF ファイルに含まれています。このメッセージには、これらのファイルの URL が含まれています。DataLayers メッセージの各文字列には、対応する GeoTIFF を取得できる URL が含まれています。これらの URL は、生成されてから数時間有効です。ほとんどの GeoTIFF ファイルの解像度は 0.1 m/ピクセルですが、月間フラックス ファイルは 0.5 m/ピクセル、1 時間ごとの日陰ファイルは 1 m/ピクセルです。GetDataLayersRequest で pixelSizeMeters 値が指定されている場合、GeoTIFF ファイルの最小解像度はその値になります。

JSON 表現 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
フィールド
imageryDate

object (Date)

この地域のソース画像（他のすべてのデータが派生した画像）が撮影された日時。画像が複数日にわたって撮影されている可能性があるため、ある程度の誤差は生じます。
imageryProcessedDate

object (Date)

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

string

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

string

地域の RGB データ（航空写真）の画像の URL。
maskUrl

string

建物のマスク画像の URL。各ピクセルが屋上の一部と見なされるかどうかを示す 1 ビット。
annualFluxUrl

string

地域の年間フラックス マップ（屋根に当たる年間日光量）の URL。値は kWh/kW/年です。これはマスクされていないフラックスです。フラックスは建物の屋上だけでなく、すべての場所で計算されます。無効な位置情報は -9999 として保存されます。対象範囲外の位置情報は無効になります。また、対象範囲内の位置情報であっても、フラックスを計算できなかった位置情報も無効になります。
monthlyFluxUrl

string

地域の月ごとのフラックスマップ（屋根の太陽光、月ごとの内訳）の URL。値は kWh/kW/年です。この URL で指定された GeoTIFF には、1 月から 12 月までの順に 12 個のバンドが含まれます。
hourlyShadeUrls[]

string

1 月から 12 月までの各月に対応する 12 個の 1 時間ごとの日陰の URL。各 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 時間で、正午は常に「標準時」の正午です）。
imageryQuality

enum (ImageryQuality)

結果の画像品質。

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付は西暦を基準にしており、これは次のいずれかを表します。

  • 年の値がゼロ以外である月と日の値を含む完全な日付
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日の値がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

ImageryQuality

一部の API 結果の計算に使用される画像の品質。

注: 画像の品質レベルにかかわらず、DSM 出力の解像度は常に 0.1 m/ピクセル、月間フラックス出力の解像度は常に 0.5 m/ピクセル、時間単位の日陰出力の解像度は常に 1 m/ピクセルです。

列挙型
IMAGERY_QUALITY_UNSPECIFIED 品質は不明です。
HIGH 太陽光発電データは、低高度で撮影された航空画像から取得され、0.1 m/ピクセルで処理されます。
MEDIUM 太陽光発電のデータは、高高度で撮影され、0.25 m/ピクセルで処理された高解像度の航空画像から導き出されます。
BASE 太陽光発電データは、0.25 m/ピクセルで処理された高解像度衛星画像から取得されます。

メソッド

get

 ある地点の位置周辺地域における太陽光発電に関する情報を取得します。