Condividi tramite

Queryables per i filtri di ricerca personalizzati di Microsoft Planetary Computer Pro Data Explorer

Informazioni generali

In Microsoft Planetary Computer Pro, una risorsa GeoCatalog organizza i set di dati in raccolte STAC. Ogni raccolta SPAtioTemporal Asset Catalog (STAC) contiene un set di elementi STAC e molti di questi elementi hanno metadati nel relativo properties.

Le queryable consentono ai clienti di definire quali campi di metadati o properties devono essere visualizzati come filtri personalizzati. I filtri personalizzati sono selezionabili in Esplora dati e consentono di specificare i valori per properties durante la ricerca.

Prerequisiti

Che cos'è un Queryable?

Una queryable è una proprietà dei metadati dell'elemento STAC promossa nell'interfaccia di Planetary Computer Data Explorer per essere facilmente ricercabile. Le queryables vengono visualizzate in "Filtri personalizzati", accessibili facendo clic su "Avanzate" nel riquadro "Esplora set di dati".

Ad esempio, da questo properties blocco in un elemento STAC:

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

Gsd (distanza del campione di terra; la risoluzione spaziale misurata in metri/pixel) e naip:year (l'anno in cui è stata acquisita l'immagine) sono proprietà ricercabili in questa raccolta. Possono quindi essere aggiunti come filtri personalizzati per facilitare la ricerca in Esplora dati. La datetime proprietà viene inclusa automaticamente come filtro personalizzato in Esplora dati per tutte le raccolte.

Configurazione di Queryables dalla pagina Raccolta

Nella pagina di destinazione di una raccolta selezionare il pulsante Configurazione per aprire il riquadro Modifica configurazione raccolta .

All'interno di questo riquadro, passare alla scheda Queryables.

Qui, è possibile aggiungere un elenco di configurazioni di proprietà interrogabili. Ogni voce deve includere:

  • "name" : nome della proprietà nel campo dell'elemento properties STAC.
  • "definition" : uno schema JSON che definisce il tipo di dati della proprietà e, facoltativamente, i valori consentiti e il titolo visualizzato.

Configurazione di esempio:

[
  {
    "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"
    }
  }
]

Ogni campo di "definition" queryable descrive le funzionalità della proprietà dell'elemento STAC e il modo in cui questa proprietà viene visualizzata in Esplora dati. Supporta le chiavi seguenti:

  • "type" (obbligatorio):
    Tipo di dati previsto della proprietà. Deve essere uno dei seguenti:

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

  • "enum" (facoltativo):
    Elenco di valori consentiti. Se specificato, le opzioni enumerate vengono visualizzate come caselle di controllo in Esplora dati per semplificare la selezione.

  • "title" (facoltativo):
    Nome visualizzato intuitivo per il filtro, così come appare in Esplora file. Se non viene specificato un titolo, per impostazione predefinita, il nome dell'oggetto queryable viene usato come titolo.

Gli oggetti Queryable configurati dall'utente vengono visualizzati in Esplora risorse nell'interfaccia di ricerca avanzata .

Selezionare Avanzate per visualizzare filtri personalizzati. Per impostazione predefinita, sono disponibili i filtri seguenti:

  • Acquisito (basato sull'intervallo datetime)
  • ID elemento

Tutte le queryable aggiunte alla configurazione Queryables della raccolta, ad esempio Gsd e Year nell'esempio precedente, vengono visualizzate come altre opzioni di filtro.

È possibile attivare/disattivare i filtri visibili usando il controllo Seleziona filtri .

Contenuti correlati