Afin de détecter la latitude et la longitude d'une adresse, une clé API de géocodage est requise. Multi-Terr prend en charge les fournisseurs de géocodage suivants : Geoapify, Google et Here Maps.

L'application est livrée avec une clé API par défaut, mais comme le nombre d'appels est limité et partagé entre toutes les congrégations utilisant l'application, nous recommandons que chaque congrégation obtienne sa propre clé API.

🔧 Instructions de configuration

1. Obtenir une clé API
   Suivez les instructions sous l'une des trois options ci-dessous pour générer votre clé API.
2. Copier la clé
   Une fois votre clé API créée, copiez-la dans votre presse-papiers.
3. Accéder au menu API
   Accédez à l'onglet Admin et ouvrez la section Clés API pour saisir votre clé.
4. Entrer la clé API
   Insérez la clé copiée dans le champ prévu à cet effet en utilisant soit clic droit > Coller soit le raccourci clavier Ctrl + V. Puis cliquez sur le bouton Enregistrer.

 Clé API Geoapify (recommandée)

Les clés API Geoapify sont fortement recommandées car elles offrent une limite d'utilisation quotidienne gratuite généreuse et ne nécessitent pas de carte de crédit pour commencer.

🛠️ Guide étape par étape pour obtenir une clé API Geoapify

1. Créer un compte Geoapify
   • Rendez-vous sur le site Geoapify et inscrivez-vous pour un compte gratuit. Aucune carte de crédit n'est requise.
     • Premiers pas avec Geoapify : Partie 1 - Créer un compte créé par Geoapify vous guide dans le processus d'inscription et de vérification par e-mail.
2. Configurer un projet
   • Une fois connecté, allez dans la section “Mes projets”.
   • Cliquez sur “Créer un projet” et donnez-lui un nom (par exemple : MT_MA_CONGRÉGATION).
3. Copier votre clé API
   • Cliquez sur l'icône de copie dans la section Clés API

 Clé API Google

L'API Google nécessite une carte de crédit pour l'activation ; cependant, vous pouvez configurer une limite d'utilisation quotidienne pour éviter les frais inattendus — une fois la limite atteinte, vous recevrez une erreur au lieu d'encourir des frais. De plus, nous recommandons de restreindre la clé API à une utilisation exclusive sur https://multi-terr.com, ce qui aide à la protéger contre une utilisation non autorisée sur d'autres domaines. Veuillez noter que Multi-Terr n'est pas responsable des frais résultant de l'utilisation de l'API.

🗺️ Comment obtenir une clé API de géocodage Google

1. Créer un projet Google Cloud

• Allez sur la Console Google Cloud.
• Cliquez sur "Sélectionner un projet" → "Nouveau projet" → donnez-lui un nom et cliquez sur "Créer".

2. Activer la facturation

• Accédez à Facturation dans la barre latérale.
• Associez un compte de facturation à votre projet (requis pour l'utilisation de l'API, même dans le cadre gratuit).

3. Activer l'API de géocodage

• Allez dans APIs & Services > Bibliothèque.
• Recherchez Geocoding API et cliquez sur Activer.

4. Créer une clé API

• Allez dans APIs & Services > Identifiants.
• Cliquez sur "Créer des identifiants" → choisissez Clé API.
• Une clé sera générée — copiez-la dans un endroit sûr.

🔒 Comment restreindre une clé API à un seul site web

1. Définir les restrictions d'application

• Dans la section Identifiants, cliquez sur votre clé API.
• Sous Restrictions d'application, choisissez Référents HTTP (sites web).
• Ajoutez votre domaine comme : https://multi-terr.com

2. Définir les restrictions d'API

• Faites défiler jusqu'à Restrictions d'API.
• Sélectionnez Restreindre la clé.
• Choisissez uniquement Geocoding API dans la liste.

3. Enregistrer les modifications

• Cliquez sur Enregistrer pour appliquer les restrictions.

📊 Définir une limite de quota quotidienne pour l'API de géocodage

1. Ouvrir la Console Google Cloud

• Allez sur Google Cloud Console.
• Sélectionnez votre projet dans la barre de navigation supérieure.

2. Accéder aux quotas

• Dans la barre latérale gauche, allez dans IAM & Admin > Quotas.

3. Filtrer pour Geocoding API

• Utilisez la barre de filtre pour rechercher Geocoding API.
• Recherchez le quota intitulé Requêtes par jour.

4. Modifier le quota

• Cochez la case à côté de Requêtes par jour.
• Cliquez sur Modifier les quotas en haut de la page.
• Remplissez le formulaire avec votre limite souhaitée (par exemple : 300).
• Soumettez la demande.

 Clé API Here (non recommandée)

HERE Maps nécessite une carte de crédit et ne permet pas de définir une limite d'utilisation quotidienne, ce qui présente un risque de frais importants. Pour cette raison, nous ne recommandons cette option que si elle est configurée par une personne expérimentée dans l'API HERE Maps et si la congrégation est prête à assumer l'entière responsabilité des coûts associés. Veuillez noter que Multi-Terr n'est pas responsable des frais résultant de l'utilisation de l'API.

🛠️ Étapes à suivre : Configuration de l'API de géocodage HERE

1. Créer un compte développeur HERE

• Accédez au Portail développeur HERE et inscrivez-vous ou connectez-vous.

2. Créer un projet

• Une fois connecté, accédez à votre tableau de bord.
• Cliquez sur « Créer un projet » et donnez-lui un nom (par exemple : « GeocodingApp »).

3. Générer une clé API

• Dans votre projet, accédez aux identifiants « REST ».
• Cliquez sur « Créer une clé API ».
• Copiez la clé — vous l’utiliserez dans vos requêtes API.

Notes

• IMPORTANT : Multi-Terr n'est pas responsable des frais résultant de l'utilisation de l'API.

Articles connexes

🕘 Mis à jour: 2025-08-28