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 được hỗ trợ.

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ĩ độ cho trung tâm của 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 khu vực xung quanh điểm trung tâm mà dữ liệu sẽ được trả về. Giá trị này có những điểm hạn chế sau:

  • Bạn luôn có thể chỉ định mọi giá trị lên đến 100m.
  • Bạn có thể chỉ định các giá trị lớn hơn 100m, miễn là radiusMeters <= pixelSizeMeters * 1000.
  • Tuy nhiên, đối với các giá trị trên 175m, DataLayerView trong yêu cầu không được bao gồm biến độ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 mong muốn của dữ liệu cần trả về.
requiredQuality

enum (ImageryQuality)

Không bắt buộc. Mức chất lượng tối thiểu được phép trong kết quả. Không có kết quả nào có chất lượng thấp hơn kết quả này được trả về. Nếu không chỉ định, điều này tương đương với việc chỉ hạn chế ở 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 mỗi pixel) của dữ liệu cần trả về. Các giá trị 0,1 (mặc định, nếu bạn không đặt rõ ràng trường này), 0,25, 0,5 và 1,0 được hỗ trợ. Các thành phần hình ảnh có độ phân giải bình 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 bình thường bằng hoặc lớn hơn pixelSizeMeters sẽ được trả về ở độ phân giải bình thường đó.
exactQualityRequired

boolean

Không bắt buộc. 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 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, sao cho hình ảnh có chất lượng CAO có thể được trả về khi requiredQuality được đặt thành TRUNG BÌNH. Nếu được đặt thành true, requiredQuality sẽ được diễn giải là chất lượng chính xác cần thiết 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 giai đoạn trước khi phát hành rộng rãi cần bật. Các yêu cầu sử dụng trường này được phân loại là sản phẩm ở giai đoạn trước khi phát hành rộng rãi theo Điều khoản dành riêng cho dịch vụ của Google Maps Platform. Hãy xem [phần mô tả giai đoạn ra mắt]( https://cloud.google.com/maps-platform/terms/launch-stages) để biết thêm thông tin.

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 thực thể 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

Những thông tin nào về năng lượng 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à thông lượng hằng năm.
IMAGERY_AND_ALL_FLUX_LAYERS Nhận DSM, RGB, mặt nạ, thông lượng hằng năm và thông lượng hằng tháng.
FULL_LAYERS Nhận tất cả dữ liệu.