dataLayers エンドポイントは、GeoTIFF ファイルとしてエンコードされたデータを返します。このデータは、任意の地理情報システム（GIS）アプリケーションで太陽光発電システムを設計するために使用できます。
dataLayers レスポンスの各文字列には URL が含まれています。この URL を使用して、対応する GeoTIFF を取得できます。URL は、元のデータレイヤ リクエストから生成されてから最大 1 時間有効です。GeoTIFF ファイルは最大 30 日間保存できます。
RGB レイヤを除き、GeoTIFF ファイルは RGB 画像ではなくエンコードされたデータであるため、画像ビューアでは正しく表示されません。また、GeoTIFF ファイルは、Maps JavaScript API でオーバーレイ画像として直接使用することもできません。
次の表に、各レイヤについて詳しく説明します。
| レイヤ | ピクセル深度 | 解決策 | 説明 |
|---|---|---|---|
| デジタル サーフェス モデル（DSM） | 32 ビット浮動小数点数 | 0.1 m/pixel | 自然地形や人工地形など、地球表面の地形を表す標高データ。値は海抜メートル単位です。無効な場所やデータがない地域は -9999 として保存されます。 |
| RGB | 8 ビット | 0.1 m/pixel 0.25 m/pixel 0.5 m/pixel 1 m/pixel |
地域の航空写真。GeoTIFF 画像ファイルには、赤、緑、青の値に対応する 3 つのバンドが含まれており、各ピクセルの 24 ビット RGB 値を形成します。 デフォルトでは、ピクセル解像度は 0.1 m/ピクセルです。 |
| 建物マスク | 1 ビット | 0.1 m/pixel | ピクセルごとに 1 ビット。そのピクセルが屋根の一部と見なされるかどうかを示します。 |
| 年間流量 | 32 ビット浮動小数点数 | 0.1 m/pixel | 地域の年間フラックス マップ（屋根に当たる年間日光）。値は kWh/kW/年です。 フリュークスは、建物の屋上だけでなく、すべての場所で計算されます。無効なロケーション、またはフロー計算ができなかったエリアは -9999 として保存されます。対応エリア外のロケーションは無効です。 注: これはマスクなしのフルクスの値です。 |
| 月間流量 | 32 ビット浮動小数点数 | 0.5 m/pixel | 地域の月ごとのフラックス マップ（屋根の日照量、月別）。値は kWh/kW/年です。GeoTIFF 画像ファイルには、1 月から 12 月に相当する 12 個のバンドが順番に含まれています。 |
| 1 時間あたりの日陰 | 32 ビットの整数 | 1 m/pixel | 1 月から 12 月までの 1 時間ごとの日陰マップの URL 12 個（順番に並べます）。 各 GeoTIFF ファイルには、1 日の 24 時間に対応する 24 個のバンドが含まれています。各ピクセルは 32 ビットの整数で、その月の（最大）31 日に対応しています。1 ビットは、対応する場所がその月、その日、その時間帯に太陽を見ることができることを意味します。 無効なロケーションは -9999 として保存され、ビット 31 が設定されます。これは、月 32 日目に相当するため、無効です。 |
1 時間ごとの陰影ラスターのデコード
1 時間ごとの日陰データは、マルチバンド ラスター形式でエンコードされます。ラスターに関する基本事項については、Solar API のコンセプトをご覧ください。
1 時間ごとの日陰データをリクエストすると、最大 12 個のラスター（暦年の各月（1 月から 12 月）に 1 つ）を受け取ることができます。各ラスターは、1 日の 24 時間に対応する 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))