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.

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 developers 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 developers 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 SD 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 the developer uses 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 changes made by this property, do a Build All.

Scope

Objects: Main Smart Devices
Platforms: Smart Devices(IOS)

See Also

Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.