QGeoPositionInfoSource Class

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

멤버 함수 문서

[explicit] QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *parent)

지정된 parent 로 위치 소스를 생성합니다.

[virtual noexcept] 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)

sourceName 이라는 플러그인을 로드하여 주어진 parent 으로 위치 소스를 생성하고 반환합니다.

플러그인을 찾을 수 없으면 nullptr 을 반환합니다.

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

sourceName 이라는 플러그인을 로드하여 주어진 parent 으로 위치 소스를 생성하고 반환합니다.

플러그인을 찾을 수 없으면 nullptr 을 반환합니다.

이 메서드는 parameters 을 팩토리로 전달하여 소스를 구성합니다.

이 함수는 Qt 5.14에 도입되었습니다.

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

마지막으로 발생한 오류 유형을 반환합니다.

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

이 신호는 오류가 발생한 후에 전송됩니다. positioningError 매개 변수는 발생한 오류 유형을 설명합니다.

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

마지막으로 알려진 위치가 포함된 업데이트를 반환하거나, 사용할 수 없는 경우 null 업데이트를 반환합니다.

fromSatellitePositioningMethodsOnly 이 참이면 위성 위치 확인 방법에서 수신한 마지막으로 알려진 위치를 반환하고, 사용 가능한 위치가 없으면 null 업데이트가 반환됩니다.

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

startUpdates() 또는 requestUpdate()이 호출되면 업데이트를 사용할 수 있게 되면 이 신호가 전송됩니다.

update 값은 새 업데이트의 값을 보유합니다.

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

현재 위치를 가져와 이 정보와 함께 positionUpdated()를 전송하려고 시도합니다. 지정된 timeout (밀리초) 내에 현재 위치를 찾을 수 없거나 timeout 이 minimumUpdateInterval()에서 반환한 값보다 작으면 UpdateTimeoutError 과 함께 errorOccurred() 신호가 전송됩니다.

시간 제한이 0이면 기본값은 소스에 적합한 합리적인 시간 제한 기간으로 설정됩니다.

다른 업데이트 요청이 진행 중이면 아무 일도 하지 않습니다. 그러나 startUpdates()가 이미 호출되어 정기 업데이트가 진행 중인 경우에도 호출할 수 있습니다.

소스가 여러 위치 지정 방법을 사용하는 경우 주어진 시간 제한 내에 가장 정확한 위치 지정 방법에서 현재 위치를 가져오려고 시도합니다.

[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 slot] void QGeoPositionInfoSource::startUpdates()

setUpdateInterval()에 지정된 대로 일정한 간격으로 업데이트를 내보내기 시작합니다.

setUpdateInterval()가 호출되지 않은 경우 소스는 업데이트를 사용할 수 있게 되는 즉시 업데이트를 전송합니다.

이 QGeoPositionInfoSource 서브클래스가 정기 업데이트를 제공할 수 없다고 판단하면 UpdateTimeoutError 신호가 포함된 errorOccurred() 신호가 전송됩니다. 이는 위성 수정이 손실되거나 하드웨어 오류가 감지된 경우 발생할 수 있습니다. 나중에 데이터를 사용할 수 있게 되면 위치 업데이트가 다시 시작됩니다. UpdateTimeoutError 오류는 정기 업데이트가 재개될 때까지 다시 발생하지 않습니다.

iOS의 경우 버전 8부터 코어 위치 프레임워크는 애플리케이션의 Info.plist에 NSLocationAlwaysUsageDescription 또는 NSLocationWhenInUseUsageDescription 키와 인증 프롬프트에 표시할 문자열을 추가로 입력해야 합니다. 앱이 포그라운드에 있는 동안 위치 서비스를 사용할 수 있는 권한을 요청할 때 NSLocationWhenInUseUsageDescription 키가 사용됩니다. 앱이 실행 중일 때마다(포그라운드 및 백그라운드 모두) 위치 서비스 사용 권한을 요청할 때 NSLocationAlwaysUsageDescription 키가 사용됩니다. 두 항목이 모두 정의되어 있는 경우 NSLocationWhenInUseUsageDescription이 포그라운드 모드에서 우선권을 갖습니다.

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

일정한 간격으로 업데이트 전송을 중지합니다.

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

이 소스에 사용 가능한 포지셔닝 메서드를 반환합니다. 사용 가능 여부는 이 함수를 호출하는 시점에 사용 가능한 것으로 정의됩니다. 따라서 위치 서비스를 끄거나 위성 기반 위치 제공업체로 제한하는 등의 사용자 설정이 이 함수에 반영됩니다. 상태 변경 시 런타임 알림은 supportedPositioningMethodsChanged()를 통해 받을 수 있습니다.

모든 플랫폼이 서로 다른 위치 추적 방법을 구분하거나 디바이스의 현재 사용자 구성을 전달하는 것은 아닙니다. 다음 표는 현재 플랫폼 상황에 대한 개요를 제공합니다:

supportedPositioningMethodsChanged() 및 setPreferredPositioningMethods()도 참조하세요 .

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

이 신호는 지원되는 위치 추적 방법이 변경되었을 때 발생합니다. 변경의 원인은 사용자가 위치 서비스를 켜거나 끄거나 위치 서비스를 특정 유형(예: GPS 전용)으로 제한하는 것일 수 있습니다. 지원되는 위치추적 방법의 변경이 모든 플랫폼에서 감지되는 것은 아닙니다. supportedPositioningMethods()에서 현재 지원되는 플랫폼에 대한 개요를 확인할 수 있습니다.

이 기능은 Qt 5.12에 도입되었습니다.