Você está lendo a documentação do Icon Map Pro para a versão 1.1.0.11, que ainda não foi lançada. Ir para a versão mais recente (1.1.0.10).

Tiles raster, WMTS e WMS

As camadas raster desenham imagens de um mapa sobre o mapa base: imagens aéreas, uma planta digitalizada, um modelo de inundação, um serviço de mapa publicado. Use uma camada raster para um modelo de tiles, um serviço WMTS ou um Cloud Optimized GeoTIFF, e uma camada WMS para um Web Map Service. Você pode ter até cinco de cada.

Uma camada de tiles de imagens aéreas desenhada semitransparente sobre o mapa base, com círculos dos dados do relatório por cima
Uma camada de tiles raster por baixo dos dados do relatório

Qual usar

Você tem Use Aparência
Um modelo de tiles Camada raster https://tile.example.com/{z}/{x}/{y}.png
Um serviço WMTS Camada raster O link GetCapabilities do serviço
Um arquivo GeoTIFF em um servidor web Camada raster, com GeoTIFF otimizado para nuvem (COG) ativada Um link terminado em .tif ou .tiff
Um serviço WMS Camada WMS https://example.com/geoserver/wms

Todos os links devem começar com https://.

Adicionar uma camada raster

  1. No painel Formato, abra o cartão Gestor de camadas e ative Abrir o Gestor de camadas.
  2. Selecione Adicionar uma camada, depois Camada de referência e depois o bloco Mosaicos e imagens.
  3. Cole um modelo de tiles, um link GetCapabilities de WMTS ou um link de GeoTIFF e selecione Verificar.
  4. Leia o resultado. Um modelo de tiles é testado carregando um tile. Um link WMTS mostra a camada que será desenhada. Um link de GeoTIFF é reconhecido pela extensão do arquivo.
  5. Defina a transparência em Estilo e opções, selecione Adicionar ao mapa e depois Aplicar alterações.
O assistente Mosaicos e imagens do Gestor de camadas depois de verificar um link WMTS, indicando a camada que será desenhada
A verificação do link lê um serviço WMTS e indica a camada que ele vai desenhar

Em alguns servidores de tiles, a verificação não consegue ler o tile de teste, embora o mapa consiga desenhar a camada. O assistente informa isso e permite adicionar a camada mesmo assim.

Para fazer o mesmo no painel Formato:

  1. Abra Camadas de referência > Seleção de camadas e ative Camada raster / WMTS.
  2. Em Raster / WMTS - Configuração, cole o link em Modelo de mosaicos ou ligação WMTS.
  3. Para um link de GeoTIFF, ative GeoTIFF otimizado para nuvem (COG).

Serviços WMTS

Cole o link GetCapabilities do serviço. O mapa lê as capacidades e desenha os tiles do serviço no esquema de tiles Web Mercator (GoogleMapsCompatible, EPSG:3857). Uma nota abaixo do link indica a camada que está sendo desenhada.

Uma camada WMTS que não é publicada em Web Mercator não pode ser desenhada. O mapa avisa quando esse é o caso.

Servidores que bloqueiam o Power BI

Se a verificação informar "Este servidor não permite que o Power BI o leia", marque Ler através do proxy CORS do Icon Map (apenas para servidores de confiança). No painel Formato, esta é a opção Usar o proxy quando necessário, que aparece depois que o mapa descobre que o servidor bloqueia o Power BI. O servidor é sempre tentado diretamente primeiro. Consulte Chaves de API, autenticação e o proxy.

Mais camadas raster

Defina Número de camadas adicionais (0 a 4). Um grupo Camada raster adicional aparece com as mesmas configurações. Escolha qual camada adicional ele mostra em Aplicar configurações a.

Configurações de raster

Painel Formato > Camadas de referência > Raster / WMTS - Configuração

Configuração O que faz Padrão
Modelo de mosaicos ou ligação WMTS Um modelo de tiles {z}/{x}/{y}, ou um link de serviço WMTS. Aceita formatação condicional (fx) Vazio
Usar o proxy quando necessário Lê os tiles por meio do proxy do Icon Map quando o servidor deles bloqueia o Power BI. Aparece depois que um bloqueio é encontrado Desativado
Configuração O que faz Padrão
Tamanho do tile O tamanho dos tiles do servidor em pixels, de 256 a 4096 256
GeoTIFF otimizado para nuvem (COG) Ative quando o link for um arquivo GeoTIFF Desativado
Transparência 0 é sólido, 100 é invisível 20 na primeira camada, 0 nas camadas adicionais
Zoom mínimo A camada fica oculta quando o zoom do mapa é afastado além deste nível 0
Zoom máximo A camada fica oculta quando o zoom do mapa é aproximado além deste nível 22 na primeira camada, 24 nas camadas adicionais
Visível Mostra ou oculta a camada. Aceita formatação condicional (fx) Sim
Z-Index Ordem de desenho, de 0 a 1000. Mais alto fica mais perto do observador 354 na primeira camada, 344 nas camadas adicionais
Número de camadas adicionais Quantas camadas raster a mais o mapa tem, de 0 a 4 0

