iOSLocation

From Xojo Documentation

Revision as of 20:11, 31 October 2018 by PLefebvre (talk | contribs)

Class (inherits from Object)

New in 2016r2

An iOSLocation allows the user to request location coordinates and updates from the device.

Events
AuthorizationChanged LocationChanged
Properties
Accuracy Enabled
AuthorizationState fa-lock-32.png Handle fa-lock-32.png
Methods
RequestAlwaysAuthorization RequestInUseAuthorization
Enumerations
Accuracies AuthorizationStates

Notes

Use the Debug ↠ Location menu in the iOS Simulator to provide fake locations for testing.

Initial Setup

In the Open event handler of the view, you will need to initialize the location like this:

If MyLocation.AuthorizationState = iOSLocation.AuthorizationStates.AuthorizedWhenInUse Then
' we've got our requested authorization state, start getting LocationChanged events
MyLocation.Enabled = True
Else
' we don't have authorization yet, so ask for it
MyLocation.RequestInUseAuthorization
End If

Sample plist

In addition to requesting authorization, you'll also need to provide a plist file specifying the message to display when authorization is requested. An example plist is below. Save it to a file called iOSLocation.plist and drag it into your iOS project to automatically include it with the app:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>NSLocationWhenInUseUsageDescription</key>
	<string>This app needs access to your location while running.</string>
</dict>
</plist>

See Also

[CLLocationManager https://developer.apple.com/library/ios/documentation/CoreLocation/Reference/CLLocationManager_Class/]