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 이전 실험을 지정합니다. 이 필드를 사용하는 요청은 Google Maps Platform 서비스별 약관에 따라 GA 이전 제품 또는 서비스로 분류됩니다. 자세한 내용은 [출시 단계 설명]( https://cloud.google.com/maps-platform/terms/launch-stages)을 참고하세요.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 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 모든 데이터를 가져옵니다.