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 公尺的值。
  • 不過,如果值超過 175m,請勿在要求中加入月度流量或每小時遮蔽率的 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 取得所有資料。