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 である限り、1 億を超える値を指定できます。
- ただし、値が 175 m を超える場合、リクエストの
DataLayerView に月ごとのフラックスまたは時間ごとの日陰を含めることはできません。
|
view |
enum (DataLayerView )
省略可。返すデータのサブセット。
|
requiredQuality |
enum (ImageryQuality )
省略可。結果で許容される最小品質レベル。これより品質の低い結果は返されません。これを指定しないと、高品質のみに制限することと同じになります。
|
pixelSizeMeters |
number
省略可。返されるデータの最小スケール(ピクセルあたりのメートル単位)。値 0.1(このフィールドが明示的に設定されていない場合のデフォルト)、0.25、0.5、1.0 がサポートされています。標準解像度が pixelSizeMeters より小さい画像コンポーネントは、pixelSizeMeters で指定された解像度で返されます。標準解像度が pixelSizeMeters 以上である画像コンポーネントは、その標準解像度で返されます。
|
exactQualityRequired |
boolean
省略可。画像の正確な品質が必要かどうか。false に設定した場合、requiredQuality フィールドは、必要な最低品質として解釈されます。そのため、requiredQuality が「中」に設定されている場合は高画質の画像が返されます。true に設定すると、requiredQuality は必要とされる正確な品質と解釈され、requiredQuality が MEDIUM に設定されている場合は 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 |
すべてのデータを取得 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-02-27 UTC。
[null,null,["最終更新日 2025-02-27 UTC。"],[[["Retrieves solar information for a specified region using latitude, longitude, and radius."],["Allows customization of data retrieval with parameters like `view`, `requiredQuality`, `pixelSizeMeters`, and `exactQualityRequired`."],["Returns an error if the location is outside the coverage area or if radius exceeds limitations."],["Requires authorization with the `https://www.googleapis.com/auth/cloud-platform` scope."],["Response includes a `DataLayers` object containing the requested solar data subset if successful."]]],["This content details how to retrieve solar information for a specific region via a `GET` request to `https://solar.googleapis.com/v1/dataLayers:get`. The request requires parameters like `location` (latitude/longitude), `radiusMeters`, and optional parameters including `view`, `requiredQuality`, `pixelSizeMeters` and `exactQualityRequired`. The body is empty and a successful response will provide solar data via `DataLayers`. Specific authorization scope `https://www.googleapis.com/auth/cloud-platform` is required. `DataLayerView` allows one to define the solar information subset to be retrieved.\n"]]