SDK Maps pour iOS : obtenir une clé API

Remarque : Il n'est plus possible de s'inscrire au forfait Premium de Google Maps Platform, qui n'est plus disponible non plus pour les nouveaux clients.

Pour utiliser le SDK Maps pour iOS, vous devez disposer d'une clé API. La clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet afin de déterminer l'utilisation et la facturation.

Créer des clés API

Vous devez associer au moins une clé API à votre projet.

Pour obtenir une clé API :

  1. Accédez à la Google Cloud Console.
  2. Cliquez sur la liste déroulante des projets et sélectionnez celui qui a été créé pour vous lorsque vous avez acheté le forfait Premium. Le nom du projet commence par Google Maps APIs for Business, Google Maps for Work ou Google Maps.
  3. Remarque : Pour bénéficier d'un accès complet aux fonctionnalités de leur forfait, les clients Premium doivent utiliser le projet associé à leur compte Premium. Lorsque vous avez acheté votre licence, vous avez reçu le nom de l'élément Premium au format suivant : gme-[company] & proj-[number] ([type]). Pour vous assurer d'accéder au bon projet, connectez-vous à la console en tant que propriétaire du projet sur console.cloud.google.com/project/number (remplacez number par votre numéro de projet). Le nom du propriétaire du projet est indiqué dans votre courrier de bienvenue.

  4. Cliquez sur le bouton Menu , puis sélectionnez API et services > Identifiants.
  5. Sur la page Identifiants, cliquez sur Créer des identifiants > Clé API.
    La boîte de dialogue Clé API créée affiche la nouvelle clé API (une chaîne chiffrée).
  6. Cliquez sur Fermer.
    La nouvelle clé API est répertoriée sur la page Identifiants sous Clés API.

Ajouter la clé API à votre application

Dans les exemples suivants, remplacez YOUR_API_KEY par votre clé API.

Swift

Ajoutez votre clé API à votre fichier AppDelegate.swift comme suit :

  1. Ajoutez la déclaration d'importation suivante :
    import GoogleMaps
  2. Ajoutez les éléments suivants à votre méthode application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé API :
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Si vous utilisez également l'API Places, ajoutez à nouveau votre clé comme indiqué ci-dessous :
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Ajoutez votre clé API à votre fichier AppDelegate.m comme suit :

  1. Ajoutez la déclaration d'importation suivante :
    @import GoogleMaps;
  2. Ajoutez les éléments suivants à votre méthode application:didFinishLaunchingWithOptions:, en remplaçant YOUR_API_KEY par votre clé API :
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Si vous utilisez également l'API Places, ajoutez à nouveau votre clé comme indiqué ci-dessous :
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Restreindre les clés API

La restriction des clés API renforce la sécurité de votre application en garantissant que seules les requêtes autorisées sont effectuées avec votre clé API. Nous vous recommandons vivement de suivre les instructions pour définir des restrictions au niveau de vos clés API. Pour en savoir plus, consultez la page Bonnes pratiques concernant les clés API.

Pour restreindre une clé API :

  1. Dans la Cloud Console, sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud pour lequel vous souhaitez ajouter une clé API.

    Accéder à la page du sélecteur de projet

  2. Accédez à la page API et services > Identifiants.

    Accéder à la page "Identifiants"

  3. 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.
  4. 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 d'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 répertorié, vous devez l'activer.)
  5. Pour valider les modifications, cliquez sur Enregistrer.