Method: dataLayers.get

取得位置周圍區域的太陽能資訊。如果位置超出涵蓋範圍，則傳回代碼為 NOT_FOUND 的錯誤。

HTTP 要求

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

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

查詢參數

參數
location

object (LatLng)

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

number

必填。半徑 (以公尺為單位)，用於定義中心點周圍的區域，系統應傳回該區域的資料。這項值的限制如下：

  • 您隨時可以指定任何值，但不得超過 100 公尺。
  • 只要 radiusMeters <= pixelSizeMeters * 1000，即可指定超過 1 億的值。
  • 不過，如果值超過 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 時，可能會傳回 HIGH 品質的圖像。如果設為 true，系統會將 requiredQuality 解讀為確切的必要品質，且只有在 requiredQuality 設為 MEDIUM 時，才會傳回 MEDIUM 品質的圖像。
experiments[]

enum (Experiment)

(選用步驟) 指定要啟用的正式發布前實驗。根據《Google 地圖平台服務專屬條款》，使用這個欄位提出的要求屬於正式發布前產品。詳情請參閱 [推出階段說明]( https://cloud.google.com/maps-platform/terms/launch-stages)。

要求主體

要求主體必須為空白。

回應主體

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