Google Maps Field ACF PRO Não Carrega: Como Corrigir

Tipo Page Builders

Nome do erro Google Maps Field do ACF PRO não carrega EN: ACF PRO Google Maps Field not loading

Severidade Atenção

Descrição O Google Maps Field do ACF PRO exige uma chave de API do Google registrada via filtro acf/fields/google_map/api ou acf_update_setting. Sem ela, o campo mostra um mapa cinza e o console acusa erro da Google Maps JavaScript API.

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

Por que o Google Maps Field do ACF mostra um mapa cinza?

O mapa cinza significa que a Google Maps JavaScript API não conseguiu carregar. Quase sempre a causa e a falta de chave de API valida registrada no ACF ou a Maps JavaScript API desativada no projeto do Google Cloud. Abra o console do navegador para ler a mensagem de erro exata.

Como adiciono a chave de API do Google Maps no ACF PRO?

Use o filtro acf/fields/google_map/api ou a função acf_update_setting com google_api_key dentro de um hook acf/init. Coloque o código no functions.php do tema filho ou em um plugin de snippets, trocando o valor pela sua chave real gerada no Google Cloud Console.

Quais APIs do Google preciso habilitar para o campo funcionar?

Três APIs são exigidas: Maps JavaScript API para desenhar o mapa, Geocoding API para converter endereco em coordenadas e Places API para o autocomplete de endereco. Em projetos criados após marco de 2025, ative também a Legacy Places API.

O que significa o erro ApiNotActivatedMapError?

Esse erro no console indica que a chave existe, mas a Maps JavaScript API não esta habilitada no projeto do Google Cloud. Abra a biblioteca de APIs, procure por Maps JavaScript API e clique em Ativar; depois recarregue a tela de edição do post.

Preciso ativar faturamento no Google Cloud para o mapa do ACF aparecer?

Sim. Desde 2018 a Google Maps Platform exige uma conta de faturamento vinculada ao projeto, mesmo dentro da cota gratuita mensal. Sem faturamento ativo a chave e recusada e o console acusa BillingNotEnabledMapError.

O mapa funciona no staging mas some em producao, por que?

A chave tem restricao de referenciador HTTP apenas para o domínio de staging. Edite a chave em Credenciais, adicione o domínio de producao a lista de referenciadores HTTP e aguarde alguns minutos para a alteração propagar.

A busca de endereco não sugere nada, o que falta?

O autocomplete depende da Places API. Habilite a Places API e, em projetos novos, a Legacy Places API no Google Cloud. Confirme também que a Geocoding API esta ativa, pois ela converte o endereco escolhido em latitude e longitude para salvar.

Pro Grave

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

O erro de compatibilidade do Elementor com o PHP 8.3 acontece quando uma versão antiga do plugin roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o editor ou o front-end. A correção é alinhar o Elementor e o Elementor Pro na última versão e garantir os recursos de PHP exigidos.

Pro Atenção

Como corrigir WPBakery com shortcodes quebrados

WPBakery com shortcodes quebrados mostra codigos crus como [vc_row] e [vc_column] no lugar do layout montado, porque o plugin que interpreta esses shortcodes nao esta ativo ou registrado. A causa quase sempre e o WPBakery (Visual Composer) desativado, embutido num tema que sumiu, ou paginas migradas para um site sem o plugin.

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 pop-ups que não aparecem no Elementor

Quando o popup do Elementor não aparece, a janela criada no Popup Builder nunca abre no site publicado. As causas comuns são falta de Condicao de exibicao em Publicar, Gatilho ausente sem link de disparo, o cookie de frequencia já gravado, ou o cache minificando o script do popup.

Pro Atenção

Como corrigir a Conditional Logic que não funciona no ACF PRO

A Conditional Logic do ACF PRO que não funciona quase sempre vem do campo de gatilho que não guarda um valor comparável (Repeater, Group, Mensagem) ou do JavaScript do ACF que não carregou na tela. A lógica condicional só controla a exibição no editor, não impede que o valor oculto seja salvo ou exibido no frontend.

Pro Grave

Como corrigir o editor do Elementor que não carrega

Quando o editor do Elementor não carrega, ele trava na barra de carregamento ou abre em branco. A causa quase sempre é limite de memória/PHP baixo demais para o site ou um conflito com outro plugin (cache ou minificação de JavaScript).

Setores

Extensões

Integrações

Como corrigir o Google Maps Field no ACF PRO (chave de API)

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

Como corrigir WPBakery com shortcodes quebrados

Como corrigir o Image Field no ACF PRO

Como corrigir pop-ups que não aparecem no Elementor

Como corrigir a Conditional Logic que não funciona no ACF PRO

Como corrigir o editor do Elementor que não carrega

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