MKMultiPoint Class Reference

Inherits from
MKShape : NSObject
Conforms to
MKAnnotation (MKShape)
NSObject (NSObject)
Framework
/System/Library/Frameworks/MapKit.framework
Availability
Available in iOS 4.0 and later.
Companion guide
Location Awareness Programming Guide
Declared in
MKMultiPoint.h

Overview

The MKMultiPoint class is an abstract superclass used to define shapes composed of multiple points. You should not create instances of this class directly. Instead, you should create instances of the MKPolyline or MKPolygon classes. However, you can use the method and properties of this class to access information about the specific points associated with the line or polygon.

Tasks

Accessing the Points in the Shape

Getting Coordinate Values

Properties

pointCount

The number of points associated with the shape. (read-only)

@property (nonatomic, readonly) NSUInteger pointCount
Availability
  • Available in iOS 4.0 and later.
Declared In
MKMultiPoint.h

points

The array of points associated with the shape. (read-only)

@property (nonatomic, readonly) MKMapPoint *points
Discussion

The number of points in the array is specified by the pointCount property.

Availability
  • Available in iOS 4.0 and later.
Declared In
MKMultiPoint.h

Instance Methods

getCoordinates:range:

Retrieves one or more points associated with the shape and converts them to coordinate values.

- (void)getCoordinates:(CLLocationCoordinate2D *)coords range:(NSRange)range
Parameters
coords

On input, you must provide a C array of structures large enough to hold the desired number of coordinates. On output, this structure contains the requested coordinate data.

range

The range of points you want. The location field indicates the first point you are requesting, with 0 being the first point, 1 being the second point, and so on. The length field indicates the number of points you want. The array in coords must be large enough to accommodate the number of requested coordinates.

Discussion

This method converts the map points into coordinates before returning them to you. If you want the value of each point specified as a map point, you can access the values directly using the points property.

Availability
  • Available in iOS 4.0 and later.
Declared In
MKMultiPoint.h


© 2010 Apple Inc. All Rights Reserved. (Last updated: 2010-05-11)

Did this document help you? Yes It's good, but... Not helpful...