Dela via

Frågefunktioner för anpassade sökfilter för Microsoft Planetary Computer Pro Data Explorer

Översikt

I Microsoft Planetary Computer Pro organiserar en GeoCatalog-resurs datauppsättningar i STAC-samlingar. Varje STAC-samling (SpatioTemporal Asset Catalog) innehåller en uppsättning STAC-objekt, och många av dessa objekt har metadata i .properties

Queryables gör det möjligt för kunder att definiera vilka metadatafält eller properties som ska visas som anpassade filter. Anpassade filter kan väljas i Datautforskaren och aktivera att ange värden för properties under sökningen.

Förutsättningar

Vad är ett frågorbart objekt?

En sökbar egenskap är en egenskap från STAC-objektmetadata som framhävs i Planetary Computer Data Explorer-gränssnittet för att bli lätt att söka efter. Frågefunktioner visas under Anpassade filter, som är tillgängliga genom att klicka på Avancerat i fönstret Utforska datamängder.

Till exempel från det här properties blocket i ett STAC-objekt:

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

Gsd (markexempelavstånd, den rumsliga upplösningen som mäts i meter/pixel) och naip:year (året då bilden förvärvades) är sökbara egenskaper i den här samlingen. De kan därför läggas till som anpassade filter för enkel sökning i Datautforskaren. Egenskapen datetime inkluderas automatiskt som ett anpassat filter i Datautforskaren för alla samlingar.

Konfigurera frågebara objekt från samlingssidan

På en samlings landningssida väljer du knappen Konfiguration för att öppna fönstret Redigera samlingskonfiguration .

Gå till fliken Frågebara objekt i det här fönstret.

Här kan du lägga till en lista över frågebara egenskapskonfigurationer. Varje post måste innehålla:

  • "name" : namnet på egenskapen i STAC-objektets properties fält.
  • "definition" : ett JSON-schema som definierar egenskapens datatyp och, om du vill, tillåtna värden och visningsrubrik.

Exempelkonfiguration:

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

Varje frågefält "definition" beskriver funktionerna i STAC-objektegenskapen och hur den här egenskapen visas i Datautforskaren. Den stöder följande nycklar:

  • "type" (krävs):
    Den förväntade datatypen för egenskapen. Måste vara något av:

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

  • "enum" (valfritt):
    En lista över tillåtna värden. Om det anges visas de uppräknade alternativen som kryssrutor i Datautforskaren för enklare markering.

  • "title" (valfritt):
    Ett användarvänligt visningsnamn för filtret som visas i Utforskaren. Om en rubrik inte har angetts används som standard namnet på den frågebara filen som rubrik.

Användarkonfigurerade Frågeobjekt visas i Utforskaren under gränssnittet Avancerad sökning.

Välj Avancerat för att visa anpassade filter. Som standard är följande filter tillgängliga:

  • Förvärvad (baserat på datetime intervallet)
  • Objekt-ID

Alla frågebara objekt som har lagts till i samlingens queryables-konfiguration, till exempel Gsd och Year i föregående exempel, visas som andra filteralternativ.

Du kan växla vilka filter som visas med hjälp av kontrollen Välj filter .

Relaterat innehåll