WP Location Finder: Configuration de l'API MAP

1. Comment créer une API de carte ?

1.1 Obtenez les services de clé API et d'API Google Maps

A chaque fois que vous utilisez les API Google Maps, si votre domaine a été créé après le 22 juin 2016, vous devez inclure une clé, pour valider votre demande.
Obtenez une clé et activez l'API : https://developers.google.com/maps/documentation/javascript/get-api-key

Plus d'informations : https://developers.google.com/maps/documentation/javascript/usage?hl=en

Tout d'abord, vous devez accéder à Google Cloud Console , sélectionner un projet ou en créer un nouveau. Cliquez ensuite sur "+ Créer des informations d'identification" , sélectionnez "Key API" .

Suivez ensuite l'étape suivante et cliquez sur Créer pour obtenir une nouvelle clé API. Enregistrez-le pour l'étape suivante.

De plus, certains services API requis doivent être activés. Dans la console Google, allez dans API & Services et trouvez-les comme indiqué ci-dessous:

• Cartes API JavaScript
• API géocodante
• API de géolocalisation
• Place API
• API Directions

1.2 Comment créer un identifiant Google Map ?

Afin de créer un ID de carte, veuillez accéder à de gestion des cartes . Cliquez sur Créer ID de carte .

Ensuite, sur la page Créer une nouvelle carte de carte, procédez comme suit:

• Nom: Entrez le nom de l'ID de carte.
• Description: Décrivez à quoi est utilisé l'ID de carte (facultatif)
• Type de carte: sélectionnez JavaScript et choisissez également un raster (la valeur par défaut) ou un type de carte vectoriel.

N'oubliez pas de cliquer sur Enregistrer pour afficher votre nouvel ID de carte. Veuillez le garder pour le paramètre.

1.3 Comment créer un jeton OpenStreetMap ?

Commencez par vous rendre ici pour créer un nouveau compte ou vous connecter à votre compte existant. Cette étape est essentielle avant de pouvoir générer des jetons d'accès.

Une fois connecté, recherchez l' « Jetons d'accès » dans vos paramètres utilisateur ou dans le menu de votre compte et sélectionnez-la. Dans la section « Jetons d'accès », sélectionnez l' « Créer un jeton d'accès » pour lancer le processus de génération. Tous les champs de création de jeton seront visibles directement sur la page « Jetons d'accès ». Pour créer votre jeton :

• Saisissez un nom descriptif dans le « Étiquette » pour vous aider à identifier ce jeton ultérieurement.
• Laissez les deux champs supplémentaires ci-dessous vides (les paramètres par défaut sont suffisants pour la plupart des utilisateurs)
• Cliquez sur le « Créer » pour générer votre nouveau jeton d'accès

Votre nouveau jeton d'accès s'affichera une fois créé. Veillez à le copier et à le conserver en lieu sûr, car vous l'utiliserez lors des étapes de configuration ultérieures.

2. Section Paramètres principaux

Fournisseur de cartes

Accédez à Menu Localisation > Paramètres > Paramètres principaux pour configurer vos préférences de fournisseur de cartes. Vous trouverez deux fournisseurs de cartes disponibles : Google et OpenStreetMap .

Si vous choisissez Google Maps comme fournisseur, vous devrez configurer les champs obligatoires suivants avec les informations d'identification des étapes de configuration précédentes :

• Clé API Google Maps : La clé API Google Maps est obligatoire. Veuillez revenir à l'étape 1.1 si vous ne savez pas comment créer une nouvelle clé API.
• ID de carte: Un ID de carte est un identifiant unique qui représente les paramètres de style et de configuration de la carte Google qui sont stockés dans Google Cloud.
  Ceci est obligatoire d'en avoir un, vous pouvez garder celui par défaut (Demo_Map_ID) si vous n'en avez pas besoin.
• Carte Zoom par défaut: Niveau de zoom par défaut sur la carte lors de la première charge (définissez Auto Zoom sur 0)
• Type de cartes : Feuille de route, Satellite, Hybride, Terrain.
• Couche de cartes : KML, trafic, transit, cyclisme.

Si vous sélectionnez OpenStreetMap comme fournisseur, vous devrez saisir le jeton d'accès que vous avez obtenu à l'étape 1.3 :

