--- title: "Como corrigir o Google Map Field do ACF PRO (erro de Google Maps API)" url: https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o Google Map Field do ACF PRO (erro de Google Maps API) ## O que é Google Map Field do ACF sem API key? O Google Map Field e um campo do ACF PRO que renderiza um mapa interativo do Google Maps no editor e no frontend, usando a Google Maps JavaScript API para desenhar o mapa, geocodificar enderecos e mostrar o autocomplete de busca. Diferente de outros campos, ele depende de um serviço externo pago: sem uma chave de API valida registrada e com as APIs certas habilitadas no Google Cloud, o campo não consegue inicializar o mapa. A documentação oficial do ACF e clara: para usar a Google Maps JavaScript API e preciso primeiro registrar uma chave de API valida. O sintoma classico e um retangulo cinza no lugar do mapa, tanto na tela de edição do campo quanto na página publicada, acompanhado de mensagens de erro no console do navegador. ## Como identificar - Mensagem sobreposta no próprio mapa: 'This page can't load Google Maps correctly', com o mapa escurecido e a marca d'agua do Google - Retangulo cinza ou área em branco no lugar do mapa, tanto no editor do ACF quanto no frontend do post - No console do navegador (F12, aba Console): 'Google Maps JavaScript API error: ApiNotActivatedMapError' quando a Maps JavaScript API não esta habilitada no projeto - No console: 'Google Maps JavaScript API error: RefererNotAllowedMapError' quando o domínio do site não esta na lista de referrers permitidos da chave - No console: 'InvalidKeyMapError' ou 'MissingKeyMapError' quando nenhuma chave (ou uma chave errada) foi registrada no WordPress - No console: 'BillingNotEnabledMapError' quando o projeto do Google Cloud não tem uma conta de faturamento ativa - O campo de busca de endereco (autocomplete) do Google Map Field não retorna sugestoes ao digitar ## Como prevenir - Mantenha a chave da Google Maps API sempre restrita por referrer HTTP ao seu domínio, para que ela não possa ser reutilizada por terceiros e gere cobranca indevida. - Configure um teto de cota e um alerta de orcamento no Google Cloud para ser avisado antes de a Maps JavaScript API estourar o limite do período gratuito. - Registre a chave por filtro no código (functions.php ou plugin de snippets) e não espalhada em campos do tema, para ter uma fonte única fácil de auditar. - Após qualquer atualização do ACF PRO, abra um post com o Google Map Field e confira o console para flagrar deprecacao de API antes que o mapa quebre em producao. Erros relacionados - [Como corrigir o Google Maps Field no ACF PRO (chave de API)](https://full.services/wp-fixer/corrigir-google-maps-field-acf-pro/) - [Como corrigir o Image Field no ACF PRO](https://full.services/wp-fixer/corrigir-image-field-acf-pro/) - [Como corrigir o erro de File Upload por permissões de pasta no ACF PRO](https://full.services/wp-fixer/corrigir-file-upload-permissoes-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-map-field-api-acf-pro/#article", "headline": "Como corrigir o Google Map Field do ACF PRO (erro de Google Maps API)", "url": "https://full.services/wp-fixer/corrigir-google-map-field-api-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-map-field-api-acf-pro/" }, "wordCount": 862, "description": "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.", "articleSection": "Page Builders", "keywords": "acf google api key filtro, acf_update_setting google_api_key, google map field acf pro nao carrega, RefererNotAllowedMapError acf, this page cant load google maps correctly acf", "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 Map Field do ACF PRO (erro de Google Maps API)", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q1", "name": "O Google Map Field do ACF PRO funciona sem chave de API?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q2", "name": "Por que aparece 'This page can't load Google Maps correctly' no meu mapa?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q3", "name": "Onde eu coloco a chave da API no WordPress para o ACF?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q4", "name": "Quais APIs do Google Cloud o Google Map Field do ACF exige?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q5", "name": "O que significa o erro RefererNotAllowedMapError no console?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q6", "name": "Por que o mapa funciona no editor mas quebra no frontend?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-google-map-field-api-acf-pro/#faq-q7", "name": "Preciso ativar faturamento no Google Cloud para o ACF usar o mapa?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```