JetEngine Maps não exibe marcadores: como corrigir

Tipo Page Builders

Nome do erro Maps Listing do JetEngine sem marcadores EN: JetEngine Maps Listing not displaying markers

Severidade Atenção

Descrição O JetEngine não exibe marcadores no Maps Listing quando falta uma API key válida do provedor de mapas, quando o campo de endereço não tem coordenadas geocodificadas, ou quando a fonte de endereço do widget aponta para o campo errado. Sem latitude e longitude armazenadas, o mapa carrega mas nenhum pino é desenhado.

O que é Maps Listing do JetEngine sem marcadores?

O JetEngine Maps Listing é um widget que plota marcadores em um mapa a partir de um Listing, usando como fonte um campo do tipo endereço ou um par de coordenadas de cada item (post, termo ou registro de Custom Content Type). Cada marcador depende de uma latitude e longitude: o JetEngine só consegue posicionar o pino quando esse par de coordenadas existe para o item. O mapa em si é desenhado pelo provedor configurado em JetEngine, normalmente o Google Maps, que exige uma API key válida para inicializar.

Quando os marcadores não aparecem, a integração quebrou em algum ponto dessa cadeia: o provedor de mapas não inicializou por falta de API key ou de API habilitada, o campo de endereço dos itens está vazio ou nunca foi geocodificado, ou a configuração do widget aponta para a fonte de endereço errada. O sintoma é quase sempre o mesmo, um mapa que carrega centralizado mas sem nenhum pino, e a causa raiz está nos dados de coordenada ou na chave de API, não no widget em si.

Como identificar

O mapa carrega normalmente, centralizado, mas nenhum marcador aparece sobre ele.
O console do navegador exibe um erro do Google Maps como ‘Google Maps JavaScript API error: ApiNotActivatedMapError’ ou ‘RefererNotAllowedMapError’.
O mapa aparece totalmente cinza com a marca d’agua ‘For development purposes only’, sinalizando API key sem faturamento ativo.
Apenas alguns itens do Listing mostram marcador e o restante some, indicando itens sem coordenadas preenchidas.
No editor o widget Maps Listing renderiza o mapa, mas na pré-visualização e no frontend os pinos não são plotados.

Antes de começar: Antes de alterar a API key, trocar o provedor de mapas ou editar o Listing em produção, faça um backup do site ou teste em um ambiente de staging, para reverter caso o mapa ou o Listing pare de renderizar.

Como prevenir

Restrinja a API key do Google Maps por referenciador HTTP e por API (apenas Maps JavaScript API e Geocoding API), evitando uso indevido sem quebrar a renderização do site.
Padronize um campo de endereço dedicado nos tipos de post mapeados e valide a geocodificação ao cadastrar cada item, em vez de confiar em texto livre.
Mantenha uma conta de faturamento ativa no Google Cloud com orçamento e alertas, pois a falta de faturamento derruba os mapas com a marca d’agua de desenvolvimento.
Documente qual meta field alimenta cada Maps Listing para que ninguém troque a fonte de endereço por engano ao editar o Listing.

Causa

A API key do Google Maps não está configurada nas Maps Settings do JetEngine, ou a chave existe mas a Maps JavaScript API não foi habilitada no projeto do Google Cloud, impedindo o mapa de inicializar e plotar pinos.
O campo usado como fonte de endereço é do tipo texto comum e nunca foi geocodificado: sem o par latitude e longitude salvo no item, o JetEngine não tem coordenadas para posicionar o marcador.
A geocodificação falha porque a Geocoding API não está habilitada no mesmo projeto do Google Cloud da chave, então o endereço em texto nunca é convertido em coordenadas ao salvar o item.
No widget Maps Listing a opção de fonte do endereço aponta para o meta field errado (ou para um campo vazio), de modo que o JetEngine lê coordenadas inexistentes e não desenha nenhum pino.
A restrição de domínio (HTTP referrers) da API key no Google Cloud não inclui o domínio do site, fazendo o Google bloquear a requisição com RefererNotAllowedMapError e abortar a renderização dos marcadores.

