<doc> <legacy_id></legacy_id> <name>mobileLocationAuthorizationStatus</name> <type>function</type> <syntax> <example>mobileLocationAuthorizationStatus()</example> </syntax> <synonyms> <synonym>iphoneLocationAuthorizationStatus()</synonym> </synonyms> <summary>Returns the current location authorization status of the calling aplication.</summary> <examples><example><p>put mobileLocationAuthorizationStatus() into tStatus</p><p>if tStatus is "denied" then</p><p> answer "The app cannot access your location"</p><p>end if</p></example> </examples> <history> <introduced version="6.6.4">Added.</introduced> <deprecated version=""></deprecated> <removed version=""></removed> <changed version=""></changed> <experimental version=""></experimental> <nonexperimental version=""></nonexperimental> </history> <objects> </objects> <platforms> <ios/> </platforms> <classes> <mobile/> </classes> <security> </security> <classification> <category>Sensors</category> </classification> <references> <function tag="mobileSensorReading">mobileSensorReading function</function> <function tag="mobileCurrentLocation">mobileCurrentLocation function</function> <command tag="mobileStartTrackingSensor">mobileStartTrackingSensor command</command> <command tag="mobileStopTrackingSensor">mobileStopTrackingSensor command</command> <message tag="locationChanged">locationChanged message</message> <message tag="trackingError">trackingError message</message> </references> <description> <overview>Use the <b>mobileLocationAuthorizationStatus</b> function to find the current location authorization status of the calling application. </overview> <parameters> </parameters> <value>The <b>mobileLocationAuthorizationStatus</b> function returns one of the following strings:<p>&#9;* notDetermined - User has not yet made a choice with regards to this application.</p><p>&#9;* restricted - The application is not authorized to use location services.</p><p>&#9;* denied - User has explicitly denied authorization for this application, or location services are disabled in settings</p><p>&#9;* authorizedAlways - User has granted authorization to use their location at any time, including monitoring for regions, visits, or significant location changes.</p><p>&#9;* authorizedWhenInUse - User has granted authorization to use their location only when the app is visible to them. Authorization to use launch APIs has not been granted</p><p>&#9;</p></value> <comments>This function is available in iOS 8 and above.</comments> </description></doc>

We have also changed the flow of the messages being sent to the user when using Location Services in iOS 8:

- In the standalone application settings tab, the developer can choose the type of the authorization request for their app.

The two available options are either "always" or "when in use". Selecting "always" means that the app will prompt the user to grant authorization to use their location

at *any* time, including monitoring for regions, visits, or significant location changes. The app then has access to the user's location even when the app is in the

background. On the contrary, if "when in use" is selected, the app will prompt the user to grant authorization to use their location only when the app is visible on screen. You can choose only one type, not both. This means that if you go to Settings -> Privacy -> Location, you will see only two choices available ("Never" and either "Always" or "While using the app") for this app, keeping it consistent with other iOS apps.

- When the app is installed (on device or simulator) for the very first time, a dialog will pop up asking the user to authorize the app to use their location

"always" or "when in use", depending on what was previously chosen in the standalone application settings.

- Every time the app is launched, it remembers the user's preference. No other popup dialogs will appear.

- The user can at any time change their preferences in Settings -> Privacy -> Location -> ..

- In that way, you need not modify your existing scripts that used Location Services, in order to add iOS 8 support.