Класс QGeoPositionInfoSource

Класс QGeoPositionInfoSource — это абстрактный базовый класс для распространения обновлений местоположения. Подробнее...

• Список всех членов, включая наследуемые

Типы публичного доступа

Свойства

• минимальныйИнтервалОбновления : const int
• предпочтительныеМетодыОпределенияМестоположения : МетодыОпределенияМестоположения
• имяИсточника : const QString
• интервалОбновления : int

Функции публичного доступа

Слот публичного доступа

Сигналы

Статические члены публичного доступа

Подробное описание

Статическая функция QGeoPositionInfoSource::создатьОпределенныйПоУмолчаниюИсточник() создает источник местоположения по умолчанию, соответствующий платформе, если он доступен. В противном случае QGeoPositionInfoSource проверит наличие доступных плагинов, реализующих интерфейс QGeoPositionInfoSourceFactory.

Пользователи подкласса QGeoPositionInfoSource могут запросить текущее местоположение с помощью запроситьОбновление(), или начать и остановить регулярные обновления местоположения с помощью начатьОбновления() и остановитьОбновления(). Когда обновление доступно, генерируется сигнал местоположениеОбновлено(). Последнее известное местоположение можно получить с помощью последнееИзвестноеМестоположение().

Если требуются регулярные обновления местоположения, можно использовать установитьИнтервалОбновления(), чтобы указать, как часто должны генерироваться эти обновления. Если интервал не указан, обновления предоставляются всякий раз, когда они становятся доступными. Например:

// Emit updates every 10 seconds if available
QGeoPositionInfoSource *source = QGeoPositionInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

Чтобы удалить ранее установленный интервал обновления, вызовите установитьИнтервалОбновления() со значением 0.

Документация по типам членов

перечисление QGeoPositionInfoSource::Ошибка

Перечисление Error представляет ошибки, которые могут возникнуть.

Перечисление QGeoPositionInfoSource::PositioningMethodфлаги QGeoPositionInfoSource::PositioningMethods

Определяет типы методов позиционирования.

Тип PositioningMethods является псевдонимом для QFlags<PositioningMethod>. Он хранит логическое ИЛИ сочетание значений PositioningMethod.

Документация по членам-функциям

QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *родитель)

Создаёт источник местоположения с указанным родителем.

[signal] void QGeoPositionInfoSource::возникновениеОшибки(QGeoPositionInfoSource::Ошибка positioningError)

Этот сигнал генерируется после возникновения ошибки. Параметр positioningError описывает тип произошедшей ошибки.

[signal] void QGeoPositionInfoSource::обновлениеМестоположения(const QGeoPositionInfo &обновление)

Если вызван метод startUpdates() или requestUpdate(), этот сигнал генерируется, когда доступно обновление.

Значение обновление содержит значение нового обновления.

[pure virtual slot] void QGeoPositionInfoSource::запросОбновления(int времяОжидания = 0)

Попытка получить текущее местоположение и вывести обновлениеМестоположения() с этой информацией. Если текущее местоположение не может быть найдено в течение заданного времяОжидания (в миллисекундах) или если времяОжидания меньше значения, возвращаемого минимальноеВремяОбновления(), генерируется сигнал возникновениеОшибки() с UpdateTimeoutError.

Если время ожидания равно нулю, время ожидания по умолчанию устанавливается на разумный период времени, соответствующий источнику.

Это ничего не делает, если в данный момент выполняется другой запрос обновления. Однако его можно вызвать даже в том случае, если startUpdates() уже был вызван и в настоящее время выполняются регулярные обновления.

Если источник использует несколько методов позиционирования, он пытается получить текущее местоположение из наиболее точного метода позиционирования в течение заданного времени ожидания.

[pure virtual slot] void QGeoPositionInfoSource::запуститьОбновления()

Начинает генерировать обновления с регулярными интервалами, как указано в setUpdateInterval().

Если setUpdateInterval() не был вызван, источник будет генерировать обновления, как только они появятся.

Сигнал возникновениеОшибки() с UpdateTimeoutError будет сгенерирован, если этот подкласс QGeoPositionInfoSource определит, что не сможет предоставлять регулярные обновления. Это может произойти, если спутниковое позиционирование потеряно или обнаружена аппаратная ошибка. Обновления местоположения будут возобновлены, если данные появятся позже. Ошибка UpdateTimeoutError не будет сгенерирована снова до тех пор, пока периодические обновления не возобновятся.

В iOS, начиная с версии 8, фреймворк Core Location требует дополнительных записей в файле Info.plist с ключами NSLocationAlwaysUsageDescription или NSLocationWhenInUseUsageDescription и строкой, отображаемой в запросе на авторизацию. Ключ NSLocationWhenInUseUsageDescription используется при запросе разрешения на использование служб геолокации, когда приложение находится в фоновом режиме. Ключ NSLocationAlwaysUsageDescription используется при запросе разрешения на использование служб геолокации, когда приложение запущено (как в фоновом, так и в активном режиме). Если оба ключа определены, NSLocationWhenInUseUsageDescription имеет приоритет в режиме фонового приложения.

