Annotations

The MGLAnnotationImage class is responsible for presenting point-based annotations visually on a map view. Annotation image objects wrap UIImage objects and may be recycled later and put into a reuse queue that is maintained by the map view.

Related examples

See the Mark a place on the map with an image example to learn how use an image as a marker using MGLAnnotationImage.

The MGLAnnotationView class is responsible for marking a point annotation with a view. Annotation views represent an annotation object, which is an object that corresponds to the MGLAnnotation protocol. When an annotation’s geographic coordinate is visible in the map view, the map view asks its delegate to a corresponding annotation view. If an annotation view is created with a reuse identifier, the map view may recycle the view when it goes offscreen.

Annotation views are compatible with UIKit, Core Animation, and other Cocoa Touch frameworks. On the other hand, if you do not need animation or interactivity such as dragging, you can use an MGLAnnotationImage instead to conserve memory and optimize drawing performance.

The MGLUserLocation class defines a specific type of annotation that identifies the user’s current location. You do not create instances of this class directly. Instead, you retrieve an existing MGLUserLocation object from the userLocation property of the map view displayed in your application.

Related examples

See the Customize the user location annotation example to learn how to overide the default user location annotation.

View representing an MGLUserLocation on screen.