Utilizando os seus próprios dados no CEO: Conectando WMS/WMTS [português]

Utilizando os seus próprios dados no CEO: Conectando WMS/WMTS [português]

Ouvimos frequentemente dos usuários que gostariam de acrescentar dados próprios aos seus projetos no Collect Earth Online (CEO). Felizmente, o CEO fornece duas formas fáceis de adicionar as suas próprias imagens aos projetos. A primeira é conectando as suas próprias imagens via Web Map Service (WMS) ou Web Map Tile Service (WMTS), e a segunda é conectando suas imagens através do Google Earth Engine (GEE). Neste blog, vamos focar na conexão das fontes de dados WMS/WMTS ao CEO.

Agradecemos ao SERVIR-Amazonia pelo suporte na tradução dessa publicação.

🤝 Conectando seu WMS/WMTS ao CEO

WMS e WMTS fornecem especificações para que servidores de mapas georreferenciados possam disponibilizá-los através da Internet. Muitos conjuntos de dados nacionais estão disponíveis através deste protocolo.

Você pode estar familiarizado com a utilização de imagens WMS ou WMTS em aplicativos na área de trabalho como ArcGIS ou QGIS. Tal como estes aplicativos na área de trabalho, o CEO pode exibir imagens WMS e WMTS através da função de imagens institucionais.

The Institutional Imagery addition form for WMS Imagery.
O formulário de adição de Imagens Institucionais para WMS Imagery.


O primeiro passo para se conectar ao seu WMS/WMTS com o CEO é verificar se o seu WMS/WMTS é compatível com o CEO. O CEO exige dados no EPSG:3857. O seu servidor WMS/WMTS é responsável por reproduzir as imagens que hospeda nesta projeção. Felizmente, a maioria do WMS/WMTS já disponibiliza camadas nessa projeção automaticamente. Uma vez carregados os seus dados, você pode sempre verificar por uma análise visual se os dados estão de acordo com um padrão de imagens consideradas boas, tais como MapBox.

Para conectar seu WMS/WMTS ao CEO, é necessário reunir três informações: o URL base para o seu WMS/WMTS, o nome da camada que deseja, e quaisquer parâmetros que o seu WMS/WMTS necessite para exibir imagens. Se precisar de ajuda para encontrar essas informações, há mais detalhes fornecidos na seção seguinte.

Os passos básicos para conectar suas imagens WMS ou WMTS são:

  • Vá ao botão “Imagery” no topo da sua instituição CEO, e clique em “Add New Imagery” (Adicionar novas imagens).
  • Selecione “WMS Imagery” em “Select Type”.
  • Adicione um título, que será o nome apresentado da imagem.
  • Adicione a atribuição, que atribui crédito ao grupo que recolheu ou é proprietário das imagens. Esta atribuição aparecerá no painel de recolha de dados enquanto os usuários executam a coleta de dados.
  • Adicione o URL, que deve ser o http:// ou https:// URL do seu WMS/WMTS, que não tenha um query string (sequência de consulta).
  • Adicione o nome da camada que pretende exibir do seu servidor.
  • Adicione quaisquer parâmetros para o seu layer exigidos pelo WMS/WMTS.
  • E finalmente, se precisar usar um proxy para o seu WMS/WMTS, marque a caixa de Proxy Imagery. Será necessário usar esta opção se precisar ofuscar uma chave para o seu WMS ou WMTS, e utilizar um proxy-um servidor entre o CEO e o seu WMS/WMTS-para o fazê-lo.
Filled in WMS imagery form for GEBCO data.
Preenchido em forma de imagens WMS para dados GEBCO.


Uma vez adicionada a camada do WMS/WMTS na Instituição, os usuários podem adicioná-la a qualquer um dos seus projetos e aproveitar as imagens durante a coleta de dados.

An example WMS image from GEBCO viewed in the CEO data collection screen.
Um exemplo de imagem WMS da GEBCO vista no painel de coleta de dados do CEO.

👩‍🔧 Localizando informações para conexões WMS/WMTS

Entretanto, às vezes os usuários têm dificuldade em identificar o URL correto, nome da camada e parâmetros utilizados. Aqui estão algumas dicas que recomendamos para o ajudar a encontrar esta informação.

