Premiers pas avec Premium Plan sur iOS

Votre licence Google Maps APIs Premium Plan offre une prise en charge améliorée de Google Maps SDK for iOS. Ce document vous indique comment créer une application iOS qui utilise Google Maps SDK for iOS avec Premium Plan.

Présentation

Suivez les instructions sur cette page pour télécharger le SDK, configurer votre projet et ajouter une carte. Voici un résumé des étapes requises :

  1. Installez Xcode et le SDK.
  2. Obtenez une clé d'API.
  3. Ajoutez la clé d'API à votre application.
  4. Ajoutez une carte.

Installer Xcode et le SDK

Obtenir la dernière version de Xcode

Pour créer un projet avec Google Maps SDK for iOS, vous avez besoin de la version 7.3 ou ultérieure de Xcode.

Installer le SDK

Utiliser CocoaPods

Google Maps SDK for iOS est disponible sous forme de pod CocoaPods. CocoaPods est un gestionnaire de dépendances open source pour les projets Cocoa Swift et Objective-C.

Si vous ne possédez pas encore l'outil CocoaPods, installez-le sur macOS en exécutant la commande suivante à partir du terminal. Pour plus de détails, voir le guide de démarrage de CocoaPods.

sudo gem install cocoapods

Créez un fichier Podfile pour Google Maps SDK for iOS et utilisez-le pour installer l'API et ses dépendances :

  1. Si vous n'avez pas encore de projet Xcode, créez-en un immédiatement et enregistrez-le sur votre machine locale. (Si vous n'êtes pas familier du développement iOS, créez une application Single View.)
  2. Créez un fichier intitulé Podfile dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet.
  3. Modifiez le fichier Podfile en y ajoutant vos dépendances. Voici un exemple qui inclut les dépendances dont vous avez besoin pour Google Maps SDK for iOS et Places API for iOS (facultatif) :
    source 'https://github.com/CocoaPods/Specs.git'
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps'
      pod 'GooglePlaces'
    end

    Les clients du plan Premium doivent également ajouter : pod 'google/M4B'.

  4. Enregistrez le fichier Podfile.
  5. Sur un terminal, accédez au répertoire contenant le fichier Podfile :

    cd <path-to-project>
  6. Exécutez la commande pod install. Les API spécifiées dans le Podfile sont alors installées avec toutes les dépendances associées.

    pod install
  7. Fermez Xcode, et ouvrez (par un double clic) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier .xcworkspace pour ouvrir le projet.

Installer manuellement

Ce guide décrit comment ajouter manuellement le framework Google Maps à votre projet et configurer les paramètres de votre build dans Xcode.

  1. Téléchargez les fichiers source SDK : GoogleMaps-2.0.1.
  2. Décompressez les fichiers source.
  3. Lancez Xcode et ouvrez un projet existant ou créez-en un nouveau. Si vous débutez avec iOS, créez une application Single View, désactivez Use Storyboards et activez Use Automatic Reference Counting.
  4. Faites glisser les groupes suivants dans votre projet (lorsque vous y êtes invité, sélectionnez Copy items if needed) :
    • Subspecs/Base/Frameworks/GoogleMapsBase.framework
    • Subspecs/Maps/Frameworks/GoogleMaps.framework
    • Subspecs/Maps/Frameworks/GoogleMapsCore.framework

    Les clients du plan Premium doivent également inclure Subspecs/M4B/Frameworks/GoogleMapsM4B.framework.

  5. Cliquez avec le bouton droit de la souris sur GoogleMaps.framework dans votre projet, puis sélectionnez Show In Finder.
  6. Faites glisser GoogleMaps.bundle depuis le dossier Resources de votre projet. Lorsque vous y êtes invité, assurez-vous que l'option Copy items into destination group's folder n'est pas sélectionnée.
  7. Sélectionnez votre projet dans Project Navigator, puis choisissez la cible de votre application.
  8. Ouvrez l'onglet Build Phases, puis dans Link Binary with Libraries, ajoutez les frameworks suivants :
    • GoogleMapsBase.framework
    • GoogleMaps.framework
    • GoogleMapsCore.framework
    • GoogleMapsM4B.framework (clients du plan Premium uniquement)
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. Choisissez votre projet au lieu de sélectionner une cible spécifique, et ouvrez l'onglet Build Settings. Dans la section Other Linker Flags, ajoutez -ObjC. Si ces paramètres ne sont pas visibles, changez le filtre dans la barre Build Settings de Basic à All.

  10. Pour installer Places API for iOS, voir Premiers pas avec Places API for iOS.

Obtenir une clé d'API

Pour authentifier votre application vis-à-vis de Google Maps SDK for iOS, vous avez besoin d'une clé d'API restreinte à un identifiant de groupe spécifique à votre application. Cette combinaison crée une clé d'API restreinte à iOS.

