Method: dataLayers.get

ある地点の位置周辺地域の太陽光発電に関する情報を取得します。位置情報がカバレッジエリア外の場合は、コード NOT_FOUND のエラーを返します。

HTTP リクエスト

GET https://solar.googleapis.com/v1/dataLayers:get

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。データを取得する地域の中心の緯度と経度。

radiusMeters

number

必須。中心点の周囲の領域を定義する半径(メートル単位)。この領域のデータが返されます。この値には次の制限があります。

  • 最大 100 m までの任意の値を指定できます。
  • radiusMeters <= pixelSizeMeters * 1000 であれば、100 m を超える値を指定できます。
  • ただし、値が 175 m を超える場合、リクエストの DataLayerView には月単位のフルークスや 1 時間あたりのシェードを含めることはできません。
view

enum (DataLayerView)

省略可。返されるデータのサブセット。

requiredQuality

enum (ImageryQuality)

省略可。結果で許可される最小品質レベル。この値より低い品質の結果は返されません。指定しない場合、品質が「高」の動画のみが検索対象になります。

pixelSizeMeters

number

省略可。返されるデータの最小スケール(ピクセルあたりのメートル単位)。サポートされている値は、0.1(このフィールドが明示的に設定されていない場合のデフォルト)、0.25、0.5、1.0 です。通常の解像度が pixelSizeMeters 未満の画像コンポーネントは、pixelSizeMeters で指定された解像度で返されます。通常の解像度が pixelSizeMeters 以上の画像コンポーネントは、その通常の解像度で返されます。

exactQualityRequired

boolean

省略可。画像の品質を厳密に指定するかどうか。false に設定すると、requiredQuality フィールドは必要な最小品質として解釈されます。たとえば、requiredQuality が MEDIUM に設定されている場合、高品質の画像が返されることがあります。true に設定すると、requiredQuality は正確に必要な品質として解釈され、requiredQualityMEDIUM に設定されている場合は MEDIUM 品質の画像のみが返されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には DataLayers のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

返される太陽光発電情報のサブセット。

列挙型
DATA_LAYER_VIEW_UNSPECIFIED FULL と同じです。
DSM_LAYER DSM のみを取得します。
IMAGERY_LAYERS DSM、RGB、マスクを取得します。
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM、RGB、マスク、年間フラックスを取得します。
IMAGERY_AND_ALL_FLUX_LAYERS DSM、RGB、マスク、年間フラックス、月間フラックスを取得します。
FULL_LAYERS すべてのデータを取得します。