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:
- Confirme onde sua plataforma permite adicionar código personalizado: um bloco, um elemento ou a instalação de um app.
- 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.
- 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.
- 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.
| Requisito | O que faz | Fonte na Shopify |
|---|---|---|
| Registros de endereço | Loja ou ponto de retirada | Location object |
| Estoque por endereço | Estoque por produto | inventoryLevels |
| Filtro de produto | Mostrar item em estoque | storeAvailability |
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:
- A disponibilidade do produto se atualiza automaticamente a partir do estoque, ou alguém mantém isso à mão?
- 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 ›