Le SDK Navigation n'est actuellement disponible que pour certains clients. Pour en savoir plus, contactez le service commercial.

De nouveaux styles de carte seront bientôt disponibles dans Google Maps Platform. Cette mise à jour du style de carte comprend une nouvelle palette de couleurs par défaut, ainsi que des améliorations apportées à l'expérience utilisateur et à la facilité d'utilisation des cartes. Tous les styles de carte seront automatiquement mis à jour en mars 2025. Pour en savoir plus sur la disponibilité et découvrir comment l'activer plus tôt, consultez Nouveau style de carte pour Google Maps Platform.

Cette page a été traduite par l'API Cloud Translation.

Utiliser des clés API

Créer des clés API

Une clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet à des fins d'utilisation et de facturation. Vous devez associer au moins une clé API à votre projet.

Pour créer une clé API :

Console

Accédez à la page Google Maps Platform > Identifiants.

Accéder à la page "Identifiants"
Sur la page Identifiants, cliquez sur Créer des identifiants > Clé API.
La boîte de dialogue Clé API créée affiche la clé API que vous venez de créer.
Cliquez sur Fermer.
La nouvelle clé API figure sur la page Identifiants sous Clés API.
(N'oubliez pas de restreindre la clé API avant de l'utiliser en production.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

gcloud alpha services api-keys create

Restreindre les clés API

Google vous recommande vivement de restreindre vos clés API en limitant leur utilisation aux seules API nécessaires à votre application. Restreindre les clés API vous aide à renforcer la sécurité de votre application en la protégeant contre les requêtes non justifiées. Pour en savoir plus, consultez les bonnes pratiques concernant les clés API.

Lorsque vous limitez votre clé API, vous devez fournir l'empreinte du certificat SHA-1 de la clé de signature utilisée pour signer l'application. Il existe deux types de certificats :

Certificat de débogage: n'utilisez ce type de certificat qu'avec des applications que vous testez et d'autres codes hors production. N'essayez pas de publier une application signée avec un certificat de débogage. Les outils Android SDK génèrent ce certificat automatiquement lorsque vous exécutez une version de débogage.
Certificat de version: utilisez ce certificat lorsque vous êtes prêt à publier votre application sur une plate-forme de téléchargement d'applications. Les SDK Tools pour Android génèrent ce certificat lorsque vous exécutez une version de production.

Pour en savoir plus sur les certificats et la signature d'application Android, consultez le guide Signer votre application.

Pour savoir comment trouver l'empreinte du certificat de signature, consultez les références ci-dessous :

Si vous utilisez la signature d'application Play, consultez Collaborer avec des fournisseurs d'API.
Si vous gérez votre propre clé de signature, consultez Autosigner votre application ou reportez-vous aux instructions relatives à votre environnement de compilation.

Pour restreindre une clé API :

Console

Accédez à la page Google Maps Platform > Identifiants.

Accéder à la page "Identifiants"
Sélectionnez la clé API pour laquelle vous souhaitez définir une restriction. La page des propriétés de la clé API s'affiche.
Sous Restrictions relatives aux clés, définissez les restrictions suivantes :

Restrictions relatives aux applications :

Sélectionnez Applications Android.
Cliquez sur + Ajouter le nom du package et l'empreinte.

Saisissez le nom du package et l'empreinte du certificat SHA-1. Exemple :

com.example.android.mapexample

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

Restrictions relatives aux API :

Cliquez sur Restreindre la clé.
Sélectionnez SDK Navigation dans le menu déroulant Sélectionner des API. Si le SDK Navigation n'est pas listé, vous devez l'activer.

Pour valider les modifications, cliquez sur Enregistrer.

Cloud SDK

Listez les clés existantes.

gcloud services api-keys list --project="PROJECT"

Supprimez les restrictions existantes sur la clé existante.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Définissez de nouvelles restrictions pour la clé existante.

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-android-backend.googleapis.com
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

Étape suivante

Maintenant que vous disposez d'une clé API, vous pouvez créer et configurer un projet Android Studio, comme décrit dans Configurer un projet Android Studio.

Configurer votre projet Android Studio