Cette page est également disponible en anglais.

Atlas Pickup Points utilise deux clés API Google Maps : une Clé API publique pour afficher la carte, et une Clé API privée (recommandée) pour la recherche d’adresse et la saisie semi-automatique d’adresse. Si vous n’ajoutez pas de Clé API privée, Atlas utilise un service de secours intégré pour localiser l’adresse de l’acheteur, mais la saisie semi-automatique d’adresse n’est pas disponible. Google Maps Platform est un service payant, mais le palier gratuit suffit pour la plupart des boutiques. Consultez la FAQ sur les tarifs pour plus de détails.

#Pourquoi deux clés ?

Nous utilisons deux clés distinctes pour des raisons de sécurité.

La Clé API publique sert à afficher la carte. Elle est envoyée au navigateur de l’acheteur, c’est pourquoi nous recommandons d’activer les restrictions de sites web afin d’empêcher toute utilisation non autorisée sur d’autres sites.

La Clé API privée sert à la recherche d’adresses. Contrairement à la Clé API publique, elle n’est jamais envoyée au navigateur. Elle est stockée de manière sécurisée dans notre base de données et vous seul pouvez y accéder. Cette clé utilise l’API Geocoding et l’API Places, qui communiquent avec Google depuis notre serveur. Les restrictions de sites web ne peuvent pas s’appliquer à cette clé, car les requêtes proviennent de notre serveur et non de votre site.

#Configuration

Remarque : les noms de boutons et d’options de la console Google ci-dessous sont indiqués en anglais. Si votre console Google Cloud est affichée en français, les libellés correspondants s’affichent traduits.

#1. Configurer Google Cloud

Rendez-vous sur le site Google Maps Platform.
Cliquez sur Get started et connectez-vous avec votre compte Google.
Sélectionnez Create a new project lorsque cela vous est proposé et donnez-lui un nom.
Configurez la facturation de votre projet en ajoutant un moyen de paiement.
- Remarque : vous ne serez pas facturé tant que vous ne dépassez pas le palier gratuit.
Une fois la facturation configurée, votre projet est créé et prêt pour la configuration des API.

#2. Activer les API requises pour votre projet

Activez les API suivantes :

#3. Créer et configurer la Clé API publique

Ouvrez l’onglet Keys & Credentials dans Google Maps Platform.
Cliquez sur le bouton + Create credentials et sélectionnez l’option API key.
Une fois la clé créée, cliquez sur son nom pour la configurer.

#Configurer la Clé API publique

Nom : Atlas Pickup Points - Public API Key
Dans la section Application restrictions :
- Sélectionnez l’option Websites.
- Ajoutez les sites web suivants (sans barre oblique finale) :
```
https://adresse-de-votre-boutique.com
https://*.adresse-de-votre-boutique.com
https://votre-boutique.myshopify.com
https://shop.app
https://shopify.com
```
  shop.app et shopify.com sont requis pour Shop Pay et Shopify Checkout. Si vous avez des domaines locaux ou régionaux (par exemple .fr, .be), ajoutez-les tous également.
Dans la section API restrictions :
- Sélectionnez Restrict key.
- Dans la liste, sélectionnez l’API suivante :
  - Maps JavaScript API. Si elle n’apparaît pas, vous devez d’abord l’activer.
Cliquez sur le bouton Save en bas de la page.

#4. Créer et configurer la Clé API privée

Ouvrez l’onglet Keys & Credentials.
Cliquez sur le bouton + Create credentials et sélectionnez l’option API key.
Une fois la clé créée, cliquez sur son nom pour la configurer.

#Configurer la Clé API privée

Nom : Atlas Pickup Points - Private API Key
Set an application restriction :
- Nous recommandons de ne définir aucune restriction d’application pour cette clé. Consultez Pourquoi deux clés ? pour plus de détails.
API restrictions :
- Sélectionnez Restrict key.
- Choisissez les API suivantes :
  - Geocoding API. Si elle n’apparaît pas, vous devez d’abord l’activer.
  - Places API (New). Si elle n’apparaît pas, vous devez d’abord l’activer.
