Instance Method

initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:

Creates a location object with the specified coordinate and altitude information.

Declaration

- (instancetype)initWithCoordinate:(CLLocationCoordinate2D)coordinate altitude:(CLLocationDistance)altitude horizontalAccuracy:(CLLocationAccuracy)hAccuracy verticalAccuracy:(CLLocationAccuracy)vAccuracy timestamp:(NSDate *)timestamp;

Parameters

coordinate

A coordinate structure containing the latitude and longitude values.

altitude

The altitude value for the location.

hAccuracy

The radius of uncertainty for the geographical coordinate, measured in meters. Specify a negative number to indicate that the geographical coordinate is invalid.

vAccuracy

The accuracy of the altitude value, measured in meters. Specify a negative number to indicate that the altitude is invalid.

timestamp

The time to associate with the location object. Typically, you specify the current time.

Return Value

A location object initialized with the specified geographical coordinate and altitude information.

Discussion

Use this method to create location objects that are not necessarily based on the user's current location.Typically, you acquire location objects from your CLLocationManager object, which returns the user's actual location. However, you might use this method when you want to represent any location on a map. For example, you might create an object to represent the user's intended destination.

This method records the values you provide, and it initializes other properties to appropriate default values. Specifically, this method sets the speed and course values to -1.

See Also

Initializing a Location Object

- initWithLatitude:longitude:

Creates a location object with the specified latitude and longitude.

- initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:

Creates a location object with the specified coordinate, altitude, and course information.