Класс QGeoPositionInfoSource

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

Этот класс был представлен в Qt 5.2.

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

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

Свойства

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

Публичные функции

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

Сигналы

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

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

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

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

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

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

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

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

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

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

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

перечисление QGeoPositionInfoSource::МетодОпределенияПозициифлаги QGeoPositionInfoSource::МетодыОпределенияПозиции

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

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

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

QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *parent)

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

[signal] void QGeoPositionInfoSource::error(QGeoPositionInfoSource::Error positioningError)

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

Этот сигнал не генерируется, когда произошел updateTimeout().

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя функции Qt предоставляет удобную вспомогательную функцию для получения указателя функции, как показано в этом примере:

connect(geoPositionInfoSource, QOverload<QGeoPositionInfoSource::Error>::of(&QGeoPositionInfoSource::error),
    [=](QGeoPositionInfoSource::Error positioningError){ /* ... */ });

[signal] void QGeoPositionInfoSource::positionUpdated(const QGeoPositionInfo &update)

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

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

[pure virtual slot] void QGeoPositionInfoSource::requestUpdate(int timeout = 0)

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

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

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

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

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

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

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

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

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

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

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

[signal] void QGeoPositionInfoSource::supportedPositioningMethodsChanged()

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

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

[signal] void QGeoPositionInfoSource::updateTimeout()

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

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

Хотя срабатывание этого сигнала может считаться условием ошибки, это не подразумевает генерацию сигнала error(). Необходимо только сгенерировать сигнал updateTimeout() для обозначения таймаута.

[virtual] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Удаляет источник местоположения.

[static] QStringList QGeoPositionInfoSource::availableSources()

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

QVariant QGeoPositionInfoSource::backendProperty(const QString &name) const

Возвращает значение свойства бэкенда с именем name, если оно присутствует. В противном случае возвращаемое значение будет недопустимым. Поддерживаемые свойства бэкенда перечислены и описаны в Qt Positioning plugins#Default plugins.

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

См. также setBackendProperty.

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

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

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

[static] 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.

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

[static] 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, возвращает последнее известное местоположение, полученное с помощью методов спутникового позиционирования; если такового нет, возвращается пустое обновление.

QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::preferredPositioningMethods() const

Возвращает методы позиционирования, заданные с помощью setPreferredPositioningMethods().

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

bool QGeoPositionInfoSource::setBackendProperty(const QString &name, const QVariant &value)

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

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

См. также backendProperty.

[virtual] void QGeoPositionInfoSource::setPreferredPositioningMethods(QGeoPositionInfoSource::PositioningMethods methods)

Устанавливает предпочтительные методы позиционирования для этого источника в methods.

Если methods включает метод, не поддерживаемый источником, такой метод будет проигнорирован.

Если methods не включает ни одного доступного/поддерживаемого метода источником, предпочтительные методы будут установлены в набор методов, доступных для источника. Если у источника нет доступных методов (например, из-за отключенной службы местоположения или отсутствия такой службы), переданные methods принимаются как есть.

Примечание: При переопределении этого метода подклассы должны вызывать реализацию базового метода, чтобы убедиться, что preferredPositioningMethods() возвращает правильное значение.

См. также preferredPositioningMethods() и supportedPositioningMethods().

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

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

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

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