11 min de leitura Store Locator

Código HTML de um localizador de lojas: o guia

Uma explicação simples do que o código HTML de um localizador de lojas realmente contém, como entram a geolocalização e a busca de produtos, e onde colá-lo em cada plataforma.

O código HTML de um localizador de lojas é um embed pequeno: um elemento container mais uma tag de script que carrega um mapa, lê seus dados de endereço e ordena os resultados por distância. O provedor de mapas, o método de geolocalização e se os clientes podem buscar por produto são escolhas separadas que se somam a essa base.

Um lojista raramente escreve esse código à mão. Normalmente um plugin, um app ou um widget SaaS o gera e entrega um único trecho para colar. Saber o que ele contém ainda ajuda, porque mostra o que você pode personalizar.

O que o trecho realmente contém

Três partes formam um localizador de lojas funcional. Uma biblioteca de mapas renderiza tiles e pinos, usando Google Maps, Mapbox, Leaflet com tiles do OpenStreetMap, ou o renderizador vetorial próprio de um provedor.

Uma fonte de dados de endereço fornece endereços e coordenadas, como um array JSON estático, um CSV convertido em JSON, ou uma chamada de API em tempo real. Uma função de distância, quase sempre a fórmula de haversine sobre latitude e longitude, ordena os endereços por quão longe estão do cliente.

A geolocalização precisa de um plano B, não só de um aviso

Um localizador pode encontrar o cliente de duas formas. A geolocalização do navegador pede permissão e retorna uma posição precisa do dispositivo, enquanto uma estimativa baseada em IP pula esse aviso e retorna em vez disso uma estimativa no nível da cidade.

Clientes que recusam esse aviso ainda esperam uma busca "perto de mim" funcional no celular. Uma solução prática é recorrer a uma estimativa por IP ou a uma busca manual de endereço quando o cliente recusa o aviso.

Onde você realmente cola o código, por plataforma

Na Shopify, lojistas raramente colam HTML. A arquitetura do tema renderiza conteúdo de apps de terceiros via app blocks, que permitem a um app adicionar conteúdo a um tema sem editar seu código, de modo que um localizador se instala como um bloco em vez de um trecho copiado.

O WordPress funciona em vez disso pelo seu Editor de blocos: um shortcode colocado em qualquer bloco renderiza o localizador nessa página, sem HTML. Nosso guia de WordPress percorre a configuração completa de um plugin.

Code Block do Squarespace é o lugar documentado para HTML personalizado, embora JavaScript e iframes dentro dele precisem do plano Core ou superior. O Wix oferece em vez disso um elemento Embed HTML para colar um trecho, ou um app de localizador do seu App Market; nosso guia de Wix cobre esse caminho.

Muitos outros construtores de sites, incluindo Webflow, BigCommerce e Elementor, oferecem um elemento de embed ou HTML parecido para o mesmo fim.

Uma checklist antes de construir, código próprio ou widget

Decidir entre uma construção própria e um widget pronto se resume a quatro verificações:

  1. Confirme onde sua plataforma permite adicionar código personalizado: um bloco, um elemento ou a instalação de um app.
  2. Verifique separadamente as exigências de chave do provedor de mapas; Google Maps e Mapbox exigem cada um uma credencial própria do lojista, e o Google Maps exige também uma conta de faturamento.
  3. Decida como os dados de endereço vão se manter atuais: edições manuais, uma planilha sincronizada, ou um feed em tempo real da sua plataforma de comércio.
  4. Teste a geolocalização em um celular real com a permissão negada, não só concedida, porque é aí que a busca "perto de mim" costuma falhar.

O que a busca em nível de produto realmente exige

Um localizador de lojas encontra um lugar. Um localizador de produtos responde a uma pergunta mais específica, qual dos seus endereços tem agora um item específico, e isso exige dados de estoque ligados a cada endereço, não só um mapa.

RequisitoO que fazFonte na Shopify
Registros de endereçoLoja ou ponto de retiradaLocation object
Estoque por endereçoEstoque por produtoinventoryLevels
Filtro de produtoMostrar item em estoquestoreAvailability

As linhas de endereço e estoque vêm da própria Location API da Shopify, e existem independentemente de qual app você instale. A disponibilidade por endereço de uma variante também é exposta nativamente pelo campo storeAvailability da Storefront API, feito para retirada na loja, embora transformar isso em um filtro de mapa ainda seja tarefa do app.

Faça duas perguntas a um fornecedor antes de decidir:

  1. A disponibilidade do produto se atualiza automaticamente a partir do estoque, ou alguém mantém isso à mão?
  2. O que a página mostra quando todo endereço próximo está sem estoque?

Considerações finais

Um localizador de lojas está pronto quando o mapa carrega sem problemas, um teste de geolocalização com permissão negada ainda retorna resultados próximos, e uma busca de produto, se você construiu uma, exclui um endereço que você sabe estar sem estoque. Tudo além disso é polimento.

A maior parte dessa decisão é sobre dados, não design: onde vivem seus endereços, quão atuais eles permanecem, e se a disponibilidade do produto é rastreada em algum lugar perto do tempo real. Acerte isso primeiro, e o mapa por baixo é a parte fácil.

Perguntas frequentes

O código HTML de um localizador de lojas precisa de uma chave de API do Google Maps?

Só se você escolher o Google Maps, que exige a própria chave de API do lojista e uma conta de faturamento. O Mapbox exige em vez disso seu próprio token de acesso, enquanto mapas construídos sobre dados ao estilo OpenStreetMap não precisam de chave nenhuma.

Qual é a diferença entre um localizador de lojas e um localizador de produtos?

Um localizador de lojas mostra onde estão seus endereços. Um localizador de produtos mostra qual desses endereços tem agora um item específico em estoque, o que exige dados de estoque atrás do mapa.

Posso adicionar um localizador de lojas sem escrever código?

Sim: apps, plugins e widgets SaaS geram o embed para você. Progus Store Locator é uma opção: um bloco de tema na Shopify, um shortcode no WordPress, uma instalação pelo App Market no Wix, gerenciado pelo app da Shopify ou pelo painel web; em qualquer outro lugar é um único trecho para colar.

A geolocalização sempre pede permissão ao cliente?

Não. Uma estimativa baseada em IP pode posicionar um cliente no nível da cidade sem nenhum aviso. Isso a torna um plano B razoável para clientes que recusam o aviso do navegador.

Adicione um localizador de lojas ao seu site. Saiba mais sobre Store Locator ›