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 は正確に必要な品質として解釈され、requiredQuality が MEDIUM に設定されている場合は MEDIUM 品質の画像のみが返されます。
|
experiments[] |
enum (Experiment )
省略可。有効にする一般提供前テストを指定します。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には 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-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[[["\u003cp\u003eRetrieves solar information for a specified region using latitude, longitude, and radius.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of data retrieval with parameters like \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erequiredQuality\u003c/code\u003e, \u003ccode\u003epixelSizeMeters\u003c/code\u003e, and \u003ccode\u003eexactQualityRequired\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns an error if the location is outside the coverage area or if radius exceeds limitations.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a \u003ccode\u003eDataLayers\u003c/code\u003e object containing the requested solar data subset if successful.\u003c/p\u003e\n"]]],["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"],null,["# Method: dataLayers.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DataLayerView](#DataLayerView)\n- [Try it!](#try-it)\n\nGets solar information for a region surrounding a location. Returns an error with code `NOT_FOUND` if the location is outside the coverage area.\n\n### HTTP request\n\n`GET https://solar.googleapis.com/v1/dataLayers:get`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[LatLng](/maps/documentation/solar/reference/rest/v1/LatLng)`)` Required. The longitude and latitude for the center of the region to get data for. |\n| `radiusMeters` | `number` Required. The radius, in meters, defining the region surrounding that centre point for which data should be returned. The limitations on this value are: - Any value up to 100m can always be specified. - Values over 100m can be specified, as long as `radiusMeters` \\\u003c= `pixelSizeMeters * 1000`. - However, for values over 175m, the `DataLayerView` in the request must not include monthly flux or hourly shade. |\n| `view` | `enum (`[DataLayerView](/maps/documentation/solar/reference/rest/v1/dataLayers/get#DataLayerView)`)` Optional. The desired subset of the data to return. |\n| `requiredQuality` | `enum (`[ImageryQuality](/maps/documentation/solar/reference/rest/v1/dataLayers#ImageryQuality)`)` Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only. |\n| `pixelSizeMeters` | `number` Optional. The minimum scale, in meters per pixel, of the data to return. Values of 0.1 (the default, if this field is not set explicitly), 0.25, 0.5, and 1.0 are supported. Imagery components whose normal resolution is less than `pixelSizeMeters` will be returned at the resolution specified by `pixelSizeMeters`; imagery components whose normal resolution is equal to or greater than `pixelSizeMeters` will be returned at that normal resolution. |\n| `exactQualityRequired` | `boolean` Optional. Whether to require exact quality of the imagery. If set to false, the `requiredQuality` field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned when `requiredQuality` is set to MEDIUM. If set to true, `requiredQuality` is interpreted as the exact required quality and only `MEDIUM` quality imagery is returned if `requiredQuality` is set to `MEDIUM`. |\n| `experiments[]` | `enum (`[Experiment](/maps/documentation/solar/reference/rest/v1/Experiment)`)` Optional. Specifies the pre-GA experiments to enable. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [DataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers#DataLayers).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nDataLayerView\n-------------\n\nWhat subset of the solar information to return.\n\n| Enums ||\n|----------------------------------|--------------------------------------------------------|\n| `DATA_LAYER_VIEW_UNSPECIFIED` | Equivalent to FULL. |\n| `DSM_LAYER` | Get the DSM only. |\n| `IMAGERY_LAYERS` | Get the DSM, RGB, and mask. |\n| `IMAGERY_AND_ANNUAL_FLUX_LAYERS` | Get the DSM, RGB, mask, and annual flux. |\n| `IMAGERY_AND_ALL_FLUX_LAYERS` | Get the DSM, RGB, mask, annual flux, and monthly flux. |\n| `FULL_LAYERS` | Get all data. |"]]