このページでは

QGeoAreaMonitorInfo Class

QGeoAreaMonitorInfo クラスは、近接監視の対象となるエリアまたは領域のパラメータを定義します。詳細...

ヘッダー: #include <QGeoAreaMonitorInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

パブリック関数

QGeoAreaMonitorInfo(const QString &name = QString())
QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)
(since 6.2) QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)
~QGeoAreaMonitorInfo()
QGeoShape area() const
QDateTime expiration() const
QString identifier() const
bool isPersistent() const
bool isValid() const
QString name() const
QVariantMap notificationParameters() const
void setArea(const QGeoShape &newShape)
void setExpiration(const QDateTime &expiry)
void setName(const QString &name)
void setNotificationParameters(const QVariantMap &parameters)
void setPersistent(bool isPersistent)
(since 6.2) void swap(QGeoAreaMonitorInfo &other)
(since 6.2) QGeoAreaMonitorInfo &operator=(QGeoAreaMonitorInfo &&other)
QGeoAreaMonitorInfo &operator=(const QGeoAreaMonitorInfo &other)
bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)
bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)
QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)

詳細な説明

エリア監視の目的は、ユーザーが関心のあるエリアに近づいた際に、そのことをユーザーに知らせることです。一般的に、このようなエリアは `QGeoCircle` によって記述されます。円の中心は関心のある場所を表し、その周囲の領域は通知が送信される地理的範囲を特定します。

QGeoAreaMonitorInfo オブジェクトは、名前が空でなく、有効なarea() を持つ場合に有効です。このようなオブジェクトは、監視プロセスを開始および停止するために、QGeoAreaMonitorSource に登録する必要があります。位置特定エンジンはアクティブな状態を維持し、現在の位置を各 QGeoAreaMonitorInfo インスタンスと照合する必要があるため、広範囲にわたる監視はリソースを大量に消費する可能性があることに注意してください。

システムへの負荷をさらに軽減するために、設定可能なオプション属性が用意されています。各監視対象エリアには有効期限を設定でき、有効期限に達すると、そのエリアは自動的に監視ソースから削除されます。 もう 1 つのオプションとして、監視対象エリアの永続性を調整する方法があります。isPersistent() を呼び出した QGeoAreaMonitorInfo は、現在のアプリケーションのライフタイムを超えてアクティブな状態を維持します。監視アプリケーションが実行されていない状態で監視対象エリアに入ると、アプリケーションが起動されます。なお、この機能はすべてのプラットフォームで利用できるわけではありません。利用可否はQGeoAreaMonitorSource::supportedAreaMonitorFeatures() を使用して確認できます。

QGeoAreaMonitorSourceも参照してください 。

メンバ関数のドキュメント

[explicit] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QString &name = QString())

指定されたname を使用して、QGeoAreaMonitorInfoオブジェクトを構築します。

name()も参照してください 。

QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(const QGeoAreaMonitorInfo &other)

other のコピーとして、QGeoAreaMonitorInfoオブジェクトを生成します。

[constexpr noexcept default, since 6.2] QGeoAreaMonitorInfo::QGeoAreaMonitorInfo(QGeoAreaMonitorInfo &&other)

other から移動して、QGeoAreaMonitorInfoオブジェクトを生成します。

なお、移動元の QGeoAreaMonitorInfo に対しては、破棄するか、または代入を行うことしかできません。デストラクタや代入演算子以外の関数を呼び出した場合の結果は未定義です。

この関数は Qt 6.2 で導入されました。

[noexcept] QGeoAreaMonitorInfo::~QGeoAreaMonitorInfo()

デストラクタ

QGeoShape QGeoAreaMonitorInfo::area() const

監視対象領域の境界を返します。この領域は空であってはなりません。

setArea()も参照してください 。

QDateTime QGeoAreaMonitorInfo::expiration() const

有効期限を返します。

アクティブなQGeoAreaMonitorInfo の有効期限が切れると、そのリージョンの監視は停止され、QGeoAreaMonitorInfo オブジェクトはactive monitors のリストから削除されます。

有効期限付きQDateTime が無効な場合、QGeoAreaMonitorInfo オブジェクトは有効期限がないものとして扱われます。これにより、オブジェクトが永続的な場合は監視期間が無期限となり、非永続的な場合は現在のアプリケーションが終了するまで監視が続きます。

setExpiration() およびQGeoAreaMonitorSource::activeMonitors()も参照してください 。

QString QGeoAreaMonitorInfo::identifier() const

QGeoAreaMonitorInfo オブジェクトの識別子を返します。この識別子は、新しいQGeoAreaMonitorInfo オブジェクトの生成時に自動的に生成されます。

