Cette page décrit l'utilitaire de regroupement de repères disponible dans le bibliothèque utilitaire pour le SDK Maps pour iOS.
Le regroupement de repères vous permet de placer un grand nombre de repères sur une carte sans la rendre difficile à lire. L'utilitaire de regroupement de repères vous aide gérer plusieurs repères à différents niveaux de zoom.
Lorsque l'utilisateur affiche la carte à un niveau de zoom élevé, les différents repères s'affichent sur la carte. Lorsqu'il effectue un zoom arrière, les repères se regroupent pour faciliter la consultation de la carte.
La capture d'écran suivante montre le style par défaut des groupes de marqueurs :
![Carte contenant des marqueurs regroupés, dans le style par défaut](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/ios-sdk/images/clustering-default-icon.png?authuser=9&hl=fr)
La capture d'écran suivante montre des groupes de marqueurs personnalisés :
![Une carte avec un groupe de repères personnalisé](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/ios-sdk/images/clustering-custom-icon.png?authuser=9&hl=fr)
Prérequis et remarques
Bibliothèque d'utilitaires du SDK Maps pour iOS
L'utilitaire de regroupement de repères fait partie SDK Maps pour iOS Bibliothèque d'utilitaires Si vous n'avez pas encore configuré la bibliothèque, suivez le guide de configuration avant de poursuivre la lecture de cette page.
Pour des performances optimales, le nombre maximum de marqueurs recommandé est de 10 000.
Autorisation d'accéder à la position
Cet exemple utilise le GPS de l'appareil pour localiser l'utilisateur et la carte sur ses coordonnées. Pour activer
vous devez ajouter une description à l'autorisation NSLocationWhenInUseUsageDescription
dans le fichier Info.plist
du projet.
Pour l'ajouter, procédez comme suit:
- Dans le navigateur de projets Xcode, cliquez sur le fichier
Info.plist
pour ouvrir le Éditeur de liste de propriétés. - Cliquez sur le signe "+" à côté de "Liste des propriétés d'information" pour ajouter une propriété.
- Dans la "clé" , saisissez "NSLocationWhenInUseUsageDescription". Xcode va automatiquement traduisez ceci par le nom long 'Privacy - Location When In Use Usage Description'. Pour une la liste complète des propriétés possibles pour les autorisations d'accès à la position, consultez Demander une autorisation pour les services de localisation dans la documentation Apple Developer.
- Laissez le champ "Type" défini sur "String" (Chaîne).
- Dans la colonne "Valeur", , saisissez une description de la raison pour laquelle votre application nécessite l'utilisation du l'emplacement de l'utilisateur. Par exemple, "Localise l'utilisateur pour fournir des fiches d'entreprise à proximité".
Implémenter le regroupement de repères
L'implémentation du regroupement de repères comprend trois étapes:
- Créez une instance de gestionnaire de cluster.
- Transmettez les repères que vous souhaitez regrouper au gestionnaire de regroupement.
- Appelez le gestionnaire de cluster.
Créer le gestionnaire de cluster
Pour utiliser le gestionnaire de cluster, procédez comme suit:
- Définissez les
ViewController
où votre carte est affichée pour qu'elle soit conforme aux ProtocoleGMSMapViewDelegate
. - Créez une instance de
GMUClusterManager
. - Transmettez l'instance de
GMSMapView
pour laquelle vous souhaitez implémenter le regroupement de repères. et les implémentations des protocoles suivants à l'instanceGMUClusterManager
: <ph type="x-smartling-placeholder">- </ph>
GMUClusterIconGenerator
: fournit une logique d'application qui récupère les des icônes de regroupement à utiliser à différents niveaux de zoom.GMUClusterAlgorithm
: spécifie un algorithme qui détermine le comportement de la façon dont les repères sont regroupés, comme la distance entre les repères à inclure dans un même groupe.GMUClusterRenderer
: fournit une logique d'application qui gère les actions réelles le rendu des icônes de cluster sur la carte.
- Définissez le délégué de carte sur l'instance
GMUClusterManager
.
La bibliothèque d'utilitaires inclut des implémentations par défaut du générateur d'icônes (GMUDefaultClusterIconGenerator
).
l'algorithme (GMUNonHierarchicalDistanceBasedAlgorithm
) et le moteur de rendu (GMUDefaultClusterRenderer
).
Vous pouvez éventuellement créer votre propre générateur d'icônes de regroupement, votre algorithme et votre moteur de rendu.
Le code suivant crée un gestionnaire de cluster à l'aide de ces valeurs par défaut dans viewDidLoad
.
rappel de ViewController
:
Swift
import GoogleMaps import GoogleMapsUtils class MarkerClustering: UIViewController, GMSMapViewDelegate { private var mapView: GMSMapView! private var clusterManager: GMUClusterManager! override func viewDidLoad() { super.viewDidLoad() // Set up the cluster manager with the supplied icon generator and // renderer. let iconGenerator = GMUDefaultClusterIconGenerator() let algorithm = GMUNonHierarchicalDistanceBasedAlgorithm() let renderer = GMUDefaultClusterRenderer(mapView: mapView, clusterIconGenerator: iconGenerator) clusterManager = GMUClusterManager(map: mapView, algorithm: algorithm, renderer: renderer) // Register self to listen to GMSMapViewDelegate events. clusterManager.setMapDelegate(self) // ... } // ... }
Objective-C
@import GoogleMaps; @import GoogleMapsUtils; @interface MarkerClustering () <GMSMapViewDelegate> @end @implementation MarkerClustering { GMSMapView *_mapView; GMUClusterManager *_clusterManager; } - (void)viewDidLoad { [super viewDidLoad]; // Set up the cluster manager with a supplied icon generator and renderer. id<GMUClusterAlgorithm> algorithm = [[GMUNonHierarchicalDistanceBasedAlgorithm alloc] init]; id<GMUClusterIconGenerator> iconGenerator = [[GMUDefaultClusterIconGenerator alloc] init]; id<GMUClusterRenderer> renderer = [[GMUDefaultClusterRenderer alloc] initWithMapView:_mapView clusterIconGenerator:iconGenerator]; _clusterManager = [[GMUClusterManager alloc] initWithMap:_mapView algorithm:algorithm renderer:renderer]; // Register self to listen to GMSMapViewDelegate events. [_clusterManager setMapDelegate:self]; // ... } // ... @end
Ajouter des repères
Il existe deux façons d'ajouter des repères au regroupeur de repères: individuellement ou sous forme de tableau.
Repère individuel
Swift
let position = CLLocationCoordinate2D(latitude: 47.60, longitude: -122.33) let marker = GMSMarker(position: position) clusterManager.add(marker)
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(47.60, -122.33); GMSMarker *marker = [GMSMarker markerWithPosition:position]; [_clusterManager addItem:marker];
Tableau de repères
Swift
let position1 = CLLocationCoordinate2D(latitude: 47.60, longitude: -122.33) let marker1 = GMSMarker(position: position1) let position2 = CLLocationCoordinate2D(latitude: 47.60, longitude: -122.46) let marker2 = GMSMarker(position: position2) let position3 = CLLocationCoordinate2D(latitude: 47.30, longitude: -122.46) let marker3 = GMSMarker(position: position3) let position4 = CLLocationCoordinate2D(latitude: 47.20, longitude: -122.23) let marker4 = GMSMarker(position: position4) let markerArray = [marker1, marker2, marker3, marker4] clusterManager.add(markerArray)
Objective-C
CLLocationCoordinate2D position1 = CLLocationCoordinate2DMake(47.60, -122.33); GMSMarker *marker1 = [GMSMarker markerWithPosition:position1]; CLLocationCoordinate2D position2 = CLLocationCoordinate2DMake(47.60, -122.46); GMSMarker *marker2 = [GMSMarker markerWithPosition:position2]; CLLocationCoordinate2D position3 = CLLocationCoordinate2DMake(47.30, -122.46); GMSMarker *marker3 = [GMSMarker markerWithPosition:position3]; CLLocationCoordinate2D position4 = CLLocationCoordinate2DMake(47.20, -122.23); GMSMarker *marker4 = [GMSMarker markerWithPosition:position4]; NSArray<GMSMarker *> *markerArray = @[marker1, marker2, marker3, marker4]; [_clusterManager addItems:markerArray];
Appeler le regroupeur de repères
Une fois que vous avez créé votre regroupeur de repères et que vous lui avez transmis les repères que vous souhaitez regrouper,
vous devez appeler la méthode cluster
sur votre instance de regroupeur de repères.
Swift
clusterManager.cluster()
Objective-C
[_clusterManager cluster];
Gérer les événements sur les marqueurs et les groupes
En général, lorsque vous utilisez le SDK Maps pour iOS, vous devez implémenter
le GMSMapViewDelegate
standard. Vous pouvez écouter
sur la carte, mais pas
écouter les événements du gestionnaire de cluster avec sûreté du typage. Lorsque l'utilisateur appuie sur un repère,
un élément de cluster individuel, ou un cluster, l'API déclenche
mapView:didTapMarker:
et associe les données de cluster supplémentaires au
marker.userData
. Vous pouvez ensuite vérifier si userData
est conforme à
le protocole GMUCluster
pour déterminer si l'utilisateur a appuyé sur une icône de groupe ou un repère.
Swift
func mapView(_ mapView: GMSMapView, didTap marker: GMSMarker) -> Bool { // center the map on tapped marker mapView.animate(toLocation: marker.position) // check if a cluster icon was tapped if marker.userData is GMUCluster { // zoom in on tapped cluster mapView.animate(toZoom: mapView.camera.zoom + 1) NSLog("Did tap cluster") return true } NSLog("Did tap a normal marker") return false }
Objective-C
- (BOOL)mapView:(GMSMapView *)mapView didTapMarker:(GMSMarker *)marker { // center the map on tapped marker [_mapView animateToLocation:marker.position]; // check if a cluster icon was tapped if ([marker.userData conformsToProtocol:@protocol(GMUCluster)]) { // zoom in on tapped cluster [_mapView animateToZoom:_mapView.camera.zoom + 1]; NSLog(@"Did tap cluster"); return YES; } NSLog(@"Did tap marker in cluster"); return NO; }
Le gestionnaire de cluster intercepte désormais tous les événements que vous avez implémentés sur
clusterManager
Il transmet tous les événements restants à la carte
délégué, s'il est fourni. Notez que les événements pour les repères standards
(c'est-à-dire que les repères non générés par le moteur de rendu de groupe) sont toujours transférés.
au délégué de carte.
Personnaliser le regroupement de repères
Vous pouvez fournir une implémentation personnalisée pour
GMUClusterRenderer
, GMUClusterIconGenerator
ou
GMUClusterAlgorithm
Vous pouvez baser votre implémentation personnalisée
sur l'exemple d'implémentation de ces protocoles inclus dans l'utilitaire
ou codez une implémentation entièrement personnalisée en appliquant la
protocoles.