REST Resource: dataLayers

リソース: DataLayers

地域の太陽光発電のポテンシャルに関する情報。実際のデータは、リクエストされた地域に対応するいくつかの GeoTIFF ファイルに格納されています。このメッセージには URL が含まれています。DataLayers メッセージの各文字列には、対応する GeoTIFF を取得できる URL が含まれています。この URL は、生成後数時間有効です。GeoTIFF ファイルのほとんどは解像度が 0.1m/pixel ですが、月間フラックス ファイルは 0.5m/pixel、1 時間ごとのシェード ファイルは 1m/pixel です。GetDataLayersRequestpixelSizeMeters 値が指定された場合、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)

この地域のソース画像(その他すべてのデータの提供元)が撮影された日時。画像は 1 日以上撮影されている可能性があるため、おおよそのものになります。

imageryProcessedDate

object (Date)

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

dsmUrl

string

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

rgbUrl

string

地域の RGB データ(航空写真)の画像の URL。

maskUrl

string

建物のマスク画像の URL: そのピクセルが屋根の一部とみなされるかどうかを示す 1 ピクセルあたり 1 ビット。

annualFluxUrl

string

地域の年間フラックス マップ(屋根の年間日射量)の URL。値は kWh/kW/年です。これはマスク処理されていないフラックスです。フラックスは、建物の屋上だけでなく、すべての場所に対して計算されます。無効な位置情報は -9999 で保存されます。カバレッジ エリア外の場所は無効になり、フラックスを計算できなかったカバレッジ エリア内のいくつかの場所も無効になります。

monthlyFluxUrl

string

地域の月間フラックス マップ(屋根への日射量、月別に分類)の URL。値は kWh/kW/年です。この URL で示される GeoTIFF には、1 月から 12 月に対応する 12 個のバンドが順番に含まれることになります。

hourlyShadeUrls[]

string

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

次のような例が役立ちます。あるポイント(ピクセル位置 (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 時間で、正午は常に「標準時間」の正午です)。

imageryQuality

enum (ImageryQuality)

検索結果の画像の品質。

日付

誕生日など、カレンダーの日付の全体または一部を表します。時刻とタイムゾーンは他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。次のいずれかを表します。

  • ゼロ以外の年、月、日の値を持つ完全な日付。
  • 年を含む月と日(記念日など)。
  • 0 か月がゼロの日と 0 日という単独の年。
  • 年と月、日がゼロ(クレジット カードの有効期限など)。

関連するタイプ:

JSON 表現
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

日付の年。1 ~ 9999 の範囲で指定するか、年のない日付を指定する場合は 0 にする必要があります。

month

integer

月。1 ~ 12 にする必要があります。月と日のない年を指定するには 0 を指定します。

day

integer

日。1 ~ 31 の範囲の年と月で指定でき、0 の場合は単独で年を指定するか、日付が重要でない年と月を指定します。

ImageryQuality

API の結果の計算に使用される画像の品質。

注: 画像品質レベルに関係なく、DSM 出力の解像度は常に 0.1 m/ピクセル、月間フラックス出力の解像度は常に 0.5 m/ピクセル、1 時間ごとの日陰出力の解像度は常に 1 m/ピクセルです。

列挙型
IMAGERY_QUALITY_UNSPECIFIED 品質は不明です。
HIGH 基礎となる画像と DSM データは 0.1 m/pixel で処理しました。
MEDIUM 基礎となる画像と DSM データは 0.25 m/pixel で処理しました。
LOW 基礎となる画像と DSM データは 0.5 m/pixel で処理しました。

Methods

get

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