MLNShape class

MLNShape is an abstract class that represents a shape or annotation. Shapes constitute the content of a map — not only the overlays atop the map, but also the content that forms the base map.

Create instances of MLNPointAnnotation, MLNPointAnnotation, MLNPointAnnotation, MLNMultiPolyline, MLNMultiPolyline, MLNMultiPolyline, or MLNMultiPolyline in order to use MLNShape's methods. Do not create instances of MLNShape directly, and do not create your own subclasses of this class. The shape classes correspond to the Geometry object types in the GeoJSON standard, but some have nonstandard names for backwards compatibility.

Although you do not create instances of this class directly, you can use its MLNShape/shapeWithData:encoding:error: factory method to create one of the concrete subclasses of MLNShape noted above from GeoJSON data. To access a shape’s attributes, use the corresponding MLNFeature class instead.

You can add shapes to the map by adding them to an MLNShapeSource object. Configure the appearance of an MLNShapeSource’s or MLNShapeSource’s shapes collectively using a concrete instance of MLNVectorStyleLayer. Alternatively, you can add some kinds of shapes directly to a map view as annotations or overlays.

You can filter the features in a MLNVectorStyleLayer or vary their layout or paint attributes based on the features’ geographies. Pass an MLNShape into an NSPredicate with the format SELF IN %@ or %@ CONTAINS SELF and set the MLNVectorStyleLayer/predicate property to that predicate, or set a layout or paint attribute to a similarly formatted NSExpression.