Adicionar uma camada WMS

Um servidor WMS desenha imagens de mapa sob demanda. O servidor deve usar um endereço https:// e deve ser capaz de fornecer a camada em Web Mercator (EPSG:3857).

Uma camada WMS de zonas de inundação desenhada sobre o mapa base
Uma camada WMS sobre o mapa base
  1. No Gestor de camadas, selecione Adicionar uma camada, depois Camada de referência e depois o bloco WMS.
  2. Cole o endereço do serviço WMS e selecione Verificar. O assistente lê o serviço e informa quantas camadas ele oferece.
  3. Em Detalhes, escolha a Camada a desenhar. A lista pode incluir a camada de grupo do serviço, além das suas camadas individuais.
  4. Selecione Adicionar ao mapa e depois Aplicar alterações.
O assistente WMS do Gestor de camadas depois da verificação do link, com uma das camadas do serviço escolhida na lista Camada
Escolha a camada na lista que o serviço publica

A autenticação, os filtros, os estilos, os parâmetros personalizados e o proxy são definidos no painel Formato. Se o serviço precisar de algum deles, configure-o no painel Formato como descrito abaixo.

Para adicionar uma camada WMS no painel Formato:

  1. No painel Formato, abra Camadas de referência > Seleção de camadas e ative Camada WMS.
  2. Em WMS - configuração, cole o endereço do serviço em URL do servidor WMS. Tanto o endereço simples quanto o link GetCapabilities funcionam.
  3. Se o serviço exigir início de sessão, defina Tipo de autenticação e preencha os campos correspondentes. Consulte Autenticação WMS.
  4. Escolha a camada em Camada. A lista é lida do serviço.
  5. Escolha o Formato da imagem. Use um formato que ofereça transparência, como image/png, a menos que a camada deva cobrir o mapa base.
Ative Configuração manual quando terminar

Enquanto Configuração manual está desativada, o mapa pede ao servidor WMS a sua lista de camadas enquanto você edita o relatório. Quando a camada estiver funcionando, ative Configuração manual. A camada e o formato que você escolheu são mantidos como texto e as solicitações extras param.

Se a lista de camadas não puder ser lida

Se o painel mostrar "Unable to read layers from WMS server.", o mapa não conseguiu ler as capacidades do serviço. Verifique primeiro o endereço e a autenticação. Depois:

  • Se o servidor não permitir que o Power BI o leia (CORS), ative Usar proxy CORS. As solicitações passam então pelo proxy do Icon Map, que precisa de uma chave de licença do Icon Map e pode consumir créditos de uso adicionais. O proxy não é usado quando Ambiente isolado está ativada. Consulte Chaves de API, autenticação e o proxy.
  • Se o servidor desenhar mapas mas não publicar as suas capacidades, ative Configuração manual e digite você mesmo o nome da Camada e o Formato (por exemplo image/png).

Filtrar uma camada WMS

  • Filtro CQL (opcional) envia um filtro CQL com cada solicitação, para os servidores que o aceitam, como o GeoServer. Aceita formatação condicional (fx), portanto uma medida pode filtrar a camada conforme a seleção atual.
  • Nome do parâmetro personalizado (opcional) e Valor do parâmetro personalizado (opcional) adicionam um parâmetro à sua escolha a cada solicitação. O valor aceita formatação condicional (fx).
  • Para um serviço do ArcGIS, defina Tipo de autenticação como ArcGIS. Filtro de consulta (opcional para fontes de imagem) e Filtro LayerDefs (opcional) substituem então o filtro CQL.

Mais camadas WMS

Defina Número de camadas adicionais (0 a 4). Um grupo Camada WMS adicional aparece. Escolha qual camada adicional ele mostra em Aplicar configurações a.

As camadas adicionais são sempre configuradas manualmente: digite o nome da Camada e o Formato como texto. Para encontrar os nomes, configure o serviço como a primeira camada WMS e leia-os na lista Camada dela.

Autenticação WMS

Defina Tipo de autenticação em cada camada WMS.

Tipo de autenticação Use para Campos
Nenhum Serviços públicos
ArcGIS Serviços WMS hospedados no ArcGIS. A sua credencial do ArcGIS é adicionada a cada solicitação. Configure-a primeiro: consulte Conectar ao ArcGIS Filtro de consulta (opcional para fontes de imagem), Filtro LayerDefs (opcional)
Básico (nome de usuário e senha) Servidores que usam autenticação básica Nome de usuário, Senha
Token / chave de API na URL Servidores que recebem uma chave como parâmetro do endereço Nome da propriedade de autenticação (ex.: apikey ou token), Valor da propriedade de autenticação
Token / chave de API no cabeçalho Servidores que recebem uma chave como cabeçalho de solicitação Nome da propriedade de autenticação (ex.: apikey ou token), Valor da propriedade de autenticação
OAuth 2.0 Servidores que emitem um token para um ID e um segredo do cliente URL do OAuth2, ID do cliente OAuth2, Segredo do cliente OAuth2, Escopo OAuth2 (opcional), Nome do cabeçalho adicional (ex.: apikey ou token), Valor do cabeçalho adicional