Primeiro, encontre a página de informação no seu WMS/WMTS. Estes websites conterão frequentemente a informação necessária para conectar seu WMS/WMTS ao CEO. Às vezes, a sua fonte de dados desejada terá uma página de informação mais complexa, com informações sobre os dados e depois conexões a múltiplos WMS/WMTS. Alguns exemplos incluem:

Ao olhar para estas informações, o primeiro passo é localizar o URL do WMS. Por exemplo, https://geos1.snitcr.go.cr/Ortofoto2017/wms?VERSION=1.1.1.

É muito importante notar que tudo depois do “?” no seu URL do WMS/WMTS é um parâmetro. Ao adicioná-lo ao CEO, ele não deve ser considerado como parte do URL. No entanto, você deverá incluir o “?” quando adicionar o seu URL ao CEO–mas não se preocupe, iremos adicioná-lo automaticamente se você esquecer!

A segunda informação que precisa procurar são os nomes de camadas disponíveis. A página de informação conterá frequentemente uma lista de camadas que podem ser visualizadas com o WMS/WMTS. Note que, às vezes, a sua camada pode ter vários nomes, por isso, através do site que disponibiliza as camadas WMS/WMTS, você deve se certificar que está visualizando o nome correto.

You may need to view the layer’s metadata through the online portal in order to find the correct WMS/WMTS layer name.
Talvez seja necessário visualizar os metadados da camada através do portal online para encontrar o nome correto da camada WMS/WMTS.


Você também pode conectar o WMS/WMTS a um aplicativo na área de trabalho como ArcGIS ou QGIS e acessar os nomes das camadas através da aplicativo na área de trabalho.

The GEBCO WMS connection and its layers connected to QGIS.
A Conexão GEBCO WMS e as suas camadas ligadas ao QGIS.


Você pode então inspecionar as propriedades da camada a fim de encontrar a informação necessária para conectar a camada WMS/WMTS ao CEO.

Layer properties of the GEBCO_2020_Grid_3 layer as displayed in QGIS.
Propriedades de camadas da camada GEBCO_2020_Grid_3, tal como apresentado no QGIS.


Se não conseguir carregar dados na sua área de trabalho SIG, e o seu WMS/WMTS utiliza apenas um ficheiro XML que não tem qualquer informação de estilo associada a ele, ainda pode encontrar o nome da camada, mas é mais difícil. Neste caso, a informação encontra-se numa árvore de documentos difícil de ler. Se for este o caso, e não conseguir carregar os dados para uma área de trabalho SIG, procure por “Camada” (“Layer”) e procure as informações que estão logo após os textos <Camada> com <Nome>, <Título> e <Abstract> nos campos de informação. O texto seguido do <Nome> será o que procura. Neste exemplo, o nome é ‘GEBCO_2020_Grid_3’.

An example of a layer for a WMS server that does not include XML styling, so you must look at the document tree.
Um exemplo de uma camada para um servidor WMS que não inclui o estilo XML, por isso é necessário olhar para a árvore de documentos.


O último passo é identificar os parâmetros. Nos nossos URLs, tudo depois do “?” é um parâmetro, separado pelo caracter “&”. Características comuns que poderá ver nos URLs incluem:

  • SERVICE=WMS
  • version=1.1.1 (ou outro número de versão)
  • request=GetCapabilities

Não queremos incluir nenhum destes três nos nossos parâmetros CEO. Isto porque:

  • “Service=WMS” é gerido automaticamente pelo CEO,
  • “version=1.1.1” ou outra versão é igualmente gerida, e
  • “request=GetCapabilities” é um pedido ao servidor WMS para fornecer uma lista de capacidades (por exemplo, nomes de camadas), não os próprios mapas.

Outros parâmetros podem ser necessários. Por exemplo, alguns WMS/WMTS têm um parâmetro “mapa” que é necessário. Outros parâmetros que podem ser visualizados incluem “crs” (geralmente não necessário), “formato” (geralmente também não necessário). Sugerimos a leitura de recursos adicionais na função GetMap do WMS para o ajudar a identificar quaisquer parâmetros adicionais que o seu WMS necessite para exibir imagens.

Se você carregar o seu WMS num SIG do computador, pode acessar a “Layer Properties” para o ajudar a encontrar as propriedades apropriadas a serem incluídas.

