Qt Positioning Core Location plugin

Overview

The plugin wraps iOS and macOS positioning subsystems. It is only available on Apple platforms that support corelocation. The plugin provides only positioning information.

This plugin can be loaded by using the provider name corelocation.

Parameters

The following table lists parameters that can be passed to the corelocation plugin.

On iOS, the application can ask for two levels of location permissions:

• When In Use - makes location updates available only when someone uses your app.
• Always - makes location updates available at any time, and lets the system launch your app quietly to handle some updates.

By default, only the When In Use permission is requested. The RequestAlwaysPermission parameter is used to explicitly reqeust for Always permission.

Position source usage example

The following examples show how to create a corelocation PositionSource using different permission levels.

QML

 // default - When In Use permission.
 PositionSource {
     name: "corelocation"
 }
 // RequestAlwaysPermission = false. Same as default.
 PositionSource {
     name: "corelocation"
     PluginParameter { name: "RequestAlwaysPermission"; value: false }
 }
 // RequestAlwaysPermission = true. Request Always permission.
 PositionSource {
     name: "corelocation"
     PluginParameter { name: "RequestAlwaysPermission"; value: true }
 }

C++

 // default - When In Use permission.
 QGeoPositionInfoSource *defaultSource
                 = QGeoPositionInfoSource::createSource("corelocation", this);
 // RequestAlwaysPermission = false. Same as default.
 params["RequestAlwaysPermission"] = false;
 QGeoPositionInfoSource *whenInUseSource
                 = QGeoPositionInfoSource::createSource("corelocation", params, this);
 // RequestAlwaysPermission = true. Request Always permission.
 params["RequestAlwaysPermission"] = true;
 QGeoPositionInfoSource *alwaysSource
                 = QGeoPositionInfoSource::createSource("corelocation", params, this);