dataLayers エンドポイント は、GeoTIFF ファイルとしてエンコードされたデータを返します。このデータは、あらゆる地理 情報システム（GIS）アプリケーションで使用して、太陽光発電システムを設計できます。
dataLayers レスポンスの各文字列には URL が含まれています。この URL を使用して、対応する GeoTIFF を取得できます。URL は、元のデータレイヤ リクエストから生成されてから 1 時間まで有効です。GeoTIFF ファイルは最大 30 日間保存できます。
RGB レイヤを除き、GeoTIFF ファイルは画像ビューアで正しく表示されません。コンテンツは RGB 画像ではなくエンコードされたデータであるためです。また、GeoTIFF ファイルを Maps JavaScript API でオーバーレイ画像として直接使用することもできません。
次の表に、各レイヤの詳細を示します。
| レイヤ | ピクセル深度 | 解像度 | 説明 |
|---|---|---|---|
| 数値表層モデル（DSM） | 32 ビット浮動小数点数 | 0.1 m/ピクセル | 自然の地形や人工の地形など、地球表面の地形を表す標高データ。 値は海抜 メートル単位です。無効な場所やデータがない場所は -9999 として保存されます。 |
| RGB | 8 ビット | 0.1 m/ピクセル 0.25 m/ピクセル |
地域の航空写真または衛星画像。GeoTIFF 画像ファイルには、各ピクセルの 24 ビット RGB 値を形成するために、赤、緑、青の値に対応する 3 つのバンドが含まれています。デフォルトのピクセル解像度は 0.1 m/ピクセルです。 |
| 建物マスク | 1 ビット | 0.1 m/ピクセル | ピクセルが屋上の一部と見なされるかどうかを示す 1 ピクセルあたり 1 ビット。 |
| 年間フラックス | 32 ビット浮動小数点数 | 0.1 m/ピクセル | 地域の年間フラックス マップ（屋根の年間日照時間）。値は kWh/kW/年です。 フラックスは、建物の屋上だけでなく、 すべての場所で計算されます。無効な場所やフラックスを計算できなかった場所は -9999 として保存されます。対象地域外の場所は無効です。 注: これはマスクされていないフラックスです。 |
| 月間フラックス | 32 ビット浮動小数点数 | 0.5 m/ピクセル | 地域の月間フラックス マップ（屋根の日照時間、月別）。値は kWh/kW/年です。GeoTIFF 画像ファイルには、1 月から 12 月に対応する 12 個のバンドが順番に含まれています。 |
| 1 時間ごとの日陰 | 32 ビットの整数 | 1 m/ピクセル | 1 月から 12 月に対応する 1 時間ごとの日陰マップの 12 個の URL。 各 GeoTIFF ファイルには、1 日の 24 時間に対応する 24 個のバンドが含まれています。各ピクセルは 32 ビットの整数で、 その月の最大 31 日に対応しています。1 ビットは、その月のその日のその時間に、対応する 場所で太陽が見えることを意味します。 無効な場所は -9999 として保存され、ビット 31 が設定されます。これは月の 32 日目に対応するため、無効です。 |
1 時間ごとの日陰ラスターをデコードする
1 時間ごとの日陰データは、マルチバンド ラスターでエンコードされます。ラスター の基本について詳しくは、Solar API のコンセプトをご覧ください。
1 時間ごとの日陰データをリクエストすると、1 年の各月（1 月～ 12 月）に対応する最大 12 個のラスターを受け取ることができます。各ラスター は 24 個のレイヤ（バンド）で構成され、1 日の 24 時間に対応しています。
各バンドは、セルの行列（ピクセル）で表されます。 各ピクセルの深度は 32 ビットで、その月の最大 31 日に対応しています。したがって、日陰データの日、時間、月をデコードするには、分析するビット、バンド、ラスターを理解する必要があります。
たとえば、座標（x, y）の特定の場所で 6 月 22 日の午後 4 時に太陽が見えたかどうかを確認するには、次の操作を行います。
- 場所（x, y）のすべてのレイヤに対してデータレイヤ リクエストを行います。
- 6 月は 1 年の 6 か月目なので、
hourlyShadeUrlsリストの 6 番目の URL を取得します。 - 1 時間ごとのバンドは 24 時間形式で指定されます。午後 4 時（16:00）のデータを取得するには、17 番目のチャネルを検索します。
- ビット（日）のインデックスは 0 から始まります。6 月 22 日のデータを取得するには、ビット 21 を読み取ります。
- ビットは、指定された日時でその場所で太陽が見えたかどうかを示すバイナリデータを提供します。ビットが 1 の場合、その場所で太陽が見えました。ビットが 0 の場合、その場所で日陰が見えました。
次のコードは、上記の手順をまとめたものです。
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))