Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

CoreLocation.setPurpose

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

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CoreLocation 2.7 Yes No Yes, macOS only No Yes

MBS( "CoreLocation.setPurpose"; text )

Parameters

Parameter Description Example value
text Your purpose message. "For tracking your location."

Result

Returns "OK" or error.

Description

Sets the 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 method. Because the string is ultimately displayed to the user, you should always load it from a localized strings file.
Available in Mac OS X v10.7 and later.

See also


CoreLocation.setDistanceFilter   -   CoreLocation.significantLocationChangeMonitoringAvailable

Feedback: Report problem or ask question.




Links
MBS FileMaker tutorial videos