Method: dataLayers.get

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

Tham 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 thông tin về luồng ánh sáng hằng tháng hoặc độ che phủ 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. Việc không chỉ định thuộc tính 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 hiểu là chất lượng cần thiết chính xác và chỉ hình ảnh chất lượng MEDIUM mới được trả về nếu requiredQuality được đặt thành MEDIUM.

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 sáng hằng năm và luồng sáng hằng tháng.
FULL_LAYERS Lấy tất cả dữ liệu.