Como resolver

Confira a API key do provedor de mapas no JetEngine: Abra as configurações de mapas do JetEngine e confirme que há uma API key válida do provedor escolhido. Sem chave, o mapa até carrega em modo limitado, mas a renderização de marcadores falha.
```
Painel WP -> JetEngine -> JetEngine (Settings) -> aba Maps Settings
Cole a API key do Google Maps no campo API Key e salve
Confirme o provedor selecionado (ex.: Google Maps)
```
Habilite as APIs corretas no Google Cloud: No console do Google Cloud, no mesmo projeto da chave, ative a Maps JavaScript API (desenha o mapa) e a Geocoding API (converte endereço em coordenadas). Garanta também que o faturamento esteja ativo, senão o mapa aparece cinza com aviso de desenvolvimento.
```
Google Cloud Console -> APIs e Serviços -> Biblioteca
Ative 'Maps JavaScript API'
Ative 'Geocoding API'
Faturamento -> confirme uma conta de faturamento vinculada ao projeto
```
Confirme a fonte de endereço no widget Maps Listing: Edite o Listing do mapa e verifique a opção que define de onde vêm as coordenadas. Ela precisa apontar para o campo de endereço ou de mapa real do item, não para um campo vazio ou de texto solto.
```
Abra o Listing Item do mapa no editor (Elementor ou Blocos)
Selecione o widget Maps Listing -> defina a fonte do endereço (Source) para o meta field correto
Salve e atualize a pré-visualização
```
Garanta coordenadas geocodificadas em cada item: Abra alguns posts ou registros que deveriam aparecer no mapa e confirme que o campo de endereço está preenchido e foi geocodificado, gerando latitude e longitude. Reabrir e salvar o item força o JetEngine a geocodificar o endereço novamente.
```
Painel WP -> abra um item do tipo de post usado no mapa
Preencha o campo de endereço com um endereço completo e válido
Atualize (Update) o item para disparar a geocodificação e gravar lat/lng
```
Ajuste as restrições de domínio da API key: Se o console do navegador mostrar RefererNotAllowedMapError, a chave está restrita a domínios que não incluem o site. Adicione o domínio do WordPress à lista de referrers permitidos da chave.
```
Google Cloud Console -> APIs e Serviços -> Credenciais -> abra a API key
Em Restrições de aplicativo, escolha Referenciadores HTTP
Adicione 'https://seusite.com/*' e 'https://*.seusite.com/*' e salve
```

JavaScript

// Cole no console do navegador na página com o mapa do JetEngine.
// Lista cada item do Maps Listing e mostra se tem coordenadas válidas.
document.querySelectorAll('.jet-map-listing__item, .jet-map-marker').forEach(function (el, i) {
  var lat = el.getAttribute('data-lat') || el.dataset.lat;
  var lng = el.getAttribute('data-lng') || el.dataset.lng;
  var ok = lat && lng && !isNaN(parseFloat(lat)) && !isNaN(parseFloat(lng));
  console.log('Item ' + (i + 1) + ' -> lat:', lat, '| lng:', lng, ok ? '| OK' : '| SEM COORDENADAS');
});

Perguntas frequentes

Por que meu mapa do JetEngine carrega mas não mostra marcadores

Na maioria dos casos o mapa inicializa pela API key, mas os itens não têm coordenadas. O JetEngine só plota um pino quando há latitude e longitude para o item, então um campo de endereço vazio ou não geocodificado deixa o mapa sem marcadores.

O JetEngine Maps Listing precisa de API key do Google Maps

Sim, quando o provedor escolhido é o Google Maps. A chave vai nas Maps Settings do JetEngine e o projeto no Google Cloud precisa da Maps JavaScript API ativa para desenhar o mapa e da Geocoding API para converter endereços em coordenadas.

Por que o mapa aparece cinza com o aviso 'For development purposes only'

Esse aviso indica que a API key não tem uma conta de faturamento ativa vinculada ao projeto no Google Cloud. Ative o faturamento e o mapa volta a renderizar normalmente, junto com os marcadores.

