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.

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. 

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.

👩‍🔧 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:

• (Spanish) https://www.snitcr.go.cr/ico_servicios_ogc
• (English) https://mrdata.usgs.gov/ 
• (English) https://www.gebco.net/data_and_products/gebco_web_services/web_map_service/
• (English) https://apps.nationalmap.gov/services/
• (Portuguese) https://inde.gov.br/CatalogoGeoservicos

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.

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.

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.

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’.

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!

🥽 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.

• Se a sua camada estiver aparecendo em branco na interface de coleta de dados, verifique primeiro a sua resolução. Algumas camadas WMS só serão visíveis em determinadas resoluções, e você poderá ter que dar um zoom para ver as imagens. Por exemplo, a camada do Mosaico5000 representada acima só é visível quando ampliada muitas vezes.
• Em seguida, verifique duas vezes o URL e o nome da camada para ver se há erros de digitação. 
• Certifique-se de que a sua camada está disponível na projeção correta. O CEO usa EPSG:3857. Nem todos os servidores fornecerão imagens nesta projeção. Nesse caso, terá de conferir com a equipe responsável pelo WMS/WMTS para que a mesma seja adicionada.
• Se isso não funcionar, um bom lugar para começar é certificar-se de que o seu servidor WMS está funcionando corretamente, encontrando um URL WMS para uma imagem de um dos seus “map tiles”. Se abrir este URL no seu navegador web, deverá ver essa imagem carregada com sucesso. Por exemplo,
  • http://geos0.snitcr.go.cr/cgi-bin/web?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap& FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=Mosaico5000&WIDTH=320& HEIGHT=320&CRS=EPSG%3A3857&STYLES=&FORMAT_OPTIONS=dpi%3A113& BBOX=-9275174.760236427%2C939258.2035682462%2C-9236039.001754416%2C978393.9620502564&map=ortofoto.map
  • https://geos1.snitcr.go.cr/Ortofoto2017/wms?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true& LAYERS=fotocentros_ortofoto_2017_5000&TILED=true&WIDTH=256&HEIGHT=256& SRS=EPSG%3A5367&gridSet=CRTM05&STYLES=& BBOX=348586.56637714803%2C738692.4676108168%2C912687.8695003731%2C1302793.770734042

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:

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.

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

• Em casos raros, o seu WMS pode estar exibindo as imagens, mas elas estão em branco. Encontrar o seu WMS URL pode ajudar neste caso, bem como explorar os metadados para o seu WMS/WMTS se houver uma opção “Preview Imagery”. E sugerimos dicas de leitura na função GetMap do WMS para o ajudar a interpretar estes erros, por exemplo:, https://geos0.snitcr.go.cr/cgibin/web?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true& MAP=ortofoto.map&LAYERS=Mosaico5000&WIDTH=256&HEIGHT=256&CRS=EPSG%3A3857&STYLES=& BBOX=-8453323.832114212%2C-156543.03392804042%2C-8296780.798186171%2C5.529727786779404e-10.  Isto permite você saber que o CEO e o WMS estão ligados, mas pode haver outro problema. Neste caso, não foi dado o zoom necessário no mapa para que o WMS fornecesse imagens.
• Se sua camada ainda estiver em branco, visite o painel do seu navegador e examine as mensagens de erro. Elas podem esclarecer o que está causando o problema.

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!