Cliquez sur le bouton Save en bas de la page.

#5. Mettre à jour les paramètres d’Atlas Pickup Points

Allez dans Atlas Pickup Points → Paramètres et collez les deux clés API dans les champs correspondants.

#6. Tester l’intégration

Après avoir mis à jour les clés API, vérifiez que la sélection des points de retrait fonctionne correctement :

Saisissez une nouvelle adresse dans le checkout de votre boutique.
Testez les fonctionnalités suivantes :
- Vue liste : vérifiez que les points de retrait se chargent et s’affichent dans la liste.
- Vue carte : vérifiez que la carte affiche les tuiles et que les marqueurs des points de retrait sont visibles.
- Autocomplétion de la recherche sur la carte : vérifiez que les suggestions d’adresses apparaissent pendant la recherche.

#FAQ

#Comment configurer la facturation Google Cloud ?

Rendez-vous sur la page Google Cloud Billing. Vous devez activer la facturation et ajouter un moyen de paiement pour que les clés API fonctionnent.

#Quels sont les coûts liés à l’utilisation des API Google Maps ?

Google Maps Platform propose deux modes de tarification. Consultez la page Tarifs de Google Maps Platform pour tous les détails.

Pay as you go facture à la requête, avec un palier gratuit mensuel par type de requête. Atlas utilise trois types de requêtes : Dynamic Maps, Geocoding et Places API Place Details Essentials. Consultez la page Tarifs de Google Maps Platform pour connaître le palier gratuit et les tarifs par requête en vigueur.

Si vous préférez une facturation prévisible, envisagez un abonnement Google Maps Subscriptions. Atlas Pickup Points utilise les API Maps, Geocoding et Places, vous auriez donc besoin du forfait Essentials ou supérieur.

Voici une estimation de la façon dont Atlas Pickup Points utilise ces API :

Chargement de la liste des points de retrait pour une nouvelle adresse de livraison : 1 requête Geocoding
Affichage de la carte : 1 requête Dynamic Maps Remarque : se déplacer sur la carte, zoomer ou changer de calque ne compte pas comme un chargement supplémentaire.
Utilisation de l’autocomplétion sur la carte : 1 requête Place Details

Par exemple, si un acheteur sélectionne l’option de livraison en point de retrait, ouvre la carte et utilise l’autocomplétion pour trouver un lieu, cela représente 3 requêtes (1 de chaque type).

Pour éviter des frais imprévus, vous pouvez configurer des plafonds d’utilisation et des alertes budgétaires.

#Pourquoi la carte ne se charge-t-elle pas après la saisie de la clé API ?

Causes fréquentes :

Restrictions de sites web : domaines se terminant par / (supprimez la barre oblique finale)
Facturation non activée
Mauvaise API activée pour la clé
Consultez la page Atlas Pickup Points → Paramètres pour vérifier les messages d’erreur affichés sur les champs des clés API
Ouvrez la console développeur de votre navigateur (F12 → onglet Console) et cherchez les messages d’erreur Google Maps ; ils contiennent généralement un lien expliquant le problème
Un autre bloc d’application qui affiche une carte sur la page (par exemple une autre application de points de retrait) peut créer un conflit ; retirez-le et réessayez

#Puis-je utiliser les mêmes clés API pour plusieurs boutiques ?

Oui. Si vous avez plusieurs boutiques au sein de la même organisation, vous pouvez réutiliser les mêmes clés API pour toutes. Assurez-vous que les restrictions de sites web de la Clé API publique incluent les domaines de toutes vos boutiques.

#Que faire si ma clé API est compromise ?

Si vous pensez que votre clé API a été compromise :

Supprimez immédiatement la clé compromise dans la console Google Cloud
Retirez la clé de la page Atlas Pickup Points → Paramètres et enregistrez
Vérifiez votre facturation Google Cloud à la recherche d’activité suspecte
Contactez l’assistance Google Maps Platform si nécessaire
Créez de nouvelles clés API en suivant les étapes de configuration ci-dessus et saisissez-les dans Atlas Pickup Points → Paramètres

Comment créer des clés API Google Maps