Method: dataLayers.get

取得某個位置周圍區域的太陽能資訊。如果位置不在涵蓋範圍內，則會傳回代碼 NOT_FOUND 的錯誤。

HTTP 要求

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

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

查詢參數

參數
location

object (LatLng)

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

number

必要欄位。半徑 (以公尺為單位)，定義該中心點周圍的區域，系統會傳回該區域的資料。此值的限制如下：

  • 您可以指定任何值 (上限為 100 公尺)。
  • 只要 radiusMeters <= pixelSizeMeters * 1000，即可指定超過 100 公尺的值。
  • 不過，如果值超過 175 公尺，請勿在要求中加入月度流量或每小時陰影的 DataLayerView。
view

enum (DataLayerView)

(非必要) 要傳回的資料子集。
requiredQuality

enum (ImageryQuality)

(非必要) 結果中允許的最低品質等級。系統不會傳回品質低於此值的結果。如未指定，則系統會只限制高品質。
pixelSizeMeters

number

(非必要) 傳回資料的最小比例 (以每像素公尺為單位)。系統支援的值為 0.1 (如果未明確設定此欄位，則為預設值)、0.25、0.5 和 1.0。如果圖像元件的正常解析度小於 pixelSizeMeters，系統會以 pixelSizeMeters 指定的解析度傳回圖像元件；如果圖像元件的正常解析度等於或大於 pixelSizeMeters，系統會以該正常解析度傳回圖像元件。
exactQualityRequired

boolean

(非必要) 是否要求圖像的確切品質。如果設為 false，系統會將 requiredQuality 欄位解讀為最低要求的品質，因此當 requiredQuality 設為 MEDIUM 時，系統可能會傳回高品質圖像。如果設為 true，系統會將 requiredQuality 解讀為確切的必要品質，且只有在 requiredQuality 設為 MEDIUM 時，才會傳回 MEDIUM 品質的圖像。
experiments[]

enum (Experiment)

(非必要) 指定要啟用的正式發布前實驗。

要求主體

要求主體必須為空白。

回應主體

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