Queryables für benutzerdefinierte Suchfilter für Microsoft Planetary Computer Pro Data Explorer

Überblick

Im Microsoft Planetary Computer Pro organisiert eine GeoCatalog-Ressource Datasets in STAC-Sammlungen. Jede SpatioTemporal Asset Catalog (STAC)-Auflistung enthält eine Reihe von STAC-Elementen, und viele dieser Elemente enthalten Metadaten in ihren properties.

Mit Abfragefunktionen können Kunden definieren, welche Metadatenfelder properties oder als benutzerdefinierte Filter angezeigt werden sollen. Benutzerdefinierte Filter können im Daten-Explorer ausgewählt werden und ermöglichen die Angabe von Werten für properties während der Suche.

Voraussetzungen

Was ist ein Queryable?

Ein Queryable ist eine Eigenschaft aus den STAC-Elementmetadaten, die in der Planetary Computer Data Explorer-Schnittstelle höhergestuft wird, um leicht durchsuchbar zu sein. Abfrageobjekte erscheinen unter "Benutzerdefinierte Filter", die durch Klicken auf "Erweitert" im Bereich "Datenexploration" zugänglich sind.

Zum Beispiel aus diesem properties-Block in einem STAC-Element:

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

Gsd (Bodenprobenabstand; die räumliche Auflösung in Metern/Pixel) und naip:year (das Jahr, in dem das Bild erworben wurde) sind durchsuchbare Eigenschaften in dieser Sammlung. Sie können daher als benutzerdefinierte Filter hinzugefügt werden, um die Suche im Daten-Explorer zu vereinfachen. Die datetime Eigenschaft wird automatisch als benutzerdefinierter Filter im Daten-Explorer für alle Auflistungen eingeschlossen.

Konfigurieren von Queryables auf der Sammlungsseite

Wählen Sie auf der Startseite einer Sammlung die Schaltfläche "Konfiguration " aus, um den Bereich "Sammlungskonfiguration bearbeiten " zu öffnen.

Navigieren Sie in diesem Bereich zur Registerkarte " Abfragewerte ".

Hier können Sie eine Liste der abfragefähigen Eigenschaftenkonfigurationen hinzufügen. Jeder Eintrag muss Folgendes enthalten:

  • "name" : der Name der Eigenschaft im Feld des properties STAC-Elements.
  • "definition" : ein JSON-Schema, das den Datentyp der Eigenschaft definiert, und optional zulässige Werte und Anzeigetitel.

Beispielkonfiguration:

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

In jedem abfragefähigen "definition" Feld werden die Features der STAC-Elementeigenschaft und die Anzeige dieser Eigenschaft im Daten-Explorer beschrieben. Sie unterstützt die folgenden Schlüssel:

  • "type" (erforderlich):
    Der erwartete Datentyp der Eigenschaft. Muss eine der folgenden Sein:

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

  • "enum" (optional):
    Eine Liste der zulässigen Werte. Wenn angegeben, werden die aufgezählten Optionen als Kontrollkästchen im Daten-Explorer angezeigt, um die Auswahl zu erleichtern.

  • "title" (optional):
    Ein benutzerfreundlicher Anzeigename für den Filter, wie im Explorer gezeigt. Wenn kein Titel angegeben ist, wird der Name der Abfrage standardmäßig als Titel verwendet.

Vom Benutzer konfigurierte Abfragefunktionen werden im Explorer unter der Erweiterten Suchoberfläche angezeigt.

Wählen Sie "Erweitert" aus, um benutzerdefinierte Filter anzuzeigen. Standardmäßig sind die folgenden Filter verfügbar:

  • Erworben (basierend auf dem datetime-Bereich)
  • Element-ID

Alle Abfrageablen, die der Abfrageables-Konfiguration der Auflistung hinzugefügt wurden, z. B. Gsd und Year im vorherigen Beispiel, werden als andere Filteroptionen angezeigt.

Sie können mithilfe des Steuerelements "Filter auswählen " umschalten, welche Filter sichtbar sind.

Verwandte Inhalte

  • Last updated on