• Jeton d'accès de géocodage : le jeton d'accès LocationIQ est requis pour la fonctionnalité de saisie semi-automatique des adresses.
• Carte Zoom par défaut: Niveau de zoom par défaut sur la carte lors de la première charge (définissez Auto Zoom sur 0)
• Type de carte : Par défaut, OpenStreetMap HOT, Carto Light, Carto Dark,...
• Calque de tuiles personnalisé : saisissez votre calque personnalisé.

Après avoir configuré les paramètres de votre fournisseur de cartes, vous découvrirez plusieurs fonctionnalités de personnalisation qui fonctionnent à la fois avec Google Maps et OpenStreetMap pour améliorer les fonctionnalités de votre carte et l'expérience utilisateur :

• Afficher le filtre de catégorie
• Filtre d'affichage du pays
• Filtre à rayon d'affichage
• Unité de distance : km/mi
• Distance pour la recherche de rayon: distance dans l'outil de recherche de rayon
• Filtre d'étiquette d'affichage
• Ouvrir le détail de l'emplacement dans un nouvel onglet

Affichage de la carte

Les emplacements que vous avez créés seront affichés sur la carte dans la Paramètres .

Image couleur et marqueur

Vous pouvez ajuster la couleur et l'image du marqueur par défaut ici.

Emplacement unique

• Ajouter des champs de magasin: ajoutez des champs spécifiques à chaque emplacement comme les noms de magasin et les heures d'ouverture du magasin

3. Générateur de shortcode

Pour générer un code court pour une carte, accédez à Menu Location Finder > Générateur de code court. Vous pouvez définir les options ci-dessous, dans la section Type d'affichage :

• Recherche de localisation : [wplf type_of_view="location_search" default_address="Paris, France" categories="16" tags="27" map_zoom="Auto"]
• Vue carte uniquement : [wplf type_of_view="map_view" default_address="Paris, France" categories="16" tags="27" map_zoom="Auto"]
• Emplacement unique : [wplf id="578" map_zoom="Auto"]
• Formulaire de soumission frontend : [wplf_submission]
• Mes emplacements (interface utilisateur) : [wplf_my_locations items_per_page="8"]

Selon le type d'affichage sélectionné, un aperçu s'affichera pour vous montrer son rendu sur le site. Le code court généré apparaîtra en bas à gauche ; vous pourrez alors le copier et l'insérer où vous le souhaitez sur votre page.

4. Catégories d'emplacement

Pour gérer les catégories d'emplacement, veuillez accéder au menu Location Finder> Catégories de localisation.  À partir de cette section, vous pouvez gérer sans effort vos catégories de localisation - ajouter, modifier ou les supprimer au besoin!

5. Balises de localisation

Pour gérer les balises d'emplacement, veuillez accéder au menu Emplacement Finder> Tags de localisation. À partir de cette section, vous pouvez gérer sans effort vos balises de localisation - ajouter, modifier ou les supprimer au besoin!

6. Lieux d'importation/exportation

Lieux d'importation

Pour commencer à importer vos emplacements, accédez à « Recherche d'emplacement » > « Paramètres » > « Importer » . Choisissez votre CSV ou KML dans le champ approprié, en fonction de votre format de données actuel.

Besoin d'un modèle ? Cliquez simplement sur le « Télécharger un exemple de fichier CSV » pour obtenir notre exemple et voir le format approprié. Vous pouvez également cocher l' « Mettre à jour les emplacements existants s'ils correspondent ou ajouter de nouveaux emplacements inexistants » pour mettre à jour vos données actuelles tout en ajoutant de nouvelles entrées.

Lieux d'exportation

Lorsque vous êtes prêt à exporter vos emplacements existants, accédez à la Exporter . Cliquez ensuite sur le « Exporter au format CSV » ou « Exporter au format KML », selon le format souhaité.

Synchronisation

Pour configurer la synchronisation automatique des fichiers CSV, accédez à Paramètres, puis à l'onglet Importation/Exportation > Synchronisation et sélectionnez votre fichier CSV dans la bibliothèque multimédia. Activez l' « Activer la synchronisation automatique » et indiquez la fréquence de mise à jour souhaitée dans le « Intervalle de synchronisation (minutes) » .

Le système importera automatiquement les données à des intervalles choisis, en mettant à jour les emplacements existants lorsque des correspondances sont trouvées et en créant de nouvelles entrées pour des données supplémentaires.

7. Contrôle d'accès

Pour gérer les autorisations de localisation (créer, modifier, supprimer, publier) pour chaque rôle utilisateur, accédez à Paramètres > Contrôle d'accès .