Guia para 100% de page speed com o Google Maps

Incorpore o Google Maps sem perder page speed

Arjen Karel
Atualizado a · 6 min de leitura
Partilhar

Mapas ultrarrápidos em resumo

Infelizmente, o Google Maps tem pouco respeito pela pontuação do Lighthouse. A Google injeta um iframe, vários ficheiros JavaScript e folhas de estilo, todos a bloquear a renderização da página.

Não tem qualquer controlo sobre o que o Google Maps injeta na página. Para manter a velocidade, tem de garantir que a Google só carrega o mapa depois de o browser terminar a renderização e o paint do conteúdo mais importante.

A melhor forma de incorporar o Google Maps mantendo uma pontuação de 100% no PageSpeed Insights e no Lighthouse é usar uma imagem de placeholder, substituindo-a apenas quando um visitante interagir com o mapa. Isto chama-se facade pattern e funciona igualmente bem para embeds do YouTube.

Vamos mostrar como se faz!

Impacto do Google Maps nos Core Web Vitals

Há muitas razões para incorporar o Google Maps na página. É excelente, por exemplo, para mostrar a localização da empresa. Mas há um problema: o Google Maps não é tão rápido quanto se esperaria de um serviço da Google. Na verdade, o Google Maps na página drena imensa velocidade.

Custou 14% de uma pontuação perfeita de 100% de page speed. Eis o que faz às estatísticas do Google Lighthouse:

  1. First Contentful Paint + 0,8 s. O primeiro paint ocorre quase um segundo mais tarde porque o Google Maps interfere com o carregamento da página.
  2. Speed Index + 3,1 s. O Speed Index triplicou devido à renderização do mapa e ao bloqueio da main thread.
  3. Largest Contentful Paint + 0,8 s. O Largest Contentful Paint atrasa-se 0,8 segundos, exatamente como o First Contentful Paint.
  4. Time to Interactive + 6,5 s. Como o Google Maps depende fortemente de JavaScript, a página demora mais de 6 segundos a permitir a interação. Desde então, o Lighthouse substituiu o TTI pelo Total Blocking Time, mas a causa raiz é a mesma: o JavaScript do Google Maps bloqueia a main thread, prejudicando o Interaction to Next Paint (INP).
  5. Total Blocking Time + 320 ms. O Google Maps bloqueia a main thread durante 320 ms. É exatamente o que não queremos.
  6. Aviso «Remove unused JavaScript». Para piorar, surge mais um aviso a indicar que grande parte do JavaScript do Google Maps não está a ser utilizada. Tente explicar isso a um cliente.

Lighthouse score showing the impact of Google Maps on page speed

A primeira ideia pode ser recorrer ao lazy loading no iframe através do atributo loading="lazy". Isto até funciona nos browsers modernos, com 95% de cobertura global. Mas para obter o máximo desempenho, não chega. Em ligações rápidas, o Chrome começa a carregar iframes com lazy loading cerca de 1.250 px abaixo da viewport; em ligações lentas, fá-lo a 2.500 px. Se o mapa estiver perto da área visível, vai carregar durante a renderização inicial da página e competir com os recursos críticos. Para um impacto verdadeiramente nulo, use uma facade: não carregue rigorosamente nada até o utilizador interagir com o mapa.

Passo 1: Mapas estáticos

A opção mais simples é usar um mapa estático. Ou seja: em vez de um mapa interativo, usa apenas uma imagem do mapa. A vantagem é que uma imagem carrega muito mais depressa. A desvantagem é a ausência de interatividade: não é possível fazer zoom, scroll nem navegar.

Começamos com um mapa estático. Mais tarde, convertemos este mapa estático num mapa interativo que não interfere com a velocidade da página.

Há várias formas de colocar um mapa estático na página. Existem ferramentas para isso, como o Static Map Maker, mas exigem uma chave de API. Vou mostrar como descarregar a imagem de um mapa estático manualmente.

1. Coloque o mapa na página

Coloque o mapa na página. Aceda ao Google Maps, procure uma localização e clique em partilhar > incorporar mapa. Copie o código e cole-o na página. Agora clique com o botão direito na página e selecione 'inspecionar elemento'. Verá o inspetor de elementos na consola de desenvolvimento do browser. Localize o código do iframe, clique nele com o botão direito e selecione 'capture node screenshot'.

Taking a screenshot of a Google Maps iframe in Chrome DevTools

2. Converta a imagem estática para o formato WebP

A imagem do mapa que acabou de descarregar está em formato PNG. Como o objetivo é a velocidade da página, usamos o formato WebP, muito mais rápido. Pode converter a imagem online no ezgif ou diretamente com a ferramenta cwebp: cwebp -q 60 image.png -o image.webp.

Passo 2: Converter a imagem do mapa estático num mapa interativo

O mapa estático garante que não se perde velocidade durante o carregamento inicial. No momento do carregamento, ainda não temos um mapa interativo da Google. Depois do carregamento da página, substituímos o mapa estático em segundo plano por um mapa interativo. Só fazemos isso depois de a página ter sido renderizada e de o paint estar concluído. Há duas formas de o fazer: a primeira é substituir o mapa estático assim que passar o rato por cima; a segunda é substituí-lo assim que o browser estiver idle.

