Google Maps

Pourquoi une clé Google Maps ?

Sur Android, les cartes de ton app sont dessinées par Google Maps. Google exige que chaque app utilise sa propre clé Google Maps. Sans elle, ton app Android se ferme dès qu’un écran avec une carte s’ouvre.

Sur iPhone, les cartes passent par Plans d’Apple : pas de clé, rien à faire.

Où ta clé sert, et où elle ne sert pas

• L’aperçu de Bloxks affiche une carte de remplacement. Elle marche toujours, donc elle ne prouve pas que ta clé Android est bonne.
• Expo Go n’utilise pas ta clé non plus.
• La version installée depuis Google Play est le seul vrai test : c’est là que ta clé est utilisée.

C’est gratuit ?

Google demande un compte de facturation sur ton projet Google Cloud, même pour afficher des cartes. D’après les tarifs de Google, l’affichage de cartes dans une app Android (Maps SDK for Android) n’est pas facturé et n’a pas de limite d’usage. D’autres services Google, comme la recherche de lieux ou les itinéraires, sont facturés à part. Vérifie les tarifs officiels avant de te lancer.

Étape 1 : créer la clé dans Google Cloud

1. Ouvre la console Google Cloud. En haut de la page, ouvre le sélecteur de projet, puis choisis un projet ou crée-en un nouveau.
2. Active la facturation sur ce projet : ouvre Billing (Facturation) et associe un compte de facturation. Google l’exige.
3. Active l’API : ouvre Maps SDK for Android et clique sur Enable (Activer).
4. Ouvre APIs & Services → Credentials (API et services → Identifiants), puis clique sur Create credentials → API key (Créer des identifiants → Clé API). Google affiche ta nouvelle clé : elle commence par AIza….

Étape 2 : réserver la clé à ton app

Une clé restreinte ne marche que dans ton app, même si quelqu’un la copie. Ouvre ta clé (clique sur son nom dans Credentials), puis :

1. Sous Application restrictions (Restrictions relatives aux applications), choisis Android apps (Applications Android), puis clique sur Add (Ajouter).
2. Package name (nom du package) : tape le nom de package de ton app, par exemple com.tonnom.app. Ce doit être exactement celui affiché dans Publier sur Bloxks.
3. SHA-1 certificate fingerprint (empreinte du certificat SHA-1) : copie-la depuis la Play Console. Ouvre ton app, puis Tester et publier → Intégrité de l’application, puis la partie Signature d’application. Copie le SHA-1 du certificat de la clé de signature d’application, pas celui de la clé d’importation. Les noms des menus peuvent varier un peu d’un compte à l’autre.
4. Sous API restrictions (Restrictions relatives aux API), choisis Restrict key (Restreindre la clé), puis coche uniquement Maps SDK for Android.
5. Clique sur Save (Enregistrer).

Une même clé peut servir à plusieurs apps : clique à nouveau sur Add pour chaque app, avec son nom de package et son SHA-1.

Étape 3 : ajouter la clé dans Bloxks

1. Dans Bloxks, ouvre Connexions, choisis Google Maps, puis clique sur Ajouter une connexion.
2. Colle ta clé (elle commence par AIza…) et valide.
3. Republie ton app sur Android. La clé est intégrée à ton app au moment de sa fabrication : une version déjà installée sur un téléphone ne change pas.

En cas de souci

• L’app Android se ferme quand une carte s’ouvre : la clé manque. Ajoute-la dans Connexions → Google Maps, puis republie.
• La carte reste grise ou vide dans la version Google Play : c’est en général l’une de ces raisons :
  • le SHA-1 ou le nom de package saisi dans Google Cloud ne correspond pas à ton app (vérifie que tu as copié la clé de signature d’application, pas la clé d’importation) ;
  • Maps SDK for Android n’est pas activé sur le projet ;
  • la facturation n’est pas activée sur le projet.
• Tu viens de modifier un réglage dans Google Cloud : les changements peuvent prendre quelques minutes. Patiente, puis rouvre l’app.
• La carte marche dans l’aperçu Bloxks mais pas sur le téléphone : c’est normal, l’aperçu utilise une carte de remplacement. Seule la version Google Play te dit si ta clé fonctionne.

Envie d’aller plus loin ? Lis le guide officiel de Google.