Instance Method

removeAnnotation(_:)

Removes the specified annotation object from the map view.

Declaration

func removeAnnotation(_ annotation: MKAnnotation)

Parameters

annotation

The annotation object to remove. This object must conform to the MKAnnotation protocol.

Discussion

If the annotation is currently associated with an annotation view, and that view has a reuse identifier, this method removes the annotation view and queues it internally for later reuse. You can retrieve queued annotation views (and associate them with new annotations) using the dequeueReusableAnnotationView(withIdentifier:) method.

Removing an annotation object disassociates it from the map view entirely, preventing it from being displayed on the map. Thus, you would typically call this method only when you want to hide or delete a given annotation.

See Also

Annotating the Map

var annotations: [MKAnnotation]

The complete list of annotations associated with the receiver.

func addAnnotation(MKAnnotation)

Adds the specified annotation to the map view.

func addAnnotations([MKAnnotation])

Adds an array of annotation objects to the map view.

func removeAnnotations([MKAnnotation])

Removes an array of annotation objects from the map view.

func view(for: MKAnnotation)

Returns the annotation view associated with the specified annotation object, if any.

func annotations(in: MKMapRect)

Returns the annotation objects located in the specified map rectangle.

var annotationVisibleRect: CGRect

The visible rectangle where annotation views are currently being displayed.

func dequeueReusableAnnotationView(withIdentifier: String)

Returns a reusable annotation view located by its identifier.