Partilhar via

Consultáveis 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 do SpatioTemporal Asset Catalog (STAC) contém um conjunto de itens STAC, e muitos desses itens têm metadados em seus properties.

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

Pré-requisitos

O que é um Queryable?

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

Por exemplo, a partir deste properties bloco em um item STAC:

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

Gsd (distância da amostra do 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. Eles podem, portanto, 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 Queryables a partir da Página de Coleção

Na página de destino 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 Consultáveis .

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

  • "name" : o nome da propriedade no campo do properties 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"
    }
  }
]

Cada campo consultável "definition" descreve os recursos da propriedade de item STAC e como essa propriedade é exibida no Data Explorer. Ele suporta as seguintes chaves:

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

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

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

  • "title" (facultativo):
    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 consultável será usado como 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 na datetime gama)
  • Item ID

Todos os consultáveis adicionados à configuração 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

  • Last updated on