Créer un repère avancé

Sélectionnez une plate-forme : Android iOS JavaScript

Utilisez la sous-classe GMSAdvancedMarker pour créer des éléments géographiques spécifiques du repère, comme illustré ci-dessous. En tant que sous-classe de GMSMarker, GMSAdvancedMarker fournit aux repères plus d'expression.

Swift

let camera = GMSCameraPosition( target: coordinate, zoom: 14)
let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: view.bounds, mapID: mapID, camera: camera)

let marker = GMSAdvancedMarker(position: coordinate)
marker.map = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithTarget:kCoordinate zoom:16];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:"YOUR_MAP_ID"];

self.mapView = [GMSMapView mapWithFrame:self.view.bounds mapID:mapID camera:camera];

GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:kCoordinate];
Marker.map = self.mapView;

Remarque: Pour les tests, vous pouvez ignorer l'étape de création et de configuration d'un ID de carte en utilisant mapId: DEMO_MAP_ID dans le code de votre application. DEMO_MAP_ID est destiné à servir pour des tests uniquement. N'utilisez pas DEMO_MAP_ID dans un environnement de production.

Supprimer un repère avancé

Comme pour GMSMarker, vous pouvez supprimer un repère avancé de la carte en définissant la propriété de carte de GMSAdvancedMarker sur nil. Vous pouvez également supprimer toutes les superpositions (y compris les options avancées des repères) sur la carte en appelant la méthode clear GMSMapView.

Swift

let camera = GMSCameraPosition.camera(
  withLatitude: -33.8683,
  longitude: 151.2086,
  zoom: 6
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
// ...
mapView.clear()
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
// ...
[mapView clear];
      

Si vous souhaitez modifier un repère après l’avoir ajouté à la carte, veillez à conserver le GMSAdvancedMarker . Vous pourrez modifier le repère ultérieurement en appliquant des changements à cet objet.

Swift

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSAdvancedMarker(position: position)
marker.map = mapView
// ...
marker.map = nil

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:position];
marker.map = mapView;
// ...
marker.map = nil;

Fonctionnalités de la carte

La propriété mapCapabilities sur GMSMapView ajoute le programmatique en vérifiant les éléments propres à la carte. Cela est utile lorsque vous souhaitez savoir si certaines fonctionnalités de carte sont disponibles avant d'appeler des API spécifiques. La Fonction didChangeMapCapabilities de GMSMapViewDelegate est également vont être à mesure que les capacités évoluent. Cette requête détermine si la vue plan prend en charge les repères avancés.

Swift

// ...

let advancedMarker: GMSAdvancedMarker = {
GMSAdvancedMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

let marker: GMSMarker = {
GMSMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

func addMarker() {
  if mapView.mapCapabilities.contains(.advancedMarkers) {
      advancedMarker.map = mapView
    } else {
      marker.map = mapView
    }
}

extension MapCapabilities: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChangeMapCapabilities mapCapabilities: GMSMapCapabilityFlags) {

     let advancedMarkerAvailable = mapCapabilities.contains(.advancedMarkers)

     advancedMarker.map = advancedMarkerAvailable ? mapView : nil
     marker.map = advancedMarkerAvailable ? nil : mapView
  }
}

Objective-C

// ...

_advancedMarker = [GMSAdvancedMarker markerWithPosition:  kSeattleCoordinates];
_fallbackMarker = [GMSMarker markerWithPosition: kSeattleCoordinates];

-   (void)addMarker {

  if (_mapView.mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers) {
    _advancedMarker.map = _mapView;
    } else {
    _fallbackMarker.map = _mapView;
  }
}

#pragma mark - GMSMapViewDelegate

-   (void)mapView:(GMSMapView *)mapView
    didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  BOOL advancedMarkersAvailable = mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers;
  _advancedMarker.map = advancedMarkersAvailable ? _mapView : nil;
  _fallbackMarker.map = advancedMarkersAvailable ? nil : _mapView;
}