--- title: "Como corrigir o Google Maps Field no ACF PRO (chave de API)" url: https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o Google Maps Field no ACF PRO (chave de API) ## O que é Google Maps Field do ACF PRO? O Google Maps Field do ACF PRO e um campo que renderiza um mapa interativo do Google no editor do WordPress para escolher e salvar um endereco com latitude e longitude. Ele depende da Google Maps JavaScript API, que so funciona com uma chave de API valida do Google e as APIs corretas habilitadas no projeto do Google Cloud. Quando essa chave esta ausente, invalida ou sem as APIs ativadas, o campo não renderiza o mapa: aparece uma área cinza, sem tiles, e o navegador registra um erro da Google Maps JavaScript API no console. ## Como identificar - O campo de mapa aparece como uma área cinza vazia no editor, sem os tiles do Google, mas a caixa de busca de endereco continua visivel. - No console do navegador (F12, aba Console) aparece a mensagem 'Google Maps JavaScript API error: ApiNotActivatedMapError' quando a Maps JavaScript API não foi habilitada no projeto. - O console mostra 'Google Maps JavaScript API error: InvalidKeyMapError' quando a chave informada esta errada ou não existe. - O console mostra 'Google Maps JavaScript API error: RefererNotAllowedMapError' quando a restricao de referenciador HTTP da chave não inclui o domínio do site. - O console mostra 'Google Maps JavaScript API error: BillingNotEnabledMapError' quando o faturamento (billing) não esta ativo no projeto do Google Cloud. - A busca de endereco no campo não retorna sugestoes, sinal de que a Places API (ou a Legacy Places API) não esta habilitada. **Antes de começar:** Faca backup do functions.php antes de edita-lo. Um erro de sintaxe no PHP derruba o site com tela branca; mantenha acesso por FTP para reverter o arquivo se isso acontecer. ## Como prevenir - Restrinja a chave de API a referenciadores HTTP do seu domínio e habilite apenas as APIs necessarias, para evitar consumo não autorizado e cobranca surpresa. - Use uma chave diferente para staging e producao, cada uma com a restricao de domínio correta, para nunca cair em RefererNotAllowedMapError ao publicar. - Configure alertas de orcamento (budget alerts) no faturamento do Google Cloud para ser avisado antes de a cobranca da Maps Platform crescer. - Registre a chave em um plugin de snippets versionado ou no tema filho, nunca em um tema pai que será sobrescrito na próxima atualização. Erros relacionados - [Como corrigir o Google Map Field do ACF PRO (erro de Google Maps API)](https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/) - [Como corrigir Custom Fields que não exibem no frontend no ACF PRO](https://full.services/wp-fixer/corrigir-custom-fields-nao-exibem-acf-pro/) - [Como corrigir a Options Page que não salva no ACF PRO](https://full.services/wp-fixer/corrigir-options-page-nao-salva-acf-pro/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#article", "headline": "Como corrigir o Google Maps Field no ACF PRO (chave de API)", "url": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:07-03:00", "dateModified": "2026-06-17T12:39:07-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Page Builders" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/" }, "wordCount": 827, "description": "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.", "articleSection": "Page Builders", "keywords": "acf google map mapa cinza, acf google maps field nao aparece, ApiNotActivatedMapError acf, chave api google maps acf, google maps field acf pro nao carrega", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://www.advancedcustomfields.com/resources/google-map/", "name": "Advanced Custom Fields — Google Map Field" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o Google Maps Field no ACF PRO (chave de API)", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q1", "name": "Por que o Google Maps Field do ACF mostra um mapa cinza?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q2", "name": "Como adiciono a chave de API do Google Maps no ACF PRO?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q3", "name": "Quais APIs do Google preciso habilitar para o campo funcionar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q4", "name": "O que significa o erro ApiNotActivatedMapError?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q5", "name": "Preciso ativar faturamento no Google Cloud para o mapa do ACF aparecer?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q6", "name": "O mapa funciona no staging mas some em producao, por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/#faq-q7", "name": "A busca de endereco não sugere nada, o que falta?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```