Cliquez sur le bouton ci-dessous pour obtenir de l'aide tout au long du processus d'obtention d'une clé d'API. Si votre projet comporte déjà une clé d'API avec restriction iOS, vous pouvez utiliser cette clé. Important : Dans le menu déroulant du projet, vous devez sélectionner le projet créé pour vous lors de l'achat de Google Maps APIs Premium Plan. Le nom du projet commence par Google Maps APIs for Business or Google Maps for Work or Google Maps.

Obtenir une clé

Vous pouvez également obtenir une clé d'API comme suit :

  1. Allez à la Google API Console.
  2. Dans le menu déroulant Project, sélectionnez le projet Google Maps Premium.*
  3. Cliquez sur Continue.
  4. Sur la page Credentials, obtenez une clé d'API.
    Remarque : Si vous possédez une clé avec des restrictions pour iOS, vous pouvez l'utiliser. Vous pouvez utiliser la même clé avec n'importe laquelle de vos applications iOS au sein du même projet.
  5. Dans la boîte de dialogue affichant la clé d'API, sélectionnez Restrict key afin de définir une restriction pour iOS sur la clé d'API.
  6. Dans la section Restrictions, sélectionnez iOS apps, puis saisissez l'identifiant de groupe de votre application. Par exemple : com.example.hellomap.
  7. Cliquez sur Save.

    Votre nouvelle clé d'API restreinte à iOS s'affiche dans la liste des clés d'API de votre projet. Une clé d'API est une chaîne de caractères semblable à ce qui suit :

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Vous pouvez également rechercher une clé existante dans la Google API Console.

Pour plus d'informations sur l'utilisation de la Google API Console, voir l'aide de la API Console.

Ajouter la clé d'API à votre application

Swift

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

  1. Ajoutez la déclaration d'importation suivante :
    import GoogleMaps
  2. Ajoutez ce qui suit à votre méthode application(_:didFinishLaunchingWithOptions:), en remplaçant YOUR_API_KEY par votre clé d'API :
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Si vous utilisez également Places API, ajoutez votre clé à nouveau, tel qu'illustré ici :
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  1. Ajoutez la déclaration d'importation suivante :
    @import GoogleMaps;
  2. Ajoutez ce qui suit à votre méthode application:didFinishLaunchingWithOptions:, en remplaçant YOUR_API_KEY par votre clé d'API :
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Si vous utilisez également Places API, ajoutez votre clé à nouveau, tel qu'illustré ici :
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Ajouter une carte

Le code ci-dessous montre comment ajouter une carte simple à un objet ViewController existant. Si vous créez une nouvelle application, suivez d'abord les instructions d'installation ci-dessus, puis créez une nouvelle application Single View en désactivant Use Storyboards mais en activant Use Automatic Reference Counting (ARC).

À présent, ajoutez ou mettez à jour quelques méthodes dans le ViewController par défaut de votre application afin de créer et d'initialiser une instance de GMSMapView.

Swift

import UIKit
import GoogleMaps

class YourViewController: UIViewController {

  // You don't need to modify the default init(nibName:bundle:) method.

  override func loadView() {
    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    mapView.isMyLocationEnabled = true
    view = mapView

    // Creates a marker in the center of the map.
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
  }
}

Objective-C

#import "YourViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@implementation YourViewController

// You don't need to modify the default initWithNibName:bundle: method.

- (void)loadView {
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.myLocationEnabled = YES;
  self.view = mapView;

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end

Exécutez votre application. Vous devriez voir une carte avec un seul marqueur centré sur Sydney en Australie. Si vous voyez le marqueur alors que la carte n'est pas visible, confirmez que vous avez fourni votre clé d'API.

Plus d'infos

Conditions requises liées aux mentions

Vous devez inclure le texte de la mention dans la section des mentions légales de votre application. Google recommande d'inclure les mentions légales dans un élément de menu distinct, ou de les intégrer à l'élément de menu « À propos de ».

Le texte de la mention est disponible en appelant GMSServices.openSourceLicenseInfo().

Plateformes prises en charge

Pour développer une application iOS avec Google Maps SDK for iOS fourni avec Premium Plan, vous avez besoin des éléments suivants :

  • Xcode 7.3 ou version ultérieure.
  • iOS SDK 8.0 ou version ultérieure.

Les applications développées avec ce SDK fonctionneront sur iOS 7.0 et les versions ultérieures.

Comparer les versions

Le tableau suivant décrit les principales différences entre l'utilisation de la version standard de Google Maps SDK for iOS et l'utilisation du SDK avec Premium Plan.

  Google Maps SDK for iOS Standard Premium Plan
Types de support Support de la communauté. Accès au support Premium.
Conditions Soumis aux Conditions de service de Google Maps/Google Earth API. Soumis aux conditions d'utilisation de Google Maps APIs Premium Plan .

Documentation

Le Guide du développeur et la documentation de référence disponibles sur notre site constituent la principale source d'informations sur Google Maps SDK for iOS.