概觀
在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 配置的任何可查詢的項目,例如上一個範例中的 Gsd 和 Year,都會顯示為其他篩選選項。
您可以使用 [選取篩選 ] 控制項來切換可見的篩選。