#import <Foundation/Foundation.h>
#import <CoreLocation/CoreLocation.h>

#import "MLNFoundation.h"
#import "MLNShape.h"

NS_ASSUME_NONNULL_BEGIN

/**
 An `MLNPointAnnotation` object represents a one-dimensional shape located at a
 single geographical coordinate. Depending on how it is used, an
 `MLNPointAnnotation` object is known as a point annotation or point shape. For
 example, you could use a point shape to represent a city at low zoom levels, an
 address at high zoom levels, or the location of a long press gesture.

 You can add point shapes to the map by adding them to an `MLNShapeSource`
 object. Configure the appearance of an `MLNShapeSource`’s or
 `MLNVectorTileSource`’s point shapes collectively using an `MLNCircleStyleLayer` or
 `MLNSymbolStyleLayer` object.

 For more interactivity, add a selectable point annotation to a map view using
 the `-[MLNMapView addAnnotation:]` method. Alternatively, define your own model
 class that conforms to the `MLNAnnotation` protocol. Configure a point
 annotation’s appearance using
 `-[MLNMapViewDelegate mapView:imageForAnnotation:]` or
 `-[MLNMapViewDelegate mapView:viewForAnnotation:]` (iOS only). A point
 annotation’s `MLNShape.title` and `MLNShape.subtitle` properties define the
 default content of the annotation’s callout (on iOS) or popover (on macOS).

 To group multiple related points together in one shape, use an
 `MLNPointCollection` or `MLNShapeCollection` object. To access
 a point’s attributes, use an `MLNPointFeature` object.

 A point shape is known as a
 <a href="https://tools.ietf.org/html/rfc7946#section-3.1.2">Point</a> geometry
 in GeoJSON.
 
 #### Related examples
 See the <a href="https://docs.mapbox.com/ios/maps/examples/marker/">
 Mark a place on the map with an annotation</a>, <a href="https://docs.mapbox.com/ios/maps/examples/marker-image/">
 Mark a place on the map with an image</a>, and <a href="https://docs.mapbox.com/ios/maps/examples/default-callout/">
 Default callout usage</a> examples to learn how to add `MLNPointAnnotation`
 objects to your map.
 */
MLN_EXPORT
@interface MLNPointAnnotation : MLNShape

/**
 The coordinate point of the shape, specified as a latitude and longitude.
 */
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

@end

NS_ASSUME_NONNULL_END