Agora que temos as informações cruciais, podemos conectar o WMS ao CEO.

  • Em CEO, navegue para a sua página de Imagens Institucionais.
  • Crie uma nova camada de imagens do tipo WMS Imagery.
  • Para Título, adicione o seu nome desejado. Este pode ser o nome da camada WMS, o nome WMS, alguma combinação destes, etc.
  • Adicione a Atribuição para as suas imagens.
  • Escreva o seu URL WMS (apenas a parte antes do “?”) que identificou acima.
  • Escreva o nome da camada WMS.
  • Digite os seus Parâmetros WMS adicionais. Estes precisam de ser escritos como um objeto JSON.
    • Por exemplo, “map=ortofoto.map” (um parâmetro único exigido por um WMS específico)
    • Torna-se {“MAP”: “ortofoto.map”}. Obs: aspas retas são utilizadas “”.
    • Se não tiver nenhum parâmetro, digite {}.
  • Verifique duas vezes se introduziu todas as informações corretamente e clique em Salvar!
Completed WMS Imagery form for a WMS where an additional WMS Parameter is needed.
Formulário completo de imagens WMS para um WMS onde é necessário um parâmetro adicional.
The imagery in the Data Collection interface.
As imagens na interface de coleta de dados.

💥 Outras abordagens para solução de problemas

Se ainda tiver problemas após tentar estes passos , aqui estão algumas dicas adicionais para solução de problemas.

Note que este servidor requer SRS em vez de CRS. Ambos são compatíveis com OGC. Enquanto estiver criando o URL do WMS funcional, poderá receber o seguinte erro:

400 no SRS error.

A sua construção pode ser difícil. Uma das melhores formas de as construir é utilizar o painel do seu navegador ou ferramentas de desenvolvimento, olhando para o painel “Rede”. Quando visitar o seu projeto em CEO e tentar carregar os dados, estes devem ser preenchidos com vários pedidos para as diferentes imagens do mapa. Pode clicar duas vezes sobre elas para visualizar uma imagem individual. Se isto não funcionar, pode tentar adicionar ou alterar o URL até aparecer uma imagem.

Use your browsers’ console or developer tools to try to get a list of the individual images.

Clicando em um destes, (ex. https://www.gebco.net/data_and_products/gebco_web_services/2020/mapserv?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true& LAYERS=GEBCO_2020_Grid_3&WIDTH=256&HEIGHT=256&CRS=EPSG%3A3857&STYLES=& BBOX=-8766409.899970295%2C-313086.06785608083%2C-8609866.866042254%2C-156543.03392803986) tentará mostrar uma única imagem.

Se você não configurou corretamente o WMS, ao clicar num destes pedidos aparecerá uma mensagem de erro. Por exemplo, aqui está um exemplo de erro:

<?xml version=’1.0′ encoding=”ISO-8859-1″ standalone=”no” ?>
<!DOCTYPE ServiceExceptionReport SYSTEM “http://schemas.opengis.net/wms/1.1.1/exception_1_1_1.dtd”>
<ServiceExceptionReport version=”1.1.1″>
<ServiceException code=”MissingParameterValue”>
msWMSLoadGetMapParams(): WMS server error. Missing required parameter SRS
</ServiceException>
</ServiceExceptionReport>

Para este WMS, a eliminação do parâmetro versão=1.1.1 resolveu o problema de configuração.

Sugerimos dicas de leitura sobre a função GetMap do WMS para o ajudar a interpretar estes erros, por exemplo: http://opengeospatial.github.io/e-learning/wms/text/operations.html#getmap.

O CEO gostaria de agradecer seus financiadores atuais FAO, NASA–USAID SERVIR, e SilvaCarbon, um programa do governo dos EUA. Agradecemos também aos parceiros tecnológicos do CEO: Norway’s International Climate & Forests Initiative por financiar a disponibilidade de dados em alta resolução; Planet por fornecer imagens de alta resolução; e a equipe do Google Earth Engine por criar uma plataforma para dados e análises geospaciais.

A Collect Earth Online trabalha constantemente para melhorar a experiência do usuário e o seu feedback é inestimável. Se tiver ideias para compartilhar, por favor escreva para support@collect.earth.

Obrigado!