CoreLocation.purpose
--------------------

An application-provided string that describes the reason for using location services.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [CoreLocation](component_CoreLocation.md) | [2.7](newinversion27.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "CoreLocation.purpose" ) ### Parameters

none

### Result

Returns the purpose text.

### Description

An application-provided string that describes the reason for using location services.  
If the value of this property is non-nil, the system includes the string in the dialog that asks the user whether it is all right for your application to use location services. The string gives you a chance to explain the reason for why your application is using location services.  
You must set the value of this property prior to calling the [CoreLocation.startUpdatingLocation](CoreLocationstartUpdatingLocation.md) method. Because the string is ultimately displayed to the user, you should always load it from a localized strings file.  
Available in macOS 10.7 and later.  
### See also

- [CoreLocation.course](CoreLocationcourse.md)
- [CoreLocation.setPurpose](CoreLocationsetPurpose.md)
- [CoreLocation.startUpdatingLocation](CoreLocationstartUpdatingLocation.md)

This function is free to use.

Created 18th August 2014 , last changed 10th August 2020

  
[CoreLocation.longitude](CoreLocationlongitude.md) - [CoreLocation.requestAlwaysAuthorization](CoreLocationrequestAlwaysAuthorization.md)

[HTML Version](CoreLocationpurpose.shtml)