Google Map Field ACF PRO: corrigir API key

Tipo Page Builders

Nome do erro Google Map Field do ACF PRO não carrega (API Key) EN: ACF PRO Google Map Field not loading (Google Maps API error)

Severidade Grave

Descrição O Google Map Field do ACF PRO renderiza um mapa cinza ou vazio quando não ha uma chave da Google Maps JavaScript API registrada no WordPress, ou quando a chave existe mas as APIs e restricoes do Google Cloud estão incorretas.

Conteúdo exclusivo para membros Pro

Faça upgrade para acessar este item completo.

// ★ Conteúdo disponível para membros Pro...
// Faça upgrade para acessar este item.

Perguntas frequentes

O Google Map Field do ACF PRO funciona sem chave de API?

Não. A documentação oficial do ACF exige uma chave valida da Google Maps JavaScript API registrada no WordPress. Sem chave o campo so mostra um retangulo cinza e erros como MissingKeyMapError no console.

Por que aparece 'This page can't load Google Maps correctly' no meu mapa?

Essa mensagem sobreposta indica um erro crítico da Google Maps JavaScript API. O motivo exato aparece no console do navegador, normalmente chave ausente, API não habilitada, domínio não autorizado ou faturamento desativado no Google Cloud.

Onde eu coloco a chave da API no WordPress para o ACF?

No functions.php do tema filho ou num plugin de snippets, usando o filtro acf/fields/google_map/api ou a função acf_update_setting('google_api_key', ...) no hook acf/init. As duas formas estão na documentação oficial do ACF.

Quais APIs do Google Cloud o Google Map Field do ACF exige?

Maps JavaScript API para desenhar o mapa, Geocoding API para converter enderecos em coordenadas e Places API para o autocomplete de busca. Sites novos criados a partir de marco de 2025 devem habilitar a Legacy Places API.

O que significa o erro RefererNotAllowedMapError no console?

Significa que a URL atual não esta na lista de referenciadores permitidos da chave. Edite a chave no Google Cloud e adicione o seu domínio com e sem www no formato de curinga, por exemplo o endereco do site seguido de barra asterisco.

Por que o mapa funciona no editor mas quebra no frontend?

Em geral e um plugin de cache ou minificacao que reagrupou o JavaScript e quebrou o parametro da chave no carregamento da Maps JavaScript API no frontend. Exclua o script do ACF da minificacao e limpe o cache.

Preciso ativar faturamento no Google Cloud para o ACF usar o mapa?

Sim. Desde 2018 a Maps JavaScript API exige uma conta de faturamento ativa vinculada ao projeto, mesmo com cota gratuita mensal. Sem ela o mapa retorna BillingNotEnabledMapError mesmo com a chave correta.

Pro Grave

Como corrigir widgets do Happy Addons que não carregam no editor Elementor

Quando os widgets do Happy Addons não carregam no editor Elementor, o painel de elementos abre sem a seção Happy, em geral porque o recurso foi desligado no Feature Controller, porque o Elementor esta abaixo da versão 3.7.0 exigida, ou porque um erro de JavaScript no editor interrompe o registro dos widgets.

Pro Atenção

Como corrigir o Image Field no ACF PRO

O Image Field do ACF PRO não retorna a URL quando o Return Format do campo está como Image Array ou Image ID, mas o template usa o valor como se fosse a string da URL. O ACF devolve um array ou um número de anexo, então o atributo src da imagem sai quebrado ou vazio.

Pro Atenção

Como corrigir fontes do Google que não carregam no Elementor

O Google Fonts no Elementor não carrega quando o CSS gerado guarda referências antigas, a opção de fontes locais baixa arquivos incompletos ou o cache serve a folha antiga. O texto cai para Arial no frontend, mesmo a fonte aparecendo certa no editor.

Pro Grave

Como corrigir erros de JavaScript no console ao usar o Elementor

O erro de JavaScript no console do Elementor aparece como mensagens Uncaught no DevTools do navegador (F12) e impede o editor de carregar ou quebra widgets no frontend. A causa quase sempre e outro plugin que duplica ou remove o jQuery, ou um plugin de cache que minifica e combina os arquivos JS do Elementor na ordem errada.

Pro Grave

Como corrigir layout quebrado no mobile após atualizar o Elementor

O layout mobile do Elementor quebra depois de atualizar quando os novos breakpoints do plugin deslocam onde os estilos responsivos são aplicados e o CSS antigo de cada página não e regenerado. No desktop o site parece normal, mas no celular o conteúdo aparece sobreposto, com colunas empilhadas erradas ou fora de largura.

Pro Grave

Como corrigir o erro de PHP ao ativar o Elementor Pro em hospedagem compartilhada

O erro de PHP ao ativar o Elementor Pro em hospedagem compartilhada acontece quando o servidor não atende aos requisitos do plugin: a versão do PHP esta abaixo de 7.4, a memória reservada por requisicao e baixa, ou o plugin base gratuito Elementor não esta ativo. O WordPress aborta a ativacao e mostra um erro fatal.

Setores

Extensões

Integrações

Como corrigir o Google Map Field do ACF PRO (erro de Google Maps API)

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir widgets do Happy Addons que não carregam no editor Elementor

Como corrigir o Image Field no ACF PRO

Como corrigir fontes do Google que não carregam no Elementor

Como corrigir erros de JavaScript no console ao usar o Elementor

Como corrigir layout quebrado no mobile após atualizar o Elementor

Como corrigir o erro de PHP ao ativar o Elementor Pro em hospedagem compartilhada

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