Como faço o endereço do item virar marcador no mapa

O endereço em texto precisa ser geocodificado, ou seja, convertido em latitude e longitude. Com a Geocoding API habilitada, salvar o item dispara a geocodificação e o JetEngine grava as coordenadas usadas para posicionar o pino.

O que significa o erro RefererNotAllowedMapError no console

Significa que a API key está restrita a domínios que não incluem o do seu site. Em Credenciais no Google Cloud, adicione o domínio do WordPress à lista de referenciadores HTTP permitidos da chave para liberar a requisição.

Só alguns itens aparecem no mapa, por que

Os itens que aparecem têm coordenadas válidas e os que somem não. Reabra cada post sem marcador, confirme o endereço preenchido e salve o item para forçar a geocodificação e gravar a latitude e longitude faltante.

Posso usar outro provedor de mapas no JetEngine além do Google

Sim, as Maps Settings do JetEngine permitem escolher o provedor. Independentemente da escolha, a mesma lógica vale: cada item precisa de coordenadas geocodificadas e o provedor precisa estar corretamente autenticado para que os marcadores apareçam.

O marcador some no frontend mas aparece no editor, é normal

Não. Em geral é restrição da API key ou cache. Verifique se a chave permite o domínio do frontend, limpe o cache do site e do navegador e confirme que a fonte de endereço do widget aponta para o campo com coordenadas.

Informativo

Como corrigir o Color Picker que não aplica a cor no frontend no ACF PRO

O ACF color picker não aplica cor no frontend quando o template não imprime o valor do campo, quando o nome do campo está errado ou quando a transparência muda o retorno para RGBA e o código espera HEX. O Color Picker do ACF PRO guarda a cor, mas só aparece se o tema a imprimir no HTML ou no CSS.

Informativo

Como corrigir o layout quebrado do Pricing Menu no Happy Addons

O layout quebrado do Pricing Menu no Happy Addons ocorre quando o CSS do widget não carrega na página, normalmente por cache do Elementor desatualizado, pela função On Demand Asset filtrando o estilo ou por um plugin de cache removendo os arquivos do Happy Addons.

Atenção

Como corrigir os Predefined Websites que não importam no Astra Pro

O Astra Starter Templates (Predefined Websites) não importa quando o servidor estoura o tempo de execução, não consegue gravar o XML em wp-content ou falha ao instalar um plugin obrigatório do template. A importação para no meio e exibe erros como cURL error 28 ou Could not store XML file.

Atenção

Como corrigir o erro do Image Grid no Happy Addons

O erro do Image Grid no Happy Addons acontece quando o widget está desativado no Feature Controller, o Elementor está desatualizado ou um cache antigo serve o CSS e o JavaScript errados, fazendo o widget sumir do editor, as imagens não aparecerem ou o layout masonry quebrar.

Grave

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

O erro "Preview Could Not Be Loaded" aparece quando o editor do Elementor não consegue carregar a página dentro do iframe de preview. O próprio aviso costuma apontar a causa: tema ausente, .htaccess corrompido, código HTTP de erro ou a página de posts definida como página estática.

Grave

Como corrigir o Flexible Content que não salva layouts no ACF PRO

O Flexible Content que não salva no ACF PRO acontece quando os layouts e seus subcampos viram tantos campos no formulário que o POST ultrapassa o limite max_input_vars do PHP: o WordPress descarta o excedente, o nonce ou os dados não chegam e a atualização do post perde os layouts. A correção é elevar max_input_vars para 10000.

Setores

Extensões

Integrações

Como corrigir o Maps Listing do JetEngine que não exibe marcadores no WordPress

O que é Maps Listing do JetEngine sem marcadores?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o Color Picker que não aplica a cor no frontend no ACF PRO

Como corrigir o layout quebrado do Pricing Menu no Happy Addons

Como corrigir os Predefined Websites que não importam no Astra Pro

Como corrigir o erro do Image Grid no Happy Addons

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

Como corrigir o Flexible Content que não salva layouts no ACF PRO

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos