此页面由 Cloud Translation API 翻译。

REST Resource: dataLayers

资源：DataLayers <ph type="x-smartling-placeholder">
- JSON 表示法
Date
- JSON 表示法
ImageryQuality
方法

资源：DataLayer

有关某个区域的太阳能发电潜力的信息。实际数据包含在覆盖所请求区域的多个 GeoTIFF 文件中，其中，此消息包含网址：DataLayers 消息中的每个字符串都包含一个可从中提取相应 GeoTIFF 的网址。这些网址在生成的几个小时内有效。大多数 GeoTIFF 文件的分辨率为 0.1 百万像素/像素，但月通量文件的分辨率为 0.5 百万像素/像素，每小时阴影文件的分辨率为 1 百万像素/像素。如果在 GetDataLayersRequest 中指定了 pixelSizeMeters 值，则 GeoTIFF 文件中的最小分辨率将是该值。

JSON 表示法

JSON 表示法
{ "imageryDate": { object (`Date`) }, "imageryProcessedDate": { object (`Date`) }, "dsmUrl": string, "rgbUrl": string, "maskUrl": string, "annualFluxUrl": string, "monthlyFluxUrl": string, "hourlyShadeUrls": [ string ], "imageryQuality": enum (`ImageryQuality`) }

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

字段
`imageryDate`	`object (Date)` 此区域中的源图像（所有其他数据都来源于此）的时间。因为这些图像可能拍摄时间超过一天，所以显示的结果可能太接近了。
`imageryProcessedDate`	`object (Date)` 此图像的处理完成时间。
`dsmUrl`	`string` 地区 DSM（数字平台模型）的图片网址。值以高于 EGM96 大地水准（即海平面）的米为单位。无效位置（我们没有数据）存储为 -9999。
`rgbUrl`	`string` 地区的 RGB 数据图片（航拍照片）的网址。
`maskUrl`	`string` 建筑物遮罩图片的网址：每像素 1 位，指明该像素是否属于屋顶。
`annualFluxUrl`	`string` 地区年度通量地图（屋顶上的年度日照量）的网址。值为 kWh/kW/年。这是“未遮盖的通量”：计算每个位置的通量，而不仅仅是建筑物屋顶。无效位置存储为 -9999：覆盖区域内以外的位置无效，覆盖区域内无法计算通量的某些位置也将无效。
`monthlyFluxUrl`	`string` 地区的每月通量地图（屋顶上的日照，按月细分）的网址。值为 kWh/kW/年。此网址指向的 GeoTIFF 将按顺序包含 12 个频段，分别对应于 1 月到 12 月。
`hourlyShadeUrls[]`	`string` 十二个每小时阴影网址，分别对应 1 月...12 月（按顺序）。每个 GeoTIFF 将包含 24 个频段，分别对应一天中的 24 小时。每个像素都是一个 32 位的整数，最多对应当月的第 31 天；1 位表示相应位置能够在当月的那一天中看到太阳。无效位置被存储为 -9999（因为该值为负数，所以其设置了位 31，而任何有效值不能将位 31 设置为对应于当月 32 日的位 31）。下面的示例可能对您有所帮助。如果您想知道某个点（在像素位置 (x, y)）在 6 月 22 日下午 4 点是否看到了太阳，您需要：提取此列表中的第六个网址（对应于 6 月）。查找第 17 个频道（对应于下午 4 点）。读取 (x, y) 处的 32 位值。读取值的位 21（对应于本月的 22 号）。如果该位的值为 1，则表示该位置在 6 月 22 日下午 4 点看到太阳。更正式的一点是：给定 `month` (1-12)、`day`（最多 1...个月；2 月有 28 天）和 `hour` (0-23)，因此该月/日/小时的阴影/太阳位于 `(x, y)` 位置。 `(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))` 其中 `(x, y)` 表示空间索引编制，`[month - 1]` 表示提取第 `month - 1` 个网址（从零开始编入索引），`[hour]` 表示将频道编入索引，最终非零结果表示“sunny”。没有闰日，也不存在 DST（每一天都有 24 小时；中午始终是“标准时间”中午）。
`imageryQuality`	`enum (ImageryQuality)` 结果图像的质量。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

包含非零年份、月份和天值的完整日期。
月份和天，年份值为零（例如周年纪念日）。
单独的年份，月份和天值为零。
年份和月份，天值为零（例如，信用卡到期日期）。

JSON 表示法
{ "year": integer, "month": integer, "day": integer }

字段
`year`	`integer` 日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
`month`	`integer` 一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
`day`	`integer` 一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

ImageryQuality

用于计算某些 API 结果的图像的质量。

注意：无论图像质量级别如何，DSM 输出始终为 0.1 米/像素的分辨率，月通量输出的分辨率始终为 0.5 米/像素，每小时阴影输出的分辨率始终为 1 米/像素。

枚举
`IMAGERY_QUALITY_UNSPECIFIED`	质量未知。
`HIGH`	基础图像和 DSM 数据按 010 万像素/像素处理。
`MEDIUM`	基础图像和 DSM 数据按 025 万像素/像素处理。
`LOW`	基础图像和 DSM 数据按 0.50 万像素/像素处理。

方法
`get`	获取某个位置周围区域的太阳能信息。

REST Resource: dataLayers

资源：DataLayer

日期

ImageryQuality

方法

get

`get`