Configurações de mosaico para coleções no Microsoft Planetary Computer Pro

Dentro de cada coleção GeoCatalog STAC (SpatioTemporal Asset Catalog), um mosaico especifica os critérios de pesquisa usados para recuperar e visualizar itens STAC na interface da Web do Explorer. Por exemplo, um mosaico pode ser configurado para retornar apenas itens que são de um intervalo de datas especificado ou itens que têm menos de uma porcentagem específica de cobertura de nuvem. Um ou mais mosaicos são criados e gerenciados pelo usuário editando a configuração de mosaico para dentro de cada coleção STAC.

Prerequisites

Antes de configurar um mosaico, verifique se as seguintes etapas de pré-requisito estão concluídas:

  1. A coleção STAC existe: Você criou uma coleção STAC no Planetary Computer Pro.
  2. Dados ingeridos: Você adicionou itens STAC contendo os ativos de dados geoespaciais que deseja visualizar na coleção.

Componentes em um mosaico

A configuração de mosaico de uma coleção STAC é uma lista de objetos de mosaico individuais, cada um definindo um critério de pesquisa específico. Cada objeto de mosaico individual inclui as seguintes propriedades:

Property Tipo Description
id String Um identificador de texto exclusivo especificado pelo usuário para o mosaico. Este ID não deve conter espaços.
name String Um nome legível por humanos para o Mosaico. Esse nome aparecerá na interface do usuário do Explorer
description String Uma descrição útil do mosaico definida pelo usuário.
cql Array Uma expressão CQL2 (Common Query Language) que define parâmetros de pesquisa para itens STAC a serem encontrados e visualizados

Configurando mosaicos a partir da página 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 Mosaicos .

Captura de tela da interface da Web de configuração de mosaico exibindo opções para configurar configurações de mosaico.

As configurações de mosaico para uma coleção são visíveis como uma lista de objetos JSON, onde cada objeto representa uma configuração de mosaico nomeada.

Exemplo de configurações de mosaico usadas no Open Planetary Computer

De Sentinel-2 L2A Collection Ver no Computador Planetário

Uma configuração de mosaico com esses mosaicos da coleção Sentinel-2 L2A permitiria três maneiras diferentes de visualizar imagens do Sentinel-2 na interface do Explorer:

  • id: "most_recent": Itens STAC mais recentes (qualquer cobertura de nuvem),
  • id: "recent_low_cloud": Itens STAC mais recentes com baixa cobertura de nuvens (menor ou igual a 10%), e
  • id: "jun_aut2022_low_cloud": Itens STAC entre junho e agosto de 2022 com baixa cobertura de nuvens (menor ou igual a 10%).
[
  {
    "id": "most_recent",
    "name": "Most recent (any cloud cover)",
    "description": "",
    "cql": []
  },
  {
    "id": "recent_low_cloud",
    "name": "Most recent (low cloud)",
    "description": "Less than 10% cloud cover",
    "cql": [{"op":"<=",
            "args": [{"property": "eo:cloud_cover"}, 10]}]
  },
  {
    "id": "jun_aug2022_low_cloud",
    "name": "Jun - Aug, 2022 (low cloud)",
    "description": "",
    "cql": [{"op":"anyinteracts",
            "args": [ {"property": "datetime"},
                      {"interval": ["2022-06-01", "2022-08-31T23:59:59Z"]} ]},
            {"op": "<=",
            "args": [{"property": "eo:cloud_cover"}, 10]}]
  }
]

Visualização da coleta de camadas de dados de terras agrícolas do USDA no computador planetário

Cada coleção pode ter seu próprio conjunto de propriedades que podem ser usadas no cql para um critério de pesquisa específico. Essa configuração de mosaico especifica um mosaico com cql que filtra itens com base nas suas usda_cdl:type propriedades. Nesse caso, o mosaico especifica um filtro para dados iguais usda_cdl:type: a cropland. Por padrão, os itens retornados da pesquisa são classificados por recenticidade.

[
  {
    "id": "usda_cdl_cropland",
    "name": "Most recent cropland",
    "description": "Most recent cropland data",
    "cql": [{"op":"=",
          "args": [ {"property": "usda_cdl:type"}, "cropland"]}]
  }
]