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