Para uma chave na URL, retire a chave do endereço. Se o endereço de exemplo do serviço for https://example.com/wms?request=GetCapabilities&apikey=abc123, insira o endereço sem &apikey=abc123 em URL do servidor WMS, apikey como nome da propriedade e abc123 como valor da propriedade.

As senhas e os segredos do cliente são armazenados criptografados no relatório e são mostrados como pontos depois de inseridos.

OAuth 2.0 busca o token por meio do proxy do Icon Map, portanto precisa de uma chave de licença do Icon Map.

Uma credencial salva em um relatório é usada para todos os que abrem o relatório. Use uma conta ou uma chave que só tenha acesso ao que o relatório deve mostrar.

Configurações de WMS

Painel Formato > Camadas de referência > WMS - configuração

Configuração O que faz Padrão
URL do servidor WMS O endereço do serviço WMS. Aceita formatação condicional (fx) quando Configuração manual está ativada Vazio
Usar proxy CORS Envia as solicitações da camada por meio do proxy do Icon Map, para servidores que não permitem que o Power BI os leia Desativado
Tipo de autenticação Como o mapa inicia sessão no servidor. Veja a tabela acima Nenhum
Filtro CQL (opcional) Um filtro CQL enviado com cada solicitação. Aceita formatação condicional (fx). Não aparece para a autenticação ArcGIS Vazio
Nome do parâmetro personalizado (opcional), Valor do parâmetro personalizado (opcional) Um parâmetro de solicitação extra. O valor aceita formatação condicional (fx) Vazio
Configuração manual Ativada: você digita a camada, o formato e o estilo. Desativada: a camada e o formato são escolhidos em listas lidas do servidor Desativado
Camada A camada a desenhar. No modo manual, aceita formatação condicional (fx) Vazio
Formato O formato da imagem: image/png, image/jpeg, image/svg+xml ou image/vnd.jpeg-png, quando o servidor os oferece image/png
Estilo (opcional) Um estilo nomeado que o servidor oferece para a camada. Aceita formatação condicional (fx). Na primeira camada, aparece quando Configuração manual está ativada Vazio
Transparência 0 é sólido, 100 é invisível 10 na primeira camada, 0 nas camadas adicionais
Zoom mínimo A camada fica oculta quando o zoom do mapa é afastado além deste nível 0
Zoom máximo A camada fica oculta quando o zoom do mapa é aproximado além deste nível 24
Z-Index Ordem de desenho, de 0 a 1000. Mais alto fica mais perto do observador 255 na primeira camada, 344 nas camadas adicionais
Visível Mostra ou oculta a camada. Aceita formatação condicional (fx) Sim
Número de camadas adicionais Quantas camadas WMS a mais o mapa tem, de 0 a 4 0

Legendas WMS

Novo na 1.1.0.11

Cada camada WMS pode mostrar a imagem de legenda que o servidor dela publica. Ative a legenda no cartão Legenda e depois use Camada WMS {n} na legenda e Título de Camada WMS {n} em Rótulos da legenda para incluir e dar nome a cada camada. Uma imagem de legenda é mostrada para as camadas com Tipo de autenticação definido como Nenhum ou Token / chave de API na URL. Consulte Legenda.

No Gestor de camadas

Selecione uma camada raster ou WMS no Gestor de camadas para editar as suas configurações principais.

Camada Configurações
Mosaicos e imagens Modelo de mosaicos ou ligação WMTS, Cloud Optimized GeoTIFF, Tamanho do mosaico, Visível, Transparência, Visível no zoom
WMS Endereço do serviço WMS, Camada, Formato de imagem, Visível, Transparência, Visível no zoom

Substituir a ligação ou o ficheiro troca a fonte e mantém o lugar e o estilo da camada. Em uma camada WMS, também é a forma de escolher outra camada da lista do serviço.

Dicas e limites

  • As camadas WMS são solicitadas em Web Mercator (EPSG:3857). Um servidor que não pode fornecer essa projeção não pode ser desenhado.
  • A versão do WMS é obtida de um parâmetro version= no endereço que você cola. Sem ele, é usada a versão 1.1.1.
  • Os parâmetros de um endereço WMS colado que não fazem parte da solicitação padrão, como um nome de mapa ou de workspace, são mantidos e enviados com cada solicitação.
  • As camadas raster e WMS são imagens. Elas não têm dicas de ferramenta e não podem ser selecionadas.

Relacionados