Solução de problemas
A maioria dos problemas se encaixa em quatro grupos: uma mensagem de licença, um mapa base que não carrega, dados que não são desenhados ou uma camada vinculada por link que fica vazia. Percorra os grupos nesta ordem.
1. O mapa mostra uma mensagem de licença
Uma mensagem sobre o mapa significa que o visual não encontrou uma licença válida. Enquanto você edita um relatório, a mensagem oferece o botão Obter licença de desenvolvedor GRATUITA e uma caixa para uma chave de licença com um botão Aplicar chave.
| Você vê | Faça isto |
|---|---|
| "É necessária uma licença para usar o Icon Map Pro" | Obtenha a licença gratuita de desenvolvedor, insira uma chave de licença ou compre uma licença |
| "Nenhuma licença configurada" | Peça ao proprietário do relatório que atribua uma licença a você ou adicione uma chave de licença ao relatório |
| "Ambiente não compatível" | O relatório usa uma licença de desenvolvedor, que os leitores não podem usar. Solicite uma avaliação de publicação ou compre uma licença |
| "Não foi possível validar a licença" | Não foi possível alcançar o serviço de licenciamento. Verifique se validate.iconmappro.com e validate2.iconmappro.com estão permitidos na sua rede |
| Você comprou uma licença de usuário, mas a mensagem continua | Verifique se a licença está atribuída a você e depois atualize o relatório ou reinicie o Power BI Desktop. Pode levar até 30 minutos |
Todas as mensagens são explicadas em Chaves de licença e ativação.
2. O mapa base está em branco ou cinza
Endereços de rede bloqueados
Esta é a causa mais comum em redes corporativas. O visual carrega o mapa base pela internet, e um firewall ou servidor proxy que bloqueia o endereço deixa o mapa vazio enquanto o restante do relatório funciona.
Para os mapas base do Icon Map, permita styles.iconmappro.com. A lista completa, incluindo os endereços de licenciamento, do Catálogo do Icon Map e de outros fornecedores, está em Ambientes compatíveis e limites.
Para confirmar um bloqueio, abra as ferramentas de desenvolvedor do navegador (F12) no serviço do Power BI, selecione a guia Rede, recarregue o relatório e procure solicitações com falha aos endereços dessa lista. Passe os endereços com falha à sua equipe de rede.
O WebGL 2 não está disponível
O mecanismo Moderno precisa do WebGL 2. Onde ele está ausente, o mapa mostra a mensagem "O WebGL 2 não está disponível neste ambiente." e recorre ao mecanismo Herdado nessa sessão.
- Habilite a aceleração de hardware nas configurações do navegador.
- Atualize os drivers da placa de vídeo.
- Em uma área de trabalho virtual (VDI, Citrix, RDP), pergunte ao administrador de TI sobre a habilitação da passagem direta de GPU (GPU passthrough).
- Experimente outro navegador.
O mapa base precisa do mecanismo Herdado
Uma mensagem como "The Google Maps background requires the Legacy map engine setting. Switch the map engine in Rendering, or choose another background." significa que o mapa base salvo no relatório é um que o mecanismo Moderno não desenha. Escolha outro mapa base ou mude Renderização > Mecanismo de mapa para Herdado. Consulte Mecanismos Moderno e Herdado.
A chave de um fornecedor está ausente ou incorreta
Os mapas base do Azure Maps, da Mappable e da Ordnance Survey precisam de uma chave de API. Verifique a chave em Chaves de API e autenticação > Chaves de API. Consulte Chaves de API, autenticação e o proxy.
O visual inteiro é substituído por uma mensagem do Power BI
"Uncertified visuals from AppSource, or added from a file, are not available due to your admin settings" significa que o seu locatário bloqueia visuais não certificados. Um administrador do Power BI pode adicionar o Icon Map Pro como visual organizacional. Consulte Segurança e certificação.
O Power BI Report Server mostra um espaço em branco
Em um servidor sem acesso à internet, o Power BI tenta alcançar o AppSource e não consegue. Siga Power BI Report Server (local).
3. O mapa base aparece, mas uma camada de dados não desenha nada
Cada linha é desenhada pela camada cujos campos ela preenche. Uma camada não desenha nada quando está desativada, quando falta um campo de que ela precisa ou quando as linhas dela também preenchem um campo que pertence a outra camada.
Abra o resumo da configuração de dados
Ative Painel Formato > Diagnósticos > Ferramentas de diagnóstico > Mostrar resumo da configuração de dados. O resumo mostra quantas linhas o Power BI enviou, quantas cada camada consegue desenhar e avisos como o de uma camada que tem linhas, mas está desativada.
Verifique estes pontos, um a um
| Verificação | Como |
|---|---|
| A camada está ativada | Painel Formato > Camadas de dados > Camadas de dados |
| O visual tem um ID | * ID (obrigatório) precisa conter um campo. Sem ele, o Power BI não envia linhas |
| A camada tem todos os campos de que precisa | Consulte Referência de campos |
| As linhas dela deixam vazios os campos das outras camadas | Uma coluna em um poço de campos tem um valor em todas as linhas. Use uma medida que retorne BLANK() nas linhas que pertencem a outra camada. Consulte Combinar várias camadas em um mapa |
| A longitude e a latitude não estão sendo somadas | Defina Longitude (X) e Latitude (Y) para resumir como Média |
| Os valores são válidos | Uma coordenada fora do intervalo, ou um texto onde se espera um número, impede que uma linha seja desenhada |
| As linhas não estão sendo cortadas | O Power BI envia 30.000 linhas por padrão. Consulte Linhas de dados e limites |
| Um filtro ou uma segmentação de dados não está removendo todas as linhas | Limpe os filtros do visual e da página |
Enquanto você edita um mapa cujas linhas não chegam a nenhuma camada, o guia "Que tipo de mapa quer criar?" aparece sobre o mapa e mostra de quais campos cada tipo de camada precisa. Consulte Escolher um tipo de camada.
Veja o que o Power BI está enviando
Para ver os valores que o visual recebe, incluindo os valores de medidas, copie o visual do mapa, cole a cópia na mesma página e mude a cópia para uma tabela. A tabela mostra uma linha por ID com o valor de cada campo.
Faltam formas de texto WKT ou GeoJSON
O Power BI pode guardar 32.766 caracteres em um valor de texto. Uma forma mais longa é cortada e não pode ser desenhada. Verifique o comprimento com uma medida como WKT Length = LEN ( MAX ( 'Table'[WKT Column] ) ) e consulte Formas dos dados (WKT e GeoJSON) para ver formas de encurtar as formas.
4. Uma camada vinda de um link fica vazia
Uma camada que vem de um link, como um arquivo GeoJSON, um servidor de tiles, um WMS ou um serviço do ArcGIS, depende de um servidor que o visual precisa conseguir ler.
| Causa | Como identificar | Correção |
|---|---|---|
| O servidor não permite o Power BI (CORS) | O link abre em um navegador, mas a camada fica vazia no mapa | Permita o CORS no servidor para uma origem * ou null, ou use o proxy do Icon Map |
| O link não é acessível | O link não abre na máquina que mostra o relatório | Verifique o endereço, a VPN e o firewall |
| A credencial está ausente ou expirou | O servidor pede uma entrada com credenciais, ou retorna um erro como "Invalid Token" | Verifique Chaves de API e autenticação. Para "Invalid Token" do ArcGIS Enterprise, defina Enviar credencial como como Cabeçalho de autorização (Bearer) |
| A associação não corresponde | As formas aparecem, mas não são coloridas pelos seus dados | Verifique se os valores de Referência da feição correspondem à propriedade que você escolheu nas configurações da camada |
O Power BI executa os visuais personalizados em uma área restrita (sandbox), por isso um servidor precisa permitir explicitamente as solicitações vindas dela. É por isso que um link pode funcionar em uma guia do navegador e falhar no mapa.
Para uma camada de referência WMS em um servidor que não permite o CORS, você pode ativar Usar proxy CORS nas configurações da camada. Consulte Chaves de API, autenticação e o proxy para saber o que é o proxy e o que passa por ele.
Outros problemas
Uma correção ou um recurso das notas de versão não está presente
Verifique a versão em execução em Painel Formato > Icon Map Pro. O Power BI usa a versão que o AppSource publicou, que pode estar atrás da versão mais recente. Consulte as Notas de versão.
As dicas de ferramenta ou a seleção não fazem nada
As dicas de ferramenta e a seleção ficam inativas onde o Power BI não permite a interação com visuais, como em exportações. Nas camadas, verifique Incluir dica de ferramenta e Selecionável nas configurações da camada. Consulte Seleção, filtro cruzado e realce.
O visual está no idioma errado
O visual segue o idioma do relatório. Consulte Idiomas.
O cartão do Catálogo do Icon Map está ausente
Icon Map Pro > Personalização > Ambiente isolado está ativado. Ele oculta o catálogo porque o catálogo precisa de acesso à internet.
Ainda sem solução?
Obter suporte. Inclua o número da versão, onde o relatório está sendo executado e o que você já verificou.