你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft Planetary Computer Pro 中用于集合的马赛克配置

2025-05-20

对于任何 STAC（时空资产目录）集合，都可以定义多个马赛克的配置。每个 马赛克 指定在资源管理器 Web 界面中返回和可视化 STAC 项的搜索条件。例如，可以配置马赛克，使其仅返回来自指定日期范围的项目，或返回云量覆盖低于特定百分比的项目。

马赛克中的组件

STAC 集合的马赛克配置是单个特定搜索条件的列表，每个搜索条件称为马赛克。每个单独的马赛克包括：

id：马赛克的唯一标识符
name：易于理解的标题
description：有关马赛克的信息
cql：一个 CQL2 （公共查询语言）表达式，用于定义要查找和可视化的 STAC 项的搜索参数

从集合页配置马赛克

在集合的登陆页上，选择 “配置 ”按钮以打开 “编辑集合配置 ”窗格。

在此窗格中，导航到 “马赛克” 选项卡。

列出单个马赛克以创建马赛克配置。从搜索返回的所有项都进行排序，以便最先显示最近的项。因此，未指定 datetime 范围的马赛克最好命名为“最新”。

开放行星计算机中使用的马赛克配置示例

来自 Sentinel-2 L2A 集合（在行星计算机上查看）

通过对 Sentinel-2 L2A 数据集的这些马赛克进行配置，可以在 Explorer 界面中以三种不同方式可视化 Sentinel-2 图像：1。最新的搜索结果数（任何云覆盖）和 2。最新的搜索结果数（包含较低的云覆盖）和 3。 2022 年 6 月至8 月低云覆盖的搜索结果。

[
  {
    "id": "most_recent",
    "name": "Most recent (any cloud cover)",
    "description": "",
    "cql": []
  },
  {
    "id": "recent_low_cloud",
    "name": "Most recent (low cloud)",
    "description": "Less than 10% cloud cover",
    "cql": [{"op":"<=",
            "args": [{"property": "eo:cloud_cover"}, 10]}]
  },
  {
    "id": "jun_aug2022_low_cloud",
    "name": "Jun - Aug, 2022 (low cloud)",
    "description": "",
    "cql": [{"op":"anyinteracts",
            "args": [ {"property": "datetime"},
                      {"interval": ["2022-06-01", "2022-08-31T23:59:59Z"]} ]},
            {"op": "<=",
            "args": [{"property": "eo:cloud_cover"}, 10]}]
  }
]

USDA 农田数据层集合（在行星计算机上查看）

每个集合可能都有自己的一组属性，这些属性可用于 cql 特定搜索条件。此马赛克配置具有一个带 cql 的马赛克，它基于项的 usda_cdl 属性选择项。在这种情况下，马赛克为农田数据指定搜索筛选。默认情况下，从搜索返回的项按一致性排序。

[
  {
    "id": "usda_cdl_cropland",
    "name": "Most recent cropland",
    "description": "Most recent cropland data",
    "cql": [{"op":"=",
          "args": [ {"property": "usda_cdl:type"}, "cropland"]}]
  }
]