通过

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

Microsoft Planetary Computer Pro 数据资源管理器自定义搜索筛选器的可查询项

概述

在Microsoft行星计算机专业版中， GeoCatalog 资源将数据集组织到 STAC 集合中。 每个时空资产目录（STAC）集合都包含一组 STAC 项，其中许多项都在他们的properties中包含元数据。

可查询对象 允许客户定义哪些元数据字段或 properties 应显示为自定义筛选器。 自定义筛选器可在数据浏览器中选择，允许在搜索时指定 properties 的值。

先决条件

什么是可查询项？

可查询项是 STAC 项元数据中的一个属性，在 Planetary Computer Data Explorer 界面中提升，易于搜索。 在‘浏览数据集’窗格中，单击‘高级’，可在‘自定义筛选器’下看到可查询对象。

例如，从 STAC 项中的此 properties 块：

"properties": {
  "gsd": 0.6,
  "datetime": "2022-09-23T16:00:00Z",
  "naip:year": "2022",
  ...
}

Gsd （地面样本距离;以米/像素为单位的空间分辨率）和 naip:year （获取图像的年份）是此集合中的可搜索属性。 因此，可以将其添加为自定义筛选器，以便在数据资源管理器中轻松搜索。 该 datetime 属性自动作为自定义筛选器包含在所有集合的数据资源管理器中。

从集合页配置可查询项

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

在此窗格中，导航到 “查询对象 ”选项卡。

在这里，可以添加可查询属性配置的列表。 每个条目必须包括：

  • "name" ：STAC 项 properties 字段中属性的名称。
  • "definition" ：一个 JSON 架构，用于定义属性的数据类型，还可以选择允许的值和显示标题。

示例配置：

[
  {
    "name": "gsd",
    "definition": {
      "type": "number"
    }
  },
  {
    "name": "naip:year",
    "definition": {
      "enum": [
        "2010",
        "2011",
        "2012",
        "2013",
        "2014",
        "2015",
        "2016",
        "2017",
        "2018",
        "2019",
        "2020",
        "2021",
        "2022",
        "2023",
        "2024",
        "2025"
      ],
      "type": "string",
      "title": "Year"
    }
  }
]

每个可查询的 "definition" 字段描述了 STAC 项属性的功能以及此属性在数据资源管理器中的显示方式。 它支持以下键：

  • "type" （必需）：
    属性的预期数据类型。 必须为以下其中之一：

    • "string"
    • "number"
    • "boolean"

  • "enum" （可选）：
    允许的值的列表。 如果提供，则枚举选项在数据资源管理器中显示为复选框，以便于选择。

  • "title" （可选）：
    筛选器的用户友好显示名称，如资源管理器中所示。 如果未指定标题，则默认情况下，可查询的名称将用作标题。

用户配置的可查询项显示在“高级搜索”界面下的资源管理器中。

选择 “高级 ”以显示 自定义筛选器。 默认情况下，可以使用以下筛选器：

  • 已获取（基于 datetime 范围）
  • 项目 ID

添加到集合的 Queryables 配置的任何可查询项（如上一示例中的 Gsd 和 Year ）显示为其他筛选器选项。

可以使用 “选择筛选器” 控件切换哪些筛选器可见。

相关内容