[pure virtual slot] void QGeoPositionInfoSource::stopUpdates()

Останавливает выброс обновлений с регулярными интервалами.

[signal, since Qt 5.12] void QGeoPositionInfoSource::supportedPositioningMethodsChanged()

Этот сигнал генерируется, когда изменились поддерживаемые методы позиционирования. Причиной изменения может быть включение/выключение пользователем служб геолокации или ограничение служб геолокации определенными типами (например, только GPS). Обратите внимание, что изменения поддерживаемых методов позиционирования не могут быть обнаружены на всех платформах. supportedPositioningMethods() предоставляет обзор текущей поддержки платформы.

Эта функция была введена в Qt 5.12.

[virtual] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Уничтожает источник позиционирования.

[static] QStringList QGeoPositionInfoSource::availableSources()

Возвращает список доступных плагинов-источников. Это включает любой плагин-бекенд по умолчанию для текущей платформы.

[virtual, since Qt 5.14] QVariant QGeoPositionInfoSource::backendProperty(const QString &name) const

Возвращает значение свойства, специфичного для бэкенда, с именем name, если оно присутствует. В противном случае возвращаемое значение будет недействительным. Поддерживаемые свойства, специфичные для бэкенда, перечислены и описаны в Плагины Qt Positioning#Плагины по умолчанию.

Эта функция была введена в Qt 5.14.

См. также setBackendProperty.

[static] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(QObject *parent)

Создаёт и возвращает источник позиционирования с заданным parent, который считывает данные местоположения из системных источников по умолчанию или плагин с наивысшим приоритетом.

Возвращает nullptr если у системы нет источника позиционирования по умолчанию, не удалось найти валидные плагины или у пользователя нет разрешения на доступ к текущему местоположению.

[static, since Qt 5.14] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

Создаёт и возвращает источник позиционирования с заданным parent, который считывает данные местоположения из системных источников по умолчанию или плагин с наивысшим приоритетом.

Возвращает nullptr если у системы нет источника позиционирования по умолчанию, не удалось найти валидные плагины или у пользователя нет разрешения на доступ к текущему местоположению.

Этот метод передаёт parameters фабрике для настройки источника.

Эта функция была введена в Qt 5.14.

[static] QGeoPositionInfoSource *QGeoPositionInfoSource::createSource(const QString &sourceName, QObject *parent)

Создаёт и возвращает источник позиционирования с заданным parent, загрузив плагин с именем sourceName.

Возвращает nullptr если плагин не найден.

[static, since Qt 5.14] QGeoPositionInfoSource *QGeoPositionInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

Создаёт и возвращает источник позиционирования с заданным parent, загрузив плагин с именем sourceName.

Возвращает nullptr если плагин не найден.

Этот метод передаёт parameters фабрике для настройки источника.

Эта функция была введена в Qt 5.14.

[pure virtual] QGeoPositionInfoSource::Error QGeoPositionInfoSource::error() const

Возвращает тип последней произошедшей ошибки.

[pure virtual] QGeoPositionInfo QGeoPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const

Возвращает обновление, содержащее последнее известное положение, или пустое обновление, если таковое отсутствует.

Если fromSatellitePositioningMethodsOnly равно true, возвращает последнее известное положение, полученное с помощью метода позиционирования по спутникам; если таковое отсутствует, возвращает пустое обновление.

[virtual, since Qt 5.14] bool QGeoPositionInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Устанавливает свойство, специфичное для бэкенда, с именем name, со значением value. Возвращает true при успехе, false в противном случае. Свойства, специфичные для бэкенда, могут использоваться для конфигурирования поведения подсистемы позиционирования во время выполнения. Поддерживаемые свойства, специфичные для бэкенда, перечислены и описаны в Плагины Qt Positioning#Плагины по умолчанию.

Эта функция была введена в Qt 5.14.

См. также backendProperty.

[pure virtual] QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::supportedPositioningMethods() const

Возвращает методы позиционирования, доступные для этого источника. Доступность определяется как возможность использования на момент вызова этой функции. Поэтому пользовательские настройки, такие как выключенные службы геолокации или ограничения на поставщиков спутниковой информации, отражаются этой функцией. Уведомления о событиях изменения состояния во время выполнения можно получить с помощью supportedPositioningMethodsChanged().

Не все платформы различают различные методы позиционирования или сообщают о текущих пользовательских настройках устройства. В следующей таблице представлен обзор текущего состояния платформ:

См. также supportedPositioningMethodsChanged() и setPreferredPositioningMethods().