发出数据层请求

dataLayers 端点可提供指定位置周围区域的详细太阳能信息。该端点会返回 17 个可下载的 TIFF 文件,包括:

  • 数字表面模型 (DSM)
  • RGB 复合图层(航拍图像)
  • 标识分析边界的蒙版层
  • 每年太阳能流通量或指定表面的年产量
  • 每月太阳能流通量,或指定表面的月产量
  • 每小时遮阳(24 小时)

如需详细了解 Solar API 如何定义通量,请参阅 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"

您还可以将 c网址 请求中的网址粘贴到浏览器的网址栏中,以发出 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"

您还可以将 c网址 请求中的网址粘贴到浏览器的网址栏中,以发出 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)。

如需了解此请求和响应的完整规范,请参阅参考文档