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 plugins#Default plugins에 나열되어 있으며 설명되어 있습니다.

이 함수는 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 가 true인 경우, 위성 위치 측정 방법을 통해 수신된 마지막으로 알려진 위치를 반환하며, 해당 정보가 없는 경우에는 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 plugins#Defaultplugins에 나열되어 있으며 설명되어 있습니다.

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

backendProperty도 참조하십시오 .

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

setUpdateInterval()에서 지정한 대로 일정한 간격으로 업데이트를 전송하기 시작합니다.

setUpdateInterval()가 호출되지 않은 경우, 소스는 업데이트가 준비되는 즉시 이를 발행합니다.

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

iOS 8 버전부터 Core Location 프레임워크는 애플리케이션의 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에서 도입되었습니다.