QPlace Class
QPlaceクラスは、場所に関するデータのセットを表します。詳細...
Header: | #include <QPlace> |
qmake: | QT += location |
パブリック関数
QPlace() | |
QPlace(const QPlace &other) | |
~QPlace() | |
void | appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail) |
QString | attribution() const |
QList<QPlaceCategory> | categories() const |
QList<QPlaceContactDetail> | contactDetails(const QString &contactType) const |
QStringList | contactTypes() const |
QPlaceContent::Collection | content(QPlaceContent::Type type) const |
bool | detailsFetched() const |
QPlaceAttribute | extendedAttribute(const QString &attributeType) const |
QStringList | extendedAttributeTypes() const |
QPlaceIcon | icon() const |
void | insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content) |
bool | isEmpty() const |
QGeoLocation | location() const |
QString | name() const |
QString | placeId() const |
QString | primaryEmail() const |
QString | primaryFax() const |
QString | primaryPhone() const |
QUrl | primaryWebsite() const |
QPlaceRatings | ratings() const |
void | removeContactDetails(const QString &contactType) |
void | removeExtendedAttribute(const QString &attributeType) |
void | setAttribution(const QString &attribution) |
void | setCategories(const QList<QPlaceCategory> &categories) |
void | setCategory(const QPlaceCategory &category) |
void | setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details) |
void | setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content) |
void | setDetailsFetched(bool fetched) |
void | setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute) |
void | setIcon(const QPlaceIcon &icon) |
void | setLocation(const QGeoLocation &location) |
void | setName(const QString &name) |
void | setPlaceId(const QString &identifier) |
void | setRatings(const QPlaceRatings &rating) |
void | setSupplier(const QPlaceSupplier &supplier) |
void | setTotalContentCount(QPlaceContent::Type type, int totalCount) |
void | setVisibility(QLocation::Visibility visibility) |
QPlaceSupplier | supplier() const |
int | totalContentCount(QPlaceContent::Type type) const |
QLocation::Visibility | visibility() const |
QPlace & | operator=(const QPlace &other) |
保護された関数
QPlace(const QSharedDataPointer<QPlacePrivate> &dd) |
関連する非会員
bool | operator!=(const QPlace &lhs, const QPlace &rhs) |
bool | operator==(const QPlace &lhs, const QPlace &rhs) |
詳細説明
場所とは興味のある場所のことで、お気に入りのレストランや公園、誰かの家などがあります。QPlace オブジェクトは、その場所に関する様々な情報のコンテナとして機能することで、場所を表します。
この情報は、2つの大きな分類に分けることができます。
- 詳細
- リッチコンテンツ
場所の詳細は、名前、場所、連絡先などの場所のプロパティで構成されています。検索中に場所が返されると、これらの詳細が入力されます。帯域幅を節約するために、ユーザーが興味を持っている場合は、場所ごとに個別に取得することができます場所についてのさらなる詳細が存在することがあります。QPlace::detailsFetched() 関数を使用すると、使用可能なすべての詳細情報が取得済みかどうかを確認することができ、取得済みでない場合はQPlaceManager::getPlaceDetails() を使用して取得できます。どの詳細情報が検索中に入力され、どの詳細情報を個別に取得する必要があるかは、プロバイダによって異なります。詳細はプラグインのドキュメントを参照してください。
プレイスメントのリッチコンテンツは、画像、レビュー、論説などの項目から構成されます。多くのリッチコンテンツアイテムが存在する可能性があるため、それらはプレイス詳細とは別に扱われます。それらは、QPlaceManager::getPlaceContent() を介して、ページングされた方法で取得することができます。必要であれば、コンテンツはプレイスに割り当てられ、便利なコンテナとして機能します。
連絡先情報
場所の連絡先情報は、contact types の共通のセットに基づいています。場所のすべての電話番号を取得するには、次のようにします:
if(place.contactTypes().contains(QPlaceContactDetail::Phone)) {for(constQPlaceContactDetailif (place.contactTypes().contains( ::Phone)) { for (const number: place.contactDetails(QPlaceContactDetail::Phone)) qDebug() << number.label() << ":" << number.value(); }
コンタクト・タイプは、プロバイダーが新しいコンタクト・タイプを導入できるようにするために、文字列値で設計されています。
便宜上、各タイプの最初のコンタクト詳細の値を返す一連の関数があります。
拡張属性
場所は、正式なAPIでカバーされていない追加属性を持つことができます。連絡先と同様に、属性は共通のattribute types 。 拡張属性を取得するには、次のようにします:
もし(place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours)) qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();
属性タイプは、プロバイダーが新しい属性タイプを導入できるようにするために、文字列値で設計されています。
コンテンツ
QPlaceオブジェクトは、画像やレビューなどのリッチコンテンツを保持するための便利なコンテナであることを意図しています。コンテンツの取得は、QPlaceManager::getPlaceContent ()を介して行われる必要があります。
コンテンツは、コンテンツのインデックスとコンテンツそのものを含むQPlaceContent::Collection 。これにより、開発者は特定のアイテムがすでに取得されているかどうかをチェックし、もし取得されていなければ、そのコンテンツをリクエストすることができます。
アトリビューション
プレイスには、リッチテキストによる帰属文字列のフィールドがあります。プロバイダによっては、プレイスがユーザに表示されるときに属性が表示されることを要求するかもしれません。
カテゴリー
異なるカテゴリーをプレイスに割り当てることができます。プレイスを保存するとき、意味のあるデータはカテゴリーIDだけで、残りのカテゴリーデータは事実上無視されます。プレイスを保存する前に、カテゴリはすでに存在していなければなりません(新しいカテゴリを作成し、それをプレイスに割り当て、プレイスを保存し、カテゴリが作成されることを期待することはできません)。
保存時の注意
Places APIは現在、core の詳細のみを保存するように設計されています。画像やレビューのようなリッチコンテンツや、サプライヤーやレーティングのような詳細を保存することはサポートされていません。通常、マネージャーは保存時にこれらのフィールドを無視します。
Places APIは、以下のコアな詳細の保存のみをサポートしています:
- 名前
- 場所ID
- 場所
- 連絡先の詳細
- アイコン
- カテゴリー(場所を説明するタグのような名前)
- 可視性の範囲
プロバイダがこれらのサブセットしかサポートしていない可能性もあります。詳しくはプラグインのドキュメントをご覧ください。
レーティング、拡張属性、画像、レビュー、社説、サプライヤーなどのプロパティの保存は、Places APIではサポートされていません。
メンバ関数ドキュメント
QPlace::QPlace()
空のプレース・オブジェクトを構築する。
[protected]
QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)
dd をプライベート実装として、プレース・オブジェクトを構築します。
[noexcept]
QPlace::QPlace(const QPlace &other)
other のコピーを作成する。
[noexcept]
QPlace::~QPlace()
この場所を破壊する。
void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)
指定されたcontactType の連絡先detail を追加する。
一般的なcontact types のリストはQPlaceContactDetail を参照のこと。
QString QPlace::attribution() const
場所の属性文字列をリッチテキストで返します。プロバイダによっては、 プレースがエンドユーザに表示される際には必ずその属性が表示されなければならないというような要件を持つ場合があります。
setAttribution()も参照ください 。
QList<QPlaceCategory> QPlace::categories() const
この場所が属するカテゴリを返します。
setCategories()も参照ください 。
QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const
指定されたcontactType の連絡先のリストを返す。
一般的なcontact types の一覧はQPlaceContactDetail を参照。
setContactDetails()も参照 。
QStringList QPlace::contactTypes() const
この場所が持つ連絡先の詳細を返す。
一般的なcontact types の一覧はQPlaceContactDetail を参照ください。
QPlaceContent::Collection QPlace::content(QPlaceContent::Type type) const
ある場所に関連付けられたコンテンツのコレクションを返す。このコレクションはマップであり、キーはコンテンツオブジェクトのインデックス、値はコンテンツオブジェクトそのものである。
type は、どの種類のコンテンツを取得するかを指定する。
setContent()も参照のこと 。
bool QPlace::detailsFetched() const
この場所の詳細が取得された場合は true を返し、そうでない場合は false を返します。
setDetailsFetched()も参照してください 。
QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const
指定されたattributeType に対応する拡張属性を返します。場所がその特定の属性タイプを持っていない場合、デフォルトで構築された QPlaceExtendedAttribute が返されます。
setExtendedAttribute()も参照してください 。
QStringList QPlace::extendedAttributeTypes() const
このプレイスが持つ拡張属性のタイプを返します。
QPlaceIcon QPlace::icon() const
その場所のアイコンを返します。
setIcon()も参照 。
void QPlace::insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
与えられたtype のcontent のコレクションを場所に追加する。すでに存在するcontent のインデックスは上書きされる。
bool QPlace::isEmpty() const
場所のすべてのフィールドが空かどうかを示すブール値を返します。
QGeoLocation QPlace::location() const
その場所の位置を返す。
setLocation()も参照 。
QString QPlace::name() const
地名を返す。
setName()も参照 。
QString QPlace::placeId() const
場所の識別子を返します。場所の識別子は、それを生成したQPlaceManager に対してのみ意味があり、マネージャー間で転送することはできません。場所の識別子は普遍的に一意であることは保証されませんが、それを生成したマネージャーにとっては一意です。
setPlaceId()も参照してください 。
QString QPlace::primaryEmail() const
この場所の主要なメールアドレスを返します。この便利な関数は、email type の最初の連絡先の詳細にアクセスします。 メールアドレスが存在しない場合は、空の文字列が返されます。
QString QPlace::primaryFax() const
この場所の主要なファックス番号を返す。この便宜関数は、fax type の最初の連絡先詳細にアクセスします。 ファックス詳細が存在しない場合は、空の文字列が返されます。
QString QPlace::primaryPhone() const
この場所の代表電話番号を返します。これはphone number type の最初の連絡先の詳細にアクセスします。 電話番号の詳細が存在しない場合は、空の文字列が返されます。
QUrl QPlace::primaryWebsite() const
その場所の主要なウェブサイトを返す。この便利な関数は、website type の最初の連絡先の詳細にアクセスします。 ウェブサイトが存在しない場合は、空の文字列が返されます。
QPlaceRatings QPlace::ratings() const
その場所の評価を集計して返します。
setRatings()も参照ください 。
void QPlace::removeContactDetails(const QString &contactType)
与えられたcontactType のすべての連絡先情報を削除する。
QPlace::contactTypes() が呼び出されたとき、contactType は返されなくなった。
void QPlace::removeExtendedAttribute(const QString &attributeType)
その場所からattributeType の属性を削除する。
この属性はQPlace::extendedAttributeTypes()によってリストされなくなる。
void QPlace::setAttribution(const QString &attribution)
その場所のattribution 文字列を設定する。
attribution()も参照 。
void QPlace::setCategories(const QList<QPlaceCategory> &categories)
この場所が属するcategories を設定する。
categories()も参照してください 。
void QPlace::setCategory(const QPlaceCategory &category)
この場所が属するcategory をひとつ設定する。
void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)
指定されたcontactType のコンタクトdetails を設定する。
details が空の場合、contactType は、QPlace::contactTypes() によって返されなくなるように、その場所から削除される。
一般的なcontact types のリストはQPlaceContactDetail を参照。
contactDetails()も参照 。
void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
与えられたtype に対してcontent のコレクションを設定する。
content()も参照のこと 。
void QPlace::setDetailsFetched(bool fetched)
この場所の詳細がfetched になっているかどうかを設定する。
detailsFetched()も参照 。
void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)
与えられたattributeType のattribute を場所に割り当てる。与えられたattributeType がすでにその場所に存在する場合、それは上書きされます。
attribute がデフォルトで構築されたQPlaceAttribute である場合、attributeType は場所から削除され、QPlace::extendedAttributeTypes() ではリストされない。
extendedAttribute()も参照 。
void QPlace::setIcon(const QPlaceIcon &icon)
その場所のicon を設定する。
icon()も参照 。
void QPlace::setLocation(const QGeoLocation &location)
その場所のlocation を設定する。
location()も参照 。
void QPlace::setName(const QString &name)
その場所のname を設定する。
name()も参照 。
void QPlace::setPlaceId(const QString &identifier)
その場所のidentifier を設定する。
placeId()も参照 。
void QPlace::setRatings(const QPlaceRatings &rating)
その場所のrating を設定する。
ratings()も参照 。
void QPlace::setSupplier(const QPlaceSupplier &supplier)
この場所の供給者をsupplier に設定する。
supplier()も参照 。
void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)
与えられたtype のコンテンツオブジェクトのtotalCount を設定する。
totalContentCount()も参照のこと 。
void QPlace::setVisibility(QLocation::Visibility visibility)
その場所の可視性をvisibility に設定する。
visibility()も参照 。
QPlaceSupplier QPlace::supplier() const
この場所の供給者を返します。
setSupplier()も参照してください 。
int QPlace::totalContentCount(QPlaceContent::Type type) const
与えられたtype のコンテンツオブジェクトの総カウントを返します。この総カウントは、マネージャ/プロバイダが利用可能なオブジェクトの数を示します。(このプレース・インスタンスが現在割り当てられているオブジェクトの数とは異なります)。
負のカウントは、アイテムの総数が不明であることを示す。デフォルトでは、コンテンツの総カウントは0に設定されています。
setTotalContentCount()も参照してください 。
QLocation::Visibility QPlace::visibility() const
場所の可視性を返します。
新しい場所のデフォルトの可視性は QtLocatin::Unspecified visibility に設定されます。場所が未指定の可視性で保存された場合、バックエンドは保存時に使用する適切なデフォルトの可視性を選択します。
setVisibility()も参照してください 。
[noexcept]
QPlace &QPlace::operator=(const QPlace &other)
この場所にother を割り当て、この場所への参照を返す。
© 2025 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.