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 的圖像元件，將以一般解析度傳回。
exactQualityRequired

boolean

選用設定。是否需要精確的圖像品質。如果設為 False，系統會將 requiredQuality 欄位解讀為最低需求品質，因此當 requiredQuality 設為 MEDIUM 時，可能會傳回高畫質圖像。如果設為 True，系統會將 requiredQuality 解讀為確切所需的品質，且只有在 requiredQuality 設為 MEDIUM 時，才會傳回 MEDIUM 品質的圖像。

要求主體

要求主體必須為空白。

回應主體

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