Plugin GMapMXN : utiliser la librairie Mapstraction dans GMap

À quoi sert ce plugin ?

GMapMXN met à disposition du plugin GMap une implémentation de carte qui permet d’utiliser l’interface graphique de plusieurs fournisseurs de services cartographique : Cloudmade, Google Maps, Bing, Open Layers, Ovi Nokia et Yahoo. Pour atteindre ce but, le plugin s’appuie s’appuie sur la librairie Mapstraction.

Une fois GMapMXN installé et activé, il s’intègre complètement à GMap en proposant simplement une nouvelle entrée dans la liste des implémentations disponibles.

Compatibilité et installation

GMapMXN n’a été testé que sur des versions de spip supérieures à 2.1.11. Il a peu de dépendances envers spip.

Le plugin a par contre une dépendance forte vis-à-vis de GMap. Il ne fonctionne qu’à partir de la version 0.1.3 et les icones spéciales pour Bing et Yahoo ne seront utilisées qu’avec une version de GMap supérieure à 0.1.4.

GMapMXN utilise la librairie Mapstraction en version 2.0.17, elle doit être installée dans le dossier lib/h12833bc5-mxn-2.0.17 du site. L’utilisation d’une autre version de Mapstraction n’est possible qu’en intervenant dans le code du plugin.
Quand le plugin est activé, SPIP propose de télécharger automatiquement la librairie dans le dossier /lib situé à la racine de votre site, ce dossier doit exister pour que l’opération réussisse.

Le plugin s’installe selon la procédure habituelle de SPIP (voir Installer un plugin).

Configuration

GMapMXN n’est actif qu’après avoir sélectionner Mapstraction comme API cartographique dans le paramétrage système de GMap.

Une fois activé, le paramétrage spécifique à l’API permet de choisir le fournisseur de l’API. Pour chaque fournisseur, l’interface indique les plus caractéristique les plus importantes. Quand c’est nécessaire, une zone permet de saisir la clef d’activation nécessaire.

Dans la configuration de l’interface utilisateur, seules les possibilités offertes par le fournisseur sont disponibles. Pour certains fournisseurs, il est nécessaire de valider les modifications pour les voir apparaître sur la carte, GMapMXN affiche un message d’avertissement quand c’est le cas.

Utilisation en géolocalisation

Après le paramétrage, l’interface de géolocalisation utilise l’API cartographique sélectionnée.

L’option de recherche d’un point par adresse n’est disponible que pour les fournisseurs qui intègrent un geocoder. Il n’est actuellement pas possible d’utiliser un autre fournisseur de service pour le geocoder.

Sur la carte elle-même, le déplacement du point central par glisser-déplacer n’est pas possible. La modification du point se fait par un simple clic sur la carte.

Rendu final des cartes

Sur le site public, le rendu des cartes utilise le fournisseur sélectionné. La fonction de regroupement des info-bulles n’est pas disponible avec l’implémentation Mapstraction.

Bing et Yahoo ne permettent pas de définir le point d’ancrage des icones. Pour contourner le problème, GMapMXN contient deux thèmes graphiques spécifiques à chacun de ces fournisseurs.
Attention : lors du changement de fournisseur, il peut être nécessaire de vider le cache avant que les cartes utilisent le nouveau thème graphique. Il faut en effet que les requêtes passées pour obtenir les points à représenter soit recalculées.

Pour Bing, il s’agit d’un rond, le point d’ancrage est au centre.

Pour Yahoo, le point d’ancrage est en bas à gauche de l’image.

Possibilités selon le fournisseur