Quelles sont les 10 erreurs et solutions sur Google Maps Prestashop ?
tableau comparatif des 10 erreurs fréquentes liées à Google Maps dans PrestaShop
| # | Erreur Google Maps sur PrestaShop | Impact | Prix estimé de correction (€) | Commentaire |
|---|---|---|---|---|
| 1 | Clé API Google Maps absente ou invalide | Carte ne s'affiche pas du tout | 30 – 80 | Il faut créer/configurer une clé API avec les bons droits |
| 2 | Erreur "For development purposes only" | Carte avec filigrane, usage limité | 40 – 90 | La facturation API n'est pas activée chez Google Cloud |
| 3 | Mauvais chargement JS de l’API Maps | Carte blanche ou gelée | 50 – 100 | Conflit de scripts ou erreur d’ordre de chargement |
| 4 | Point de géolocalisation incorrect | Affiche un lieu erroné ou trop éloigné | 40 – 70 | Mauvais paramétrage des coordonnées ou adresse mal codée |
| 5 | Carte qui ne s’affiche pas sur mobile | Perte d’UX en version responsive | 60 – 110 | Problème CSS, JS ou conteneur non adapté |
| 6 | Conflit avec d’autres modules utilisant Maps | Carte ne charge pas ou bugge | 70 – 120 | Nécessite souvent un débogage JS et des namespaces API |
| 7 | Mauvaise configuration multi-boutiques | Carte affiche toujours la même adresse | 50 – 100 | Problème dans le back-office ou le hook multistore |
| 8 | Lenteur au chargement de la carte | Dégradation UX / SEO | 60 – 90 | Optimisation des appels API + lazyload conseillé |
| 9 | Aucune interaction possible avec la carte (zoom, drag) | UX réduite | 30 – 60 | Paramètres JS de la carte à revoir (draggable: false, etc.) |
| 10 | Affichage erroné dans les modules de point relais (GLS, Mondial Relay…) | Sélection impossible ou imprécise | 80 – 150 | Liaison API + Google Maps + JS personnalisés à corriger |
1. Erreur d’affichage de Google Maps dans les fiches produits avec déclinaisons multiples sur PrestaShop
Lorsque Google Maps est intégré dans les fiches produits pour afficher la disponibilité en boutique, l’apparition de plusieurs déclinaisons peut provoquer des erreurs de chargement ou un mauvais positionnement de la carte. Ce bug survient souvent après un changement d’attribut (taille, couleur) qui recharge dynamiquement une partie de la page sans recharger la carte correctement.
Dans ce cas, le script de Google Maps n’est pas relancé après la sélection de la déclinaison, laissant la carte vide ou figée. Pour corriger cela, il faut intégrer une fonction JavaScript qui relance Google Maps après chaque changement d’attribut, en s’assurant que l’API est bien rechargée dans le DOM.
2. Google Maps ne localise pas correctement les déclinaisons selon la disponibilité en stock par boutique PrestaShop
Dans une configuration multiboutique avec stock localisé, il est possible d’utiliser Google Maps pour indiquer où une déclinaison est disponible. Toutefois, Google Maps affiche parfois une localisation incorrecte, car il ne prend pas en compte les déclinaisons dans la logique de disponibilité.
Cette erreur est liée à un mauvais filtrage des produits par déclinaison dans le code qui alimente la carte. Une requête SQL ou une logique serveur personnalisée est souvent nécessaire pour afficher uniquement les boutiques où la bonne déclinaison est réellement disponible, afin d’éviter une confusion pour les clients.
3. Mauvais recalcul des points de livraison Google Maps après sélection d’une déclinaison dans le tunnel de commande
Certains modules utilisant Google Maps (comme ceux pour la livraison en point relais) peuvent afficher des points incorrects ou incomplets après sélection d’une déclinaison dans le panier. Cela s’explique par une absence de recalcul du poids ou des dimensions du colis, modifiés par la déclinaison choisie.
Résultat : Google Maps continue d’afficher les points relais valables pour l’ancienne configuration produit. Il faut mettre à jour dynamiquement les paramètres logistiques (poids, dimensions) chaque fois qu’une déclinaison est sélectionnée, afin que la carte affiche les bons relais disponibles selon les critères GLS ou Mondial Relay.
4. Incompatibilité entre les modules de géolocalisation Google Maps et les déclinaisons personnalisées dans PrestaShop
Certaines boutiques utilisent des modules de personnalisation avancée pour les déclinaisons (ex : champ texte, image, gravure). Ces modules modifient souvent la structure HTML/JS des pages, ce qui peut casser le fonctionnement de Google Maps, notamment lors de la validation d’adresse ou du choix d’un point relais.
Le problème vient du fait que Google Maps n’interprète plus correctement la structure DOM et ne déclenche plus ses fonctions. Il est alors nécessaire de vérifier la compatibilité entre les modules de déclinaisons personnalisées et ceux qui embarquent Google Maps, en harmonisant les événements JavaScript ou en ajoutant des déclencheurs spécifiques.
5. Carte Google Maps qui disparaît après changement de déclinaison dans la fiche produit PrestaShop
Lorsque le client change une déclinaison (ex : couleur ou taille) dans une fiche produit, la carte Google Maps affichant par exemple les magasins proches ou le stock disparaît parfois sans message d’erreur. C’est un bug courant lié à l’AJAX utilisé pour recharger les informations sans recharger complètement la page.
Pour résoudre ce problème, il faut s'assurer que le script d’initialisation de Google Maps est relancé après le changement de déclinaison. Une fonction JavaScript personnalisée, déclenchée via un observer ou un événement DOM, permet de recharger correctement la carte et d’améliorer l’expérience utilisateur sans rechargement complet de la page.
6. Erreur de zoom ou de centrage sur la carte Google Maps après sélection de déclinaison en PrestaShop
Certains utilisateurs constatent que le zoom ou le centrage de la carte Google Maps est erroné après avoir sélectionné une déclinaison dans la fiche produit ou le tunnel de commande. Cela est souvent causé par un changement de gabarit HTML qui empêche la carte de se recentrer automatiquement.
Il est important de recoder la fonction initMap() ou d'utiliser google.maps.event.trigger(map, 'resize') après chaque mise à jour de la déclinaison. Cela permet de recentrer la carte sur le bon emplacement et d’afficher les points (boutiques, relais) correctement, sans forcer le client à interagir manuellement.
7. Les déclinaisons changent le poids du produit mais Google Maps n’adapte pas les points relais disponibles
Une déclinaison peut augmenter ou diminuer le poids d’un produit (ex : un meuble de taille XL). Toutefois, certains modules basés sur Google Maps ne recalculent pas dynamiquement les points relais disponibles. Le client peut alors sélectionner un point relais inadapté, ce qui bloquera l’expédition.
Il est nécessaire de s'assurer que le module prend en compte les changements de poids liés aux déclinaisons. Cela implique souvent une communication AJAX avec le serveur à chaque sélection pour recalculer les points disponibles via Google Maps. Sans cela, les choix de livraison ne seront pas fiables.
8. Carte Google Maps non responsive après ajout de déclinaisons dans le thème PrestaShop
Certains thèmes PrestaShop personnalisés intègrent mal la carte Google Maps dans les blocs contenant les déclinaisons. Sur mobile, la carte peut dépasser, se figer ou ne pas s’afficher du tout. Cela est causé par une mauvaise gestion CSS ou par des conteneurs dynamiques qui ne redimensionnent pas la carte.
Il faut alors adapter le CSS de la carte (width: 100%; height: auto;) et veiller à ce que la carte se redimensionne bien après le chargement d’une déclinaison. Il peut aussi être nécessaire d’utiliser un resize event JavaScript pour forcer l’ajustement une fois les nouveaux éléments chargés.
9. Google Maps affiche des erreurs JS en console après ajout d’attributs de déclinaison en AJAX
Lorsque les déclinaisons sont chargées dynamiquement via AJAX (sans rechargement de page), certaines erreurs JavaScript apparaissent dans la console. Cela peut casser la carte Google Maps ou désactiver certaines interactions comme le zoom ou le clic sur les marqueurs.
Le script Google Maps doit être encapsulé dans une fonction qui peut être appelée à chaque fois que le DOM est mis à jour. Il est déconseillé de laisser le code dans un simple <script> en bas de page. Une intégration modulaire ou l’utilisation de frameworks comme jQuery .on('change') permet une meilleure gestion des rechargements.
10. Impossibilité de valider la commande après choix d’une déclinaison et sélection de point sur Google Maps
Certains bugs empêchent la validation de commande lorsqu’un client choisit une déclinaison puis sélectionne un point relais via Google Maps. Le système considère parfois les informations comme incomplètes ou non valides, surtout si le widget de carte ne met pas à jour correctement les champs cachés du formulaire.
Il faut s’assurer que la carte envoie les bonnes coordonnées (latitude, longitude, ID du relais) au moment du submit. Si le formulaire de commande ne reçoit pas ces données, la commande échouera. Une validation JavaScript côté client ou un contrôle serveur peut aider à sécuriser ce processus.
