發出資料層要求

dataLayers 端點可針對指定位置周圍的區域提供詳細的太陽能資訊。端點會傳回 17 個可下載的 TIFF 檔案,包括:

  • 數位表面模型 (DSM)
  • RGB 複合圖層 (空照圖像)
  • 識別分析邊界的遮罩層
  • 年度太陽能流感,或特定表面的年收益
  • 每月太陽能流動量,或特定表面的每月產量
  • 每小時遮蔭 (24 小時)

如要進一步瞭解 Solar API 如何定義 flux,請參閱「Solar API 概念」。

關於資料層要求

以下範例顯示向 dataLayers 方法發出的 REST 要求網址:

https://solar.googleapis.com/v1/dataLayers:get?parameters

加入要求網址參數,並指定下列各項:

  • 營業地點的經緯度座標
  • 位置周圍的區域半徑
  • 要傳回的資料子集 (DSM、RGB、遮罩、年度流量或每月流動量)
  • 結果所允許的最低品質
  • 要傳回的資料最小尺度 (以像素為單位)

資料層要求範例

以下範例會要求該位置以經緯度座標 = 37.4450,且經度 = -122.1390 為 100 公尺的所有建築物深入分析資訊:

API 金鑰

如要對回應中的網址提出要求,請在網址內附加 API 金鑰:

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

您也可以在瀏覽器的網址列貼上 cURL 要求中的網址,藉此提出 HTTP 要求。傳遞 API 金鑰可讓您享有更好的使用與分析功能,以及更精準地控管回應資料。

OAuth 憑證

注意:此格式僅適用於測試環境。詳情請參閱「使用 OAuth」。

如要對回應中的網址發出要求,請傳入帳單專案名稱和 OAuth 權杖:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

API 會以下列格式傳回網址:

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

回應範例

要求會產生 JSON 回應,格式如下:

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

存取回應資料

需要額外驗證才能透過回應網址存取資料。如果您使用驗證金鑰,就必須將 API 金鑰附加至網址。如果您要使用 OAuth 驗證,就必須新增 OAuth 標頭。

API 金鑰

如要對回應中的網址提出要求,請在網址內附加 API 金鑰:

curl -X GET "https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

您也可以在瀏覽器的網址列貼上 cURL 要求中的網址,藉此提出 HTTP 要求。傳遞 API 金鑰可讓您享有更好的使用與分析功能,以及更精準地控管回應資料。

OAuth 憑證

如要對回應中的網址發出要求,請傳入帳單專案名稱和 OAuth 權杖:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

除了 RGB 層以外,所有 TIFF 檔案會在圖片檢視器應用程式中顯示為空白圖片。如要查看下載的 TIFF 檔案,請將這些檔案匯入對應應用程式軟體,例如 QGIS。

如需這項要求和回應的完整規格,請參閱參考說明文件