Afficher une carte de base

Commencer

Avant d'essayer l'exemple de code, vous devez configurer votre environnement de développement. Pour en savoir plus, consultez Exemples de code du SDK Maps pour iOS.

Afficher le code

import GoogleMaps
import UIKit

class BasicMapViewController: UIViewController {
  var statusLabel: UILabel!

  override func viewDidLoad() {
    super.viewDidLoad()

    // Seattle coordinates
    let camera = GMSCameraPosition(latitude: 47.6089945, longitude: -122.3410462, zoom: 14)
    let mapView = GMSMapView(frame: view.bounds, camera: camera)
    mapView.delegate = self
    view = mapView
    navigationController?.navigationBar.isTranslucent = false

    statusLabel = UILabel(frame: .zero)
    statusLabel.alpha = 0.0
    statusLabel.backgroundColor = .blue
    statusLabel.textColor = .white
    statusLabel.textAlignment = .center
    view.addSubview(statusLabel)
    statusLabel.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      statusLabel.topAnchor.constraint(equalTo: view.topAnchor),
      statusLabel.heightAnchor.constraint(equalToConstant: 30),
      statusLabel.leadingAnchor.constraint(equalTo: view.leadingAnchor),
      statusLabel.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    ])
  }
}

extension BasicMapViewController: GMSMapViewDelegate {
  func mapViewDidStartTileRendering(_ mapView: GMSMapView) {
    statusLabel.alpha = 0.8
    statusLabel.text = "Rendering"
  }

  func mapViewDidFinishTileRendering(_ mapView: GMSMapView) {
    statusLabel.alpha = 0.0
  }
}
BasicMapViewController.swift
      

#import "GoogleMapsDemos/Samples/BasicMapViewController.h"

#import <GoogleMaps/GoogleMaps.h>

@implementation BasicMapViewController {
  UILabel *_statusLabel;
}

- (void)viewDidLoad {
  [super viewDidLoad];
  // Seattle coordinates
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.6089945
                                                          longitude:-122.3410462
                                                               zoom:14];
  GMSMapView *view = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  view.delegate = self;
  self.view = view;

  // Add status label, initially hidden.
  _statusLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, 0, 30)];
  _statusLabel.alpha = 0.0f;
  _statusLabel.autoresizingMask = UIViewAutoresizingFlexibleWidth;
  _statusLabel.backgroundColor = [UIColor blueColor];
  _statusLabel.textColor = [UIColor whiteColor];
  _statusLabel.textAlignment = NSTextAlignmentCenter;

  [view addSubview:_statusLabel];
}

- (void)mapViewDidStartTileRendering:(GMSMapView *)mapView {
  _statusLabel.alpha = 0.8f;
  _statusLabel.text = @"Rendering";
}

- (void)mapViewDidFinishTileRendering:(GMSMapView *)mapView {
  _statusLabel.alpha = 0.0f;
}

@end
BasicMapViewController.m
      

Exécuter l'application exemple complète en local

L'application exemple du SDK Maps pour iOS est disponible en tant qu'archive de téléchargement sur GitHub. Suivez ces étapes pour installer et essayer l'application exemple du SDK Maps pour iOS.

1. Exécutez git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git pour cloner le dépôt d'exemples dans un répertoire local.

2. Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez cloné les fichiers exemples, puis accédez au répertoire Google Maps:

   Swift

   cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
   pod install
   open GoogleMapsSwiftDemos.xcworkspace

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   pod install
   open GoogleMapsDemos.xcworkspace

3. Dans Xcode, appuyez sur le bouton de compilation pour créer l'application avec le schéma actuel. La compilation génère une erreur et vous invite à saisir votre clé API dans le fichier SDKConstants.swift pour Swift ou le fichier SDKDemoAPIKey.h pour Objective-C.
4. Si vous ne disposez pas encore d'une clé API, suivez les instructions pour configurer un projet dans la Google Cloud Console et obtenir une clé API. Lorsque vous configurez la clé dans la console Cloud, vous pouvez la limiter à l'identifiant du bundle de l'application exemple pour vous assurer que seule votre application peut l'utiliser. L'identifiant de bundle par défaut de l'application d'exemples du SDK est com.example.GoogleMapsDemos.
5. Modifiez le fichier SDKConstants.swift pour Swift ou le fichier SDKDemoAPIKey.h pour Objective-C, puis collez votre clé API dans la définition de la constante apiKey ou kAPIKey. Exemple :

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

6. Dans le fichier SDKConstants.swift (Swift) ou SDKDemoAPIKey.h (Objective-C), supprimez la ligne suivante, car elle permet d'enregistrer le problème défini par l'utilisateur:

   Swift

   #error (Register for API Key and insert here. Then delete this line.)

   Objective-C

   #error Register for API Key and insert here.

7. Créez et exécutez le projet. La fenêtre du simulateur iOS s'affiche, avec une liste de démonstrations du SDK Maps.
8. Choisissez l'une des options affichées pour tester une fonctionnalité du SDK Maps pour iOS.
9. Si vous êtes invité à autoriser GoogleMapsDemos à accéder à votre position, sélectionnez Autoriser.