--- title: "Como corrigir o mapa do Google que não aparece no WordPress" url: https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/ date: 2026-06-13 author: "Clayton Margiotti" --- # Como corrigir o mapa do Google que não aparece no WordPress ## O que é o mapa do Google que não aparece no WordPress? O mapa do Google que não aparece é a falha em que um bloco de mapa incorporado (via plugin, Elementor ou shortcode) exibe uma área cinza, uma mensagem de erro ou a marca d'água que escurece o mapa em vez do mapa funcional. Desde 2018 a Google Maps Platform exige uma chave de API com faturamento ativado, então mapas sem chave válida ou sem cartão na conta param de renderizar. As pistas exatas aparecem no console do navegador. ## Como identificar - No lugar do mapa aparece um bloco cinza ou o mapa coberto pela marca d'água "For development purposes only". - O console do navegador (F12) mostra o erro "Google Maps JavaScript API error: ApiNotActivatedMapError" ou "RefererNotAllowedMapError". - O console exibe "BillingNotEnabledMapError", indicando que a conta da Google Cloud não tem faturamento ativo. - O mapa funciona no editor do Elementor ou do plugin, mas some na página publicada para o visitante. **Antes de começar:** Nunca deixe a chave de API do Google Maps sem restrição de referenciador. Uma chave aberta pode ser copiada do código-fonte e usada por terceiros, gerando cobrança no seu faturamento da Google Cloud. ## Como prevenir - Restrinja a chave de API por referenciador HTTP e mantenha apenas as APIs do Maps que o site usa ativadas - Monitore a cota e o faturamento na Google Cloud para o mapa não sumir ao estourar o limite gratuito - Ao usar cache, exclua o script do Google Maps das regras de adiar ou combinar JavaScript ## Erros relacionados - [Como corrigir imagens que não aparecem no WordPress](https://full.services/wp-fixer/corrigir-imagens-nao-aparecem-wordpress/) - [Como corrigir formulário de contato que não envia email](https://full.services/wp-fixer/corrigir-formulario-contato-nao-envia-wordpress/) - [Como identificar conflito de plugins no WordPress](https://full.services/wp-fixer/identificar-conflito-de-plugins-wordpress/) --- ## 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-mapa-google-nao-aparece-wordpress/#article", "headline": "Como corrigir o mapa do Google que não aparece no WordPress", "url": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/", "inLanguage": "pt-BR", "datePublished": "2026-06-13T23:44:20-03:00", "dateModified": "2026-06-13T23:44:20-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": "Outros erros" } ], "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-mapa-google-nao-aparece-wordpress/" }, "wordCount": 546, "description": "O mapa do Google que não aparece no WordPress quase sempre indica uma chave de API ausente, restrita demais ou sem faturamento ativo na conta. O resultado é um bloco cinza, um mapa com a marca d'água 'For development purposes only' ou um erro no console; a correção é gerar e restringir corretamente a chave da Google Maps Platform.", "articleSection": "Outros erros", "keywords": "apionotactivatedmaperror, chave api google maps wordpress, for development purposes only mapa, google maps nao carrega wordpress, mapa cinza wordpress", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://developers.google.com/maps/documentation/javascript/get-api-key", "name": "Google Maps Platform — Get an API Key" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o mapa do Google que não aparece no WordPress", "programmingLanguage": "Html", "codeRepository": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q1", "name": "Por que o mapa do Google aparece cinza no WordPress?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O bloco cinza, geralmente com a marca d'água 'For development purposes only', indica que a chave de API existe mas a conta da Google Cloud está sem faturamento ativo. Ative o faturamento na conta para o mapa renderizar normalmente.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q2", "name": "Preciso pagar para usar o Google Maps no site?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A Maps Platform oferece uma cota mensal gratuita, mas exige um cartão cadastrado e faturamento ativo. Para sites de tráfego comum, o uso costuma ficar dentro do gratuito. Sem o faturamento ativo, porém, o mapa não carrega.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q3", "name": "O que é o erro RefererNotAllowedMapError?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Significa que o domínio do site não está na lista de referenciadores HTTP permitidos da chave. Edite as restrições da chave na Google Cloud e adicione o endereço do site com e sem www, usando o curinga no final.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q4", "name": "Como achar a causa exata do mapa não carregar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Abra a página, pressione F12 e leia a aba Console. A Google escreve o motivo: ApiNotActivatedMapError (API não ativada), BillingNotEnabledMapError (sem faturamento) ou RefererNotAllowedMapError (domínio não autorizado).", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q5", "name": "O mapa funciona no editor mas some na página. Por quê?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "No editor o script às vezes carrega sem a restrição que falha no front-end, ou um plugin de cache adia o script do Maps na página pública. Verifique a restrição de referenciador da chave e exclua o script do Maps do cache.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mapa-google-nao-aparece-wordpress/#faq-q6", "name": "Posso usar a mesma chave em vários sites?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Tecnicamente sim, mas não é recomendado. A restrição por referenciador prende a chave a um domínio. Para vários sites, gere uma chave por domínio, assim um uso indevido em um site não afeta a cota e a cobrança dos outros.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```