3. Coloque a imagem do mapa estático num placeholder

Como queremos que o mapa fique bem tanto no telemóvel como no desktop, usamos este truque de CSS. As proporções do mapa mantêm-se sempre corretas, qualquer que seja o tamanho do ecrã do visitante. Isto reserva espaço para o mapa e evita layout shift (CLS) quando o mapa interativo carregar. Adicionamos agora um atributo data-src ao contentor, que servirá mais tarde como URL de origem para o mapa da Google.

Primeiro, coloque o contentor do mapa na página:
<div data-src="https://maps.google.com/mapsq=fyn+()&z=9&output=embed" id="mymap"></div>

Adicione algum estilo na folha de estilos. Como se pode ver, usamos a imagem estática do mapa como imagem de fundo e aplicamos 76,25% de padding no topo para garantir o aspect ratio correto. O mapa final terá posicionamento absoluto sobre toda a largura e altura do mapa estático.

#mymap{
    background: url(/image.webp);
    background-size: cover;
    position: relative;
    overflow: hidden;
    padding-top: 76.25%;
}
#mymap iframe {
    position: absolute;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    border: 0;
}

4. Carregue o mapa interativo na primeira interação

É aqui que tudo acontece. Sem este pequeno bloco de JavaScript, o mapa não passa de uma imagem estática. Este JavaScript adiciona (e remove) um event listener ao contentor de placeholder e aguarda pelo evento 'mouseover' (ao passar o rato por cima do mapa estático) para injetar o mapa interativo no contentor.

const map = document.getElementById('mymap');
const mapListener = function(e) {
    const frame = document.createElement('iframe');
    frame.src = this.getAttribute('data-src');
    map.appendChild(frame);
    map.removeEventListener('mouseover', mapListener);
};
map.addEventListener('mouseover', mapListener);

5. Pré-carregue a imagem de fundo (opcional)

Se o mapa da Google estiver imediatamente visível na viewport, costuma ser boa ideia fazer o pré-carregamento da imagem de fundo. Use este código para pré-carregar a imagem estática do mapa: <link rel="preload" href="/image.webp" as="image" type="image/webp" crossorigin> e insira-o o mais cedo possível no <head> da página. Neste exemplo prático, o pré-carregamento da imagem de placeholder acelera o LCP em quase um segundo.

Passo 2b: Substituir a imagem estática do mapa automaticamente

Se a probabilidade de o visitante interagir com o mapa for alta, pode ser boa ideia não esperar pelo evento mouseover. Assim que o browser estiver idle, comece a injetar o mapa na página. O processo é praticamente o mesmo. Pode até combinar as duas abordagens.

4b. Carregue o mapa interativo automaticamente

Aqui usamos o evento 'load'. O evento load é um sinal emitido pelo browser assim que a página termina de carregar. Nessa altura, convertemos o mapa estático no mapa interativo! Para mais técnicas deste tipo, consulte 16 métodos para adiar JavaScript.

window.addEventListener('load',
    function(e) {
        const map = document.getElementById('mymap');
        const frame = document.createElement('iframe');
        frame.src = map.getAttribute('data-src');
        map.appendChild(frame);
});      

O resultado

Ao aplicar uma destas técnicas, vai notar que a página carrega com uma pontuação de 100% no Lighthouse e 100% no PageSpeed Insights, mantendo todas as funcionalidades do Google Maps!

100% Lighthouse score with Google Maps using the facade pattern

De acordo com o Web Almanac de 2025, 91% das páginas com iframes ainda não incluem qualquer atributo loading. Isto significa que a grande maioria das integrações do Google Maps carrega sem qualquer otimização. A abordagem com facade deixa-o muito à frente.

Para verificar se as alterações melhoram de facto a experiência real do utilizador, configure o Real User Monitoring. As pontuações de laboratório servem para debugging, mas o que a Google usa para o ranking são os field data de visitantes reais.

Boa sorte a acelerar o Google Maps. Precisa de ajuda? Então contacte-me!

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Precisa de um site mais rápido?

Sou o Arjen e há 17 anos que corrijo sites lentos. Se tem problemas que não consegue resolver sozinho, envie-me o seu URL e falamos.

Envie-me o seu URL
Arjen Karel
Arjen Karel, Consultor de web performance desde 2009

Porque é que o nosso fix não está a funcionar?

Por vezes a CDN ainda serve o HTML antigo, ou o fix foi feito no template de desktop e o mobile usa outro. Envie-me o seu URL e o problema, e respondo com alguns horários. Primeiro analiso os seus field data, depois dedicamos uma hora ao seu site, e no prazo de um dia tem as minhas notas por escrito. 350 € sem IVA.

Envie-me o seu URL

Sem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.

Arjen KarelCore Web Vitals a vermelho em mobile?Envie-me o seu URL