11 min de lecture Store Locator
Code HTML d'un localisateur de magasins : le guide
Un décryptage simple de ce que contient vraiment le code HTML d'un localisateur de magasins, comment la géolocalisation et la recherche produit s'y intègrent, et où le coller sur chaque plateforme.
Le code HTML d'un localisateur de magasins est un petit embed : un élément conteneur plus une balise script qui charge une carte, lit vos données de localisation et trie les résultats par distance. Le fournisseur de carte, la méthode de géolocalisation et le fait que les clients puissent chercher par produit sont des choix séparés qui se greffent sur cette base.
Un commerçant écrit rarement ce code à la main. Une extension, une app ou un widget SaaS le génère généralement et vous remet un seul extrait à coller. Savoir ce qu'il contient reste utile, car cela montre ce que vous pouvez personnaliser.
Ce que l'extrait contient vraiment
Trois parties composent un localisateur de magasins fonctionnel. Une bibliothèque de carte affiche les tuiles et les épingles, avec Google Maps, Mapbox, Leaflet avec des tuiles OpenStreetMap, ou le moteur de rendu vectoriel propre à un fournisseur.
Une source de données de localisation fournit adresses et coordonnées, sous forme de tableau JSON statique, d'un fichier CSV converti en JSON, ou d'un appel API en direct. Une fonction de distance, presque toujours la formule de haversine sur la latitude et la longitude, trie les adresses selon leur éloignement du client.
La géolocalisation a besoin d'un plan B, pas seulement d'une demande
Un localisateur peut trouver le client de deux façons. La géolocalisation du navigateur demande une autorisation et renvoie une position précise de l'appareil, tandis qu'une estimation basée sur l'IP saute cette demande et renvoie à la place une estimation au niveau de la ville.
Les clients qui refusent cette demande attendent quand même une recherche "près de moi" fonctionnelle sur mobile. Une solution pratique consiste à basculer vers une estimation par IP ou une recherche d'adresse manuelle quand le client refuse la demande.
Où vous collez vraiment le code, selon la plateforme
Sur Shopify, les commerçants collent rarement du HTML. L'architecture du thème affiche le contenu des apps tierces via des app blocks, qui permettent à une app d'ajouter du contenu à un thème sans modifier son code, si bien qu'un localisateur s'installe comme un bloc plutôt que comme un extrait copié.
WordPress fonctionne plutôt via son éditeur de blocs : un shortcode déposé dans n'importe quel bloc affiche le localisateur sur cette page, sans HTML. Notre guide WordPress détaille l'installation complète d'une extension.
Code Block de Squarespace est l'endroit documenté pour du HTML personnalisé, bien que le JavaScript et les iframes qu'il contient demandent le plan Core ou supérieur. Wix propose à la place un élément Embed HTML pour coller un extrait, ou une app de localisateur depuis son App Market ; notre guide Wix couvre ce parcours.
Beaucoup d'autres créateurs de sites, dont Webflow, BigCommerce et Elementor, proposent un élément d'embed ou HTML similaire pour le même usage.
Une check-list avant de construire, code maison ou widget
Choisir entre une construction sur mesure et un widget prêt à l'emploi revient à quatre vérifications :
- Confirmez où votre plateforme vous permet d'ajouter du code personnalisé : un bloc, un élément ou une installation d'app.
- Vérifiez séparément les besoins en clé du fournisseur de carte ; Google Maps et Mapbox demandent chacun un identifiant propre au commerçant, et Google Maps exige en plus un compte de facturation.
- Décidez comment les données de localisation resteront à jour : modifications manuelles, feuille synchronisée, ou flux en direct depuis votre plateforme e-commerce.
- Testez la géolocalisation sur un vrai téléphone avec l'autorisation refusée, pas seulement accordée, car c'est là que la recherche "près de moi" échoue d'habitude.
Ce qu'exige vraiment la recherche au niveau produit
Un localisateur de magasins trouve un lieu. Un localisateur de produits répond à une question plus précise, laquelle de vos adresses a actuellement un article donné, ce qui demande des données de stock liées à chaque adresse, pas seulement une carte.
| Besoin | Ce que ça fait | Source Shopify |
|---|---|---|
| Fiches d'adresse | Magasin ou point de retrait | Location object |
| Stock par adresse | Stock par produit | inventoryLevels |
| Filtre produit | Montrer l'article en stock | storeAvailability |
Les lignes sur les adresses et le stock proviennent de la propre Location API de Shopify, et existent quelle que soit l'app installée. La disponibilité par adresse d'une variante est aussi exposée nativement via le champ storeAvailability de l'API Storefront, conçu pour le retrait en magasin, même si le transformer en filtre de carte reste le travail de l'app.
Posez deux questions à un éditeur avant de vous engager :
- La disponibilité produit se met-elle à jour automatiquement depuis le stock, ou quelqu'un la maintient-il à la main ?
- Que montre la page quand chaque adresse proche est épuisée ?
En conclusion
Un localisateur de magasins est prêt quand la carte charge proprement, qu'un test de géolocalisation avec autorisation refusée renvoie quand même des résultats proches, et qu'une recherche produit, si vous en avez construit une, exclut une adresse dont vous savez qu'elle est épuisée. Tout le reste est de la finition.
L'essentiel de cette décision porte sur les données, pas sur le design : où vivent vos adresses, à quel point elles restent fraîches, et si la disponibilité produit est suivie quelque part proche du temps réel. Réglez bien cela d'abord, et la carte en dessous devient la partie facile.
Questions fréquentes
Le code HTML d'un localisateur de magasins a-t-il besoin d'une clé API Google Maps ?
Seulement si vous choisissez Google Maps, ce qui demande la propre clé API du commerçant et un compte de facturation. Mapbox demande à la place son propre jeton d'accès, tandis que les cartes construites sur des données façon OpenStreetMap se passent entièrement de clé.
Quelle est la différence entre un localisateur de magasins et un localisateur de produits ?
Un localisateur de magasins montre où sont vos adresses. Un localisateur de produits montre laquelle de ces adresses a un article donné en stock à l'instant, ce qui demande des données de stock derrière la carte.
Puis-je ajouter un localisateur de magasins sans écrire de code ?
Oui : les apps, extensions et widgets SaaS génèrent l'embed pour vous. Progus Store Locator en est une option : un bloc de thème sur Shopify, un shortcode sur WordPress, une installation App Market sur Wix, géré depuis l'app Shopify ou le tableau de bord web ; ailleurs, c'est un seul extrait à coller.
La géolocalisation demande-t-elle toujours l'autorisation du client ?
Non. Une estimation basée sur l'IP peut situer un client au niveau de la ville sans aucune demande. Cela en fait un plan B raisonnable pour les clients qui refusent la demande du navigateur.
Ajoutez un store locator à votre site. En savoir plus sur Store Locator ›