Location When In Use Usage Description property

Official Content
This documentation is valid for:
Specifies the reason for your app to access the user's location information while your app is in use.

Scope

Objects: Menu, Panel, Work With (Only Main Objects)
Generators: Apple

Description

This property is offered under the Purpose Strings properties group available for Main Smart Device objects under the Apple group.

When an API that involves user privacy is used in an iOS device, as of iOS 8.0 you must ask the user for permission. For this reason, they must define the message that will be displayed to users in a dialog box that will prompt them for permission, describing the reason(s) why the application is going to use the content.

In particular, when using the Geolocation external object, this is the property where you have to enter the reason(s) why the application will access the user's location while running in the foreground. More specifically, this is required also if an Maps Control Type is used with Show My Location or the map is centered on the user's location, or if the StartTracking method is used.

Notes

  • A warning message like this will be displayed if you use location services but this property is not set.
    warning: In iOS 8.0 or later, a value for one of these properties is required when you use location services. ('Location When In Use Usage Description' of <Menu|Panel> for Smart Devices instance '%')
    The iOS version may vary depending on which XCode version is used with support as of iOS 8.0.

Run-time/Design-time

This property applies only at design-time.

How to apply changes

To apply the corresponding changes when the property value is configured, Build the Main Object.

See Also