10 min di lettura Store Locator

Codice HTML per uno store locator: cosa serve

Una spiegazione semplice di cosa contiene davvero il codice HTML di uno store locator, come entrano geolocalizzazione e ricerca prodotto, e dove incollarlo su ogni piattaforma.

Il codice HTML di uno store locator è un piccolo embed: un elemento contenitore più un tag script che carica una mappa, legge i tuoi dati sui punti vendita e ordina i risultati per distanza. Il provider di mappe, il metodo di geolocalizzazione e se i clienti possono cercare per prodotto sono scelte separate che si aggiungono su questa base.

Un commerciante raramente scrive questo codice a mano. Di solito un plugin, un'app o un widget SaaS lo genera e ti consegna un unico snippet da incollare. Sapere cosa contiene resta utile, perché mostra cosa puoi personalizzare.

Cosa contiene davvero lo snippet

Tre parti compongono uno store locator funzionante. Una libreria di mappe disegna tile e pin, usando Google Maps, Mapbox, Leaflet con tile OpenStreetMap, o il renderer vettoriale proprio di un provider.

Una fonte di dati sui punti vendita fornisce indirizzi e coordinate, come array JSON statico, un CSV convertito in JSON, o una chiamata API in diretta. Una funzione di distanza, quasi sempre la formula haversine su latitudine e longitudine, ordina i punti vendita in base a quanto distano dal cliente.

La geolocalizzazione ha bisogno di un piano B, non solo di una richiesta

Un locator può trovare il cliente in due modi. La geolocalizzazione del browser chiede il permesso e restituisce una posizione precisa del dispositivo, mentre una stima basata su IP salta quella richiesta e restituisce invece una stima a livello di città.

I clienti che rifiutano quella richiesta si aspettano comunque una ricerca "vicino a me" funzionante da mobile. Una soluzione pratica è ricorrere a una stima basata su IP o a una ricerca manuale dell'indirizzo quando il cliente rifiuta la richiesta.

Dove incolli davvero il codice, per piattaforma

Su Shopify i commercianti incollano raramente HTML. L'architettura del tema mostra i contenuti delle app di terze parti tramite app blocks, che permettono a un'app di aggiungere contenuti a un tema senza modificarne il codice, così un locator si installa come blocco invece che come snippet copiato.

WordPress funziona invece tramite il suo Block Editor: uno shortcode inserito in qualsiasi blocco mostra il locator su quella pagina, senza HTML. La nostra guida su WordPress illustra la configurazione completa di un plugin.

Code Block di Squarespace è il posto documentato per HTML personalizzato, anche se JavaScript e iframe al suo interno richiedono il piano Core o superiore. Wix offre invece un elemento Embed HTML per incollare uno snippet, oppure un'app locator dal suo App Market; la nostra guida su Wix copre quel percorso.

Molti altri builder di siti, tra cui Webflow, BigCommerce ed Elementor, offrono un elemento embed o HTML simile per lo stesso scopo.

Una checklist prima di costruire, codice proprio o widget

Scegliere tra una costruzione personalizzata e un widget pronto si riduce a quattro verifiche:

  1. Conferma dove la tua piattaforma ti permette di aggiungere codice personalizzato: un blocco, un elemento o l'installazione di un'app.
  2. Controlla separatamente i requisiti di chiave del provider di mappe; Google Maps e Mapbox richiedono entrambi una credenziale propria del commerciante, e Google Maps richiede anche un account di fatturazione.
  3. Decidi come i dati sui punti vendita resteranno aggiornati: modifiche manuali, un foglio sincronizzato, o un feed in diretta dalla tua piattaforma e-commerce.
  4. Testa la geolocalizzazione su un telefono reale con il permesso negato, non solo concesso, perché è lì che la ricerca "vicino a me" di solito fallisce.

Cosa richiede davvero la ricerca a livello di prodotto

Uno store locator trova un luogo. Un localizzatore di prodotti risponde a una domanda più precisa, quale dei tuoi punti vendita ha ora un articolo specifico, e questo richiede dati di inventario legati a ogni punto vendita, non solo una mappa.

RequisitoCosa faFonte Shopify
Record di punto venditaNegozio o punto di ritiroLocation object
Inventario per punto venditaScorte per prodottoinventoryLevels
Filtro prodottoMostra articolo disponibilestoreAvailability

Le righe su punto vendita e inventario provengono dalla Location API propria di Shopify, ed esistono indipendentemente da quale app installi. La disponibilità per punto vendita di una variante è anche esposta nativamente tramite il campo storeAvailability della Storefront API, pensato per il ritiro in negozio, anche se trasformarlo in un filtro mappa resta compito dell'app.

Fai due domande a un fornitore prima di decidere:

  1. La disponibilità del prodotto si aggiorna automaticamente dall'inventario, o la mantiene qualcuno a mano?
  2. Cosa mostra la pagina quando ogni punto vendita vicino è esaurito?

Conclusioni

Uno store locator è pronto quando la mappa carica senza problemi, un test di geolocalizzazione con permesso negato restituisce comunque risultati vicini, e una ricerca prodotto, se ne hai costruita una, esclude un punto vendita che sai essere esaurito. Tutto il resto è rifinitura.

Gran parte di questa decisione riguarda i dati, non il design: dove vivono i tuoi punti vendita, quanto restano aggiornati, e se la disponibilità del prodotto viene tracciata vicino al tempo reale. Fai bene questo prima, e la mappa sotto diventa la parte facile.

Domande frequenti

Il codice HTML di uno store locator richiede una chiave API Google Maps?

Solo se scegli Google Maps, che richiede la chiave API propria del commerciante e un account di fatturazione. Mapbox richiede invece un proprio token di accesso, mentre le mappe costruite su dati in stile OpenStreetMap fanno a meno della chiave del tutto.

Qual è la differenza tra uno store locator e un localizzatore di prodotti?

Uno store locator mostra dove sono i tuoi punti vendita. Un localizzatore di prodotti mostra quale di quei punti vendita ha ora disponibile un articolo specifico, il che richiede dati di inventario dietro la mappa.

Posso aggiungere uno store locator senza scrivere codice?

Sì: app, plugin e widget SaaS generano l'embed per te. Progus Store Locator è un'opzione: un blocco tema su Shopify, uno shortcode su WordPress, un'installazione dall'App Market su Wix, gestito dall'app Shopify o dalla dashboard web; altrove è un unico snippet da incollare.

La geolocalizzazione chiede sempre il permesso al cliente?

No. Una stima basata su IP può posizionare un cliente a livello di città senza alcuna richiesta. Questo la rende un piano B ragionevole per i clienti che rifiutano la richiesta del browser.

Aggiungi uno store locator al tuo sito. Scopri Store Locator ›