Класс QGeoPositionInfoSource

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

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

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

Свойства

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

• 1 свойство унаследовано от QObject

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

• 34 публичных функции унаследованы от QObject

Публичные слоты

• 1 публичный слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

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

• 10 статических публичных членов унаследованы от QObject

Дополнительные унаследованные члены

• 1 публичная переменная унаследована от QObject
• 9 защищенных функций унаследованы от QObject
• 2 защищенные переменные унаследованы от QObject

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

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

Статическая функция 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 — это typedef для QFlags<PositioningMethod>. Он хранит логическое ИЛИ сочетание значений PositioningMethod.

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

QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *parent)

Создаёт источник позиционирования с указанным parent.

[virtual] QGeoPositionInfoSource::~QGeoPositionInfoSource()

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

[static] QStringList QGeoPositionInfoSource::availableSources()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::preferredPositioningMethods() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает доступные методы позиционирования для этого источника.

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

[signal] void QGeoPositionInfoSource::updateTimeout()

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

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

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