此页面由 Cloud Translation API 翻译。

REST Resource: dataLayers

资源：DataLayers
- JSON 表示法
Date
- JSON 表示法
ImageryQuality
方法

资源：DataLayers

关于某个区域的太阳能发电潜力的信息。实际数据包含在多个涵盖所请求区域的 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` 建筑物蒙版图片的网址：每个像素一个位，表示该像素是否属于屋顶的一部分。
`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，因为位 31 对应于当月的第 32 天）。示例可能对您有所帮助。如果您想知道某个点（像素位置 (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]` 表示在频道中编入索引，而最终的非零结果表示“晴”。没有闰日，DST 不存在（所有日期均为 24 小时；中午始终为“标准时间”中午）。
`imageryQuality`	`enum (ImageryQuality)` 搜索结果图像的质量。

日期

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

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

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 数据以 0.1 米/像素处理。
`MEDIUM`	底层图像和 DSM 数据以 0.25 米/像素处理。
`LOW`	底层图像和 DSM 数据以 0.5 米/像素进行处理。

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

REST Resource: dataLayers

资源：DataLayers

日期

ImageryQuality

方法

get

`get`