Compartilhar via

Elementos de consulta para filtros de pesquisa personalizados do Microsoft Planetary Computer Pro Data Explorer

Visão geral

No Microsoft Planetary Computer Pro, um recurso GeoCatalog organiza conjuntos de dados em coleções STAC. Cada coleção STAC (SpatioTemporal Asset Catalog) contém um conjunto de itens STAC e muitos desses itens têm metadados em seus properties.

Queryables permitem que os clientes definam quais campos de metadados ou properties devem ser exibidos como filtros personalizados. Os filtros personalizados podem ser selecionados no Data Explorer e permitem especificar properties valores durante a pesquisa.

Pré-requisitos

O que é um Queryable?

Um objeto consultável é uma propriedade dos metadados do item STAC que é promovida na interface do Planetary Computer Data Explorer para ser facilmente pesquisável. Queryables aparecem em 'Filtros personalizados', que podem ser acessados clicando em 'Avançado' no painel 'Explorar conjuntos de dados'.

Por exemplo, desse bloco de properties em um item STAC:

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

Gsd (distância de exemplo de solo; a resolução espacial medida em metros/pixel) e naip:year (o ano em que a imagem foi adquirida) são propriedades pesquisáveis nesta coleção. Portanto, eles podem ser adicionados como filtros personalizados para facilitar a pesquisa no Data Explorer. A datetime propriedade é incluída automaticamente como um filtro personalizado no Data Explorer para todas as coleções.

Configurando consultas na página de coleção

Na página de aterrissagem de uma coleção, selecione o botão Configuração para abrir o painel Editar Configuração da Coleção .

Dentro deste painel, navegue até a guia Queryables.

Aqui, você pode adicionar uma lista de configurações de propriedade consultáveis. Cada entrada deve incluir:

  • "name" : o nome da propriedade no campo properties do item STAC.
  • "definition" : um esquema JSON que define o tipo de dados da propriedade e, opcionalmente, os valores permitidos e o título de exibição.

Exemplo de configuração:

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

O campo "definition" de cada consulta descreve os recursos da propriedade do item STAC e como essa propriedade é exibida no Data Explorer. Ele dá suporte às seguintes chaves:

  • "type" (obrigatório):
    O tipo de dados esperado da propriedade. Deve ser um dos seguintes:

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

  • "enum" (opcional):
    Uma lista de valores permitidos. Se fornecidas, as opções enumeradas aparecerão como caixas de seleção no Data Explorer para facilitar a seleção.

  • "title" (opcional):
    Um nome de exibição amigável para o filtro, conforme mostrado no Explorer. Se um título não for especificado, por padrão, o nome do queryable será usado como o título.

Os Queryables configurados pelo usuário aparecem no Explorer na interface de pesquisa Avançada.

Selecione Avançado para revelar filtros personalizados. Por padrão, os seguintes filtros estão disponíveis:

  • Adquirido (com base no datetime intervalo)
  • Item ID

Todos os queryables adicionados à configuração de Queryables da coleção, como Gsd e Year no exemplo anterior, aparecem como outras opções de filtro.

Você pode alternar quais filtros estão visíveis usando o controle Selecionar filtros .

Conteúdo relacionado