Method: dataLayers.get

取得某個位置週邊區域的太陽能資訊。如果地點不在服務涵蓋範圍內,系統會傳回代碼 NOT_FOUND 的錯誤。

HTTP 要求

GET https://solar.googleapis.com/v1/dataLayers:get

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
location

object (LatLng)

必要欄位。要取得資料的區域中心經緯度。

radiusMeters

number

必要欄位。這個半徑 (以公尺為單位) 定義了應傳回該中心點周圍的區域。這個值的限制如下:

  • 一律指定不超過 100m 的任何值。
  • 可以指定超過 100 公尺的值,只要 radiusMeters <= pixelSizeMeters * 1000 即可。
  • 不過,如果值超過 175 公尺,要求中的 DataLayerView 不得包含每月通量或每小時色帶。
view

enum (DataLayerView)

選用設定。要傳回的資料子集。

requiredQuality

enum (ImageryQuality)

選用設定。結果中允許的最低品質等級。不會傳回品質低於此標準的結果。不指定此選項只會將限制限制為高畫質。

pixelSizeMeters

number

選用設定。要傳回資料的最小比例 (以公尺/每像素為單位)。值為 0.1 (如果未明確設定這個欄位,預設值),可支援 0.25、0.5 和 1.0。如果圖像元件的一般解析度低於 pixelSizeMeters,就會以 pixelSizeMeters 指定的解析度傳回;一般解析度等於或大於 pixelSizeMeters 的圖像元件,將以一般解析度傳回。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 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 取得所有資料。