Method: dataLayers.get
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhận thông tin về năng lượng mặt trời cho một khu vực xung quanh một vị trí. Trả về lỗi có mã NOT_FOUND nếu vị trí nằm ngoài khu vực phủ sóng.
Yêu cầu HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Thông số |
location |
object (LatLng)
Bắt buộc. Kinh độ và vĩ độ của trung tâm khu vực để lấy dữ liệu.
|
radiusMeters |
number
Bắt buộc. Bán kính, tính bằng mét, xác định vùng xung quanh điểm trung tâm mà dữ liệu sẽ được trả về. Các giới hạn đối với giá trị này là:
- Bạn luôn có thể chỉ định bất kỳ giá trị nào lên đến 100 triệu.
- Bạn có thể chỉ định các giá trị trên 100 triệu, miễn là
radiusMeters <= pixelSizeMeters * 1000.
- Tuy nhiên, đối với các giá trị trên 175 m,
DataLayerView trong yêu cầu không được bao gồm luồng ánh sáng hằng tháng hoặc bóng râm hằng giờ.
|
view |
enum (DataLayerView)
Không bắt buộc. Tập hợp con dữ liệu mong muốn để trả về.
|
requiredQuality |
enum (ImageryQuality)
Không bắt buộc. Cấp chất lượng tối thiểu được phép trong kết quả. Hệ thống sẽ không trả về kết quả có chất lượng thấp hơn mức này. Nếu bạn không chỉ định thuộc tính này, thì điều này tương đương với việc chỉ cho phép chất lượng CAO.
|
pixelSizeMeters |
number
Không bắt buộc. Tỷ lệ tối thiểu, tính bằng mét trên pixel, của dữ liệu cần trả về. Hệ thống hỗ trợ các giá trị 0,1 (mặc định, nếu bạn không đặt trường này một cách rõ ràng), 0,25, 0,5 và 1,0. Các thành phần hình ảnh có độ phân giải thông thường nhỏ hơn pixelSizeMeters sẽ được trả về ở độ phân giải do pixelSizeMeters chỉ định; các thành phần hình ảnh có độ phân giải thông thường bằng hoặc lớn hơn pixelSizeMeters sẽ được trả về ở độ phân giải thông thường đó.
|
exactQualityRequired |
boolean
Không bắt buộc. Liệu có yêu cầu chất lượng chính xác của hình ảnh hay không. Nếu bạn đặt giá trị này thành false, trường requiredQuality sẽ được diễn giải là chất lượng tối thiểu bắt buộc, chẳng hạn như hình ảnh có chất lượng CAO có thể được trả về khi bạn đặt requiredQuality thành MEDIUM. Nếu được đặt thành true, requiredQuality sẽ được diễn giải là chất lượng cần thiết chính xác và chỉ hình ảnh chất lượng MEDIUM được trả về nếu requiredQuality được đặt thành MEDIUM.
|
experiments[] |
enum (Experiment)
Không bắt buộc. Chỉ định các thử nghiệm trước giai đoạn phát hành rộng rãi cần bật.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của DataLayers.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Tập hợp con thông tin về mặt trời cần trả về.
| Enum |
DATA_LAYER_VIEW_UNSPECIFIED |
Tương đương với FULL. |
DSM_LAYER |
Chỉ nhận DSM. |
IMAGERY_LAYERS |
Lấy DSM, RGB và mặt nạ. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Nhận DSM, RGB, mặt nạ và luồng ánh sáng hằng năm. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Nhận DSM, RGB, mặt nạ, luồng ánh sáng hằng năm và luồng ánh sáng hằng tháng. |
FULL_LAYERS |
Lấy tất cả dữ liệu. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]
