共用方式為


Microsoft Planetary Computer 專業數據探勘自定義搜尋篩選的可查詢項目

概觀

在Microsoft行星計算機專業版中, GeoCatalog 資源會將數據集組織成 STAC 集合。 每個 SpatioTemporal 資產目錄(STAC 集合)都包含一組 STAC 專案,這些專案中許多都在其 properties 中有元數據。

可查詢 允許客戶定義哪些元數據欄位或properties應該顯示為自訂篩選器。 自定義篩選條件可在 [數據總管] 中選取,並允許在搜尋期間為 properties 指定值。

先決條件

什麼是查詢物件?

可查詢屬性是 STAC 條目元數據中的屬性,會在行星計算機數據探索者介面中突出顯示,以便輕鬆搜尋。 可查詢專案 會出現在 [自定義篩選] 底下,按兩下 [探索資料集] 窗格中的 [進階] 即可存取。

例如,從 STAC 專案中的這個 properties 區塊:

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

Gsd (地面樣本距離;以公尺/像素測量的空間解析度)和 naip:year (取得影像的年份)是這個集合中可搜尋的屬性。 因此,它們可以新增為自定義篩選條件,以方便在 [數據總管] 中搜尋。 屬性 datetime 會自動包含在所有集合的數據總管中做為自定義篩選。

從集合頁面配置 Queryables

在集合的登陸頁面上,選取 [ 組態 ] 按鈕以開啟 [ 編輯集合組態 ] 窗格。

在此窗格中,流覽至 [ 查詢] 索引標籤

您可以在這裏新增可查詢的屬性組態清單。 每個項目都必須包含:

  • "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" (選擇性):
    篩選器在 Explorer 中顯示的使用者友好的名稱。 如果未指定標題,則預設會使用可查詢的名稱作為標題。

用戶設定的 [查詢] 會出現在 [進階] 搜尋介面下的 [管] 中。

選取 [進階 ] 以顯示 [自定義篩選]。 根據預設,有下列篩選可供使用:

  • 已取得 (根據 datetime 範圍)
  • 項目標識碼

新增至集合的 Queryables 配置的任何可查詢的項目,例如上一個範例中的 GsdYear,都會顯示為其他篩選選項。

您可以使用 [選取篩選 ] 控制項來切換可見的篩選。