Obtenir une clé API

Sélectionnez une plate-forme : Android iOS JavaScript

Maintenant que vous avez configuré la facturation et un projet, activé le SDK et installé le gestionnaire de dépendances de votre choix et d'autres logiciels, vous êtes prêt à créer, ajouter et restreindre votre clé 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

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

   Accéder à la page "Identifiants"

2. 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.
3. 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 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 services api-keys create

Vous aurez besoin de cette clé API lorsque vous créerez votre projet Xcode, comme décrit dans Configurer un projet Xcode.

Remarque : Vous pouvez utiliser la même clé API pour vos applications basées sur le SDK Maps pour iOS et le SDK Places pour iOS.

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. Vous êtes financièrement responsable des frais occasionnés par l'utilisation abusive de clés API sans restriction. Pour en savoir plus, consultez les bonnes pratiques de sécurité pour les API.

Lorsque vous restreignez une clé API dans la console Cloud, les restrictions liées aux applications s'appliquent à toutes les API activées dans Restrictions relatives aux API. Suivez les bonnes pratiques en créant une clé API distincte pour chaque application et pour chaque plate-forme sur laquelle cette application est disponible.

Pour restreindre une clé API :

Console

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

   Accéder à la page "Identifiants"

2. 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.
3. Sous Restrictions relatives aux clés, définissez les restrictions suivantes :
• Restrictions d'application :
1. Sélectionnez Applications iOS.
2. Pour accepter les requêtes provenant de l'application iOS avec l'identifiant de groupe que vous fournissez, sélectionnez l'identifiant de groupe iOS approprié dans la liste.
• Restrictions relatives aux API :
1. Cliquez sur Restreindre la clé.
2. Sélectionnez SDK Maps pour iOS dans le menu déroulant Sélectionner des API. Si le SDK Maps pour iOS n'est pas listé, vous devez l'activer.
4. 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 services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

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

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

Maintenant que vous avez obtenu votre clé API pour le SDK Maps pour iOS, vous pouvez commencer.

Étape suivante

Maintenant que vous disposez d'une clé API, créez et configurez votre projet Xcode comme décrit dans Configurer un projet Xcode.