Method: dataLayers.get
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
위치 주변 지역의 태양광 정보를 가져옵니다. 위치가 서비스 지역 외부에 있는 경우 코드 NOT_FOUND와 함께 오류를 반환합니다.
HTTP 요청
GET https://solar.googleapis.com/v1/dataLayers:get
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
| 매개변수 |
location |
object (LatLng)
필수 항목입니다. 데이터를 가져올 지역 중심의 경도 및 위도입니다.
|
radiusMeters |
number
필수 항목입니다. 데이터를 반환해야 하는 중심점을 둘러싼 영역을 정의하는 반경(미터)입니다. 이 값의 제한사항은 다음과 같습니다.
- 최대 100m까지의 값을 언제든지 지정할 수 있습니다.
radiusMeters <= pixelSizeMeters * 1000인 경우 100m를 초과하는 값을 지정할 수 있습니다.- 하지만 175m를 초과하는 값의 경우 요청의
DataLayerView에 월간 플럭스 또는 시간당 음영이 포함되어서는 안 됩니다.
|
view |
enum (DataLayerView)
선택사항입니다. 반환할 데이터의 원하는 하위 집합입니다.
|
requiredQuality |
enum (ImageryQuality)
선택사항입니다. 결과에서 허용되는 최소 품질 수준입니다. 이보다 낮은 품질의 결과는 반환되지 않습니다. 이 옵션을 지정하지 않으면 HIGH 품질로만 제한하는 것과 같습니다.
|
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)
선택사항입니다. 사용 설정할 GA 이전 실험을 지정합니다.
|
응답 본문
성공한 경우 응답 본문에 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 |
모든 데이터를 가져옵니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]
