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 個の 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 時間で、正午は常に「標準時」の正午です）。
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 時間ごとの日陰の出力の解像度は常に 1 m/ピクセルです。

列挙型
IMAGERY_QUALITY_UNSPECIFIED 品質は不明です。
HIGH 太陽光データは、低高度で撮影された航空画像から取得され、0.1 m/ピクセルで処理されます。
MEDIUM 太陽光データは、高高度で撮影されたエンハンスト航空画像から取得され、ピクセルあたり 0.25 m で処理されます。
LOW 太陽光データは、0.25 m/ピクセルで処理された高度な衛星画像から取得されます。

メソッド

get

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