REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

この地域の他のデータの取得元となるソース画像の取得日時。1 日以上にわたって撮影されている可能性があるため、この数値は多少の概算値になります。

object (Date)

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

string

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

string

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

string

建物のマスク画像の URL です。ピクセルごとに 1 ビットは、そのピクセルが屋上に含まれるかどうかを示しています。

string

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

string

地域の月次フラックス マップ（月ごとに分類された屋根の日照）の URL。値は kWh/kW/年です。この URL が指す GeoTIFF には、12 月から 12 月までの順番で 12 個のバンドが含まれます。

string

1 時間ごとのシェードの URL が 12 個。1 月から 12 月の順に表示されます。各 GeoTIFF には、1 日の 24 時間に対応する 24 のバンドが含まれます。各ピクセルは 32 ビットの整数で、その月の（最大）31 日に対応します。1 ビットは、対応する場所がその月のその日、その時間、太陽を見ることができることを意味します。無効な場所は -9999 として保存されます（これは負の値で、ビット 31 が設定されているため、その月の 32 日に対応する有効なビット 31 を設定することはできません）。

例が役に立ちます。ある地点（ピクセル位置 (x, y) にある地点）が 6 月 22 日の午後 4 時に太陽を観測したかどうかを確認するには、次のようにします。

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] はチャンネルへのインデックス登録、最終的な結果がゼロ以外の場合は「晴れ」を意味します。うるう日はなく、DST も存在しません（すべての日が 24 時間で、正午は常に「標準時」正午）。

enum (ImageryQuality)

結果の画像の品質。

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

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