bool QGeoAreaMonitorInfo::isPersistent() const

QGeoAreaMonitorInfo が永続的である場合、true を返します。このプロパティのデフォルト値は false です。

非永続的なQGeoAreaMonitorInfo は、そのモニターオブジェクトを所有するアプリケーションが停止すると、システムによって削除されます。永続的なオブジェクトはアクティブな状態を維持し、アプリケーションが再起動した際に取得することができます。

システムが永続的なQGeoAreaMonitorInfo に関連付けられたイベントをトリガーすると、関連するアプリケーションが再起動され、適切なシグナルが発信されます。

setPersistent()も参照してください 。

bool QGeoAreaMonitorInfo::isValid() const

モニターが有効な場合、true を返します。有効な `QGeoAreaMonitorInfo ` は、name() の値が空ではなく、かつ監視対象領域が `empty()` ではないものです。それ以外の場合、この関数は false を返します。

QString QGeoAreaMonitorInfo::name() const

QGeoAreaMonitorInfo オブジェクトの名前を返します。この名前は、ユーザーへの表示目的に使用されます。

setName()も参照してください 。

QVariantMap QGeoAreaMonitorInfo::notificationParameters() const

このQGeoAreaMonitorInfo で使用される、プラットフォーム固有のパラメータのセットを返します。

setNotificationParameters()も参照してください 。

void QGeoAreaMonitorInfo::setArea(const QGeoShape &newShape)

監視対象エリアをnewShape に設定します。

area()も参照してください 。

void QGeoAreaMonitorInfo::setExpiration(const QDateTime &expiry)

有効期限の日時を「expiry 」に設定します。

expiration()も参照してください 。

void QGeoAreaMonitorInfo::setName(const QString &name)

name をユーザーに表示するように設定します。

name()も参照してください 。

void QGeoAreaMonitorInfo::setNotificationParameters(const QVariantMap &parameters)

QGeoAreaMonitorInfo で使用される、プラットフォーム固有のparameters のセットを設定します。

notificationParameters()も参照してください 。

void QGeoAreaMonitorInfo::setPersistent(bool isPersistent)

QGeoAreaMonitorInfo オブジェクトの永続化設定を `isPersistent` に設定します。

このフラグを設定しても、QGeoAreaMonitorSource が永続的なモニタリングをサポートしていることを意味するわけではないことに注意してください。この機能の利用可否を確認するには、QGeoAreaMonitorSource::supportedAreaMonitorFeatures() を使用できます。

isPersistent()も参照してください 。

[noexcept, since 6.2] void QGeoAreaMonitorInfo::swap(QGeoAreaMonitorInfo &other)

この `QGeoAreaMonitorInfo ` オブジェクトを `other` と入れ替えます。この操作は非常に高速で、失敗することはありません。

この関数は Qt 6.2 で導入されました。

[noexcept, since 6.2] QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(QGeoAreaMonitorInfo &&other)

other をこのQGeoAreaMonitorInfo オブジェクトへ移動代入し、このQGeoAreaMonitorInfo オブジェクトへの参照を返します。

なお、移動元の `QGeoAreaMonitorInfo ` に対しては、破棄または代入のみが可能です。デストラクタや代入演算子のいずれか以外の関数を呼び出した場合の結果は未定義となります。

この関数は Qt 6.2 で導入されました。

QGeoAreaMonitorInfo &QGeoAreaMonitorInfo::operator=(const QGeoAreaMonitorInfo &other)

このQGeoAreaMonitorInfo オブジェクトに `other ` を割り当て、このQGeoAreaMonitorInfo オブジェクトへの参照を返します。

関連する非メンバー

bool operator!=(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)

lhs オブジェクトの値のいずれかが、rhs オブジェクトの値と一致しない場合、true を返します。それ以外の場合は、false を返します。

QDataStream &operator<<(QDataStream &stream, const QGeoAreaMonitorInfo &monitor)

指定されたmonitor を、指定されたstream に書き込みます。

「Qt データ型のシリアライズ」も参照してください 。

bool operator==(const QGeoAreaMonitorInfo &lhs, const QGeoAreaMonitorInfo &rhs)

lhs オブジェクトのすべての値が、rhs オブジェクトの値と同一である場合は、true を返します。それ以外の場合は、false を返します。

QDataStream &operator>>(QDataStream &stream, QGeoAreaMonitorInfo &monitor)

指定されたstream からエリア監視データを読み取り、指定されたmonitor に格納します。

「Qtデータ型のシリアライズ」も参照してください 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.