Method: dataLayers.get
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
获取某个地点周围区域的太阳能信息。如果相应位置不在覆盖范围内，则返回代码为 NOT_FOUND 的错误。
HTTP 请求
GET https://solar.googleapis.com/v1/dataLayers:get
网址采用 gRPC 转码语法。
查询参数
| 参数 |
location |
object (LatLng)
必需。要获取数据的地区中心的经纬度。
|
radiusMeters |
number
必需。半径（以米为单位），用于定义应返回数据的中心点周围的区域。此值存在以下限制：
- 您可以随时指定不超过 100 米的任何值。
- 可以指定超过 1 亿的值，前提是
radiusMeters <= pixelSizeMeters * 1000。
- 不过，对于大于 175 米的值，请求中的
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 设置为 MEDIUM 时，系统可能会返回 HIGH 画质的图像。如果设置为 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 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-29。
[null,null,["最后更新时间 (UTC)：2025-08-29。"],[[["\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. |"]]
