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


init(coordinate: CLLocationCoordinate2D, altitude: CLLocationDistance, horizontalAccuracy hAccuracy: CLLocationAccuracy, verticalAccuracy vAccuracy: CLLocationAccuracy, course: CLLocationDirection, speed: CLLocationSpeed, timestamp: Date)



A coordinate structure containing the latitude and longitude values.


The altitude value for the location.


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


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


The direction of travel for the location, measured in degrees relative to due north and continuing clockwise around the compass.


The current speed associated with this location, measured in meters per second.


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, altitude, and course information.


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.

See Also

Initializing a Location Object

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software