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 の共通のセットに基づいています。場所のすべての電話番号を取得するには、1つの方法で行います:
if (place.contactTypes().contains(QPlaceContactDetail::Phone)) { for (const QPlaceContactDetail &number : place.contactDetails(QPlaceContactDetail::Phone)) qDebug() << number.label() << ":" << number.value(); }
連絡先タイプは、プロバイダーが新しい連絡先タイプを導入できるように、文字列値で設計されています。
利便性のために、各タイプの最初の連絡先の詳細の値を返す一連の関数があります。
拡張属性
場所は、正式なAPIでカバーされていない追加属性を持つことができます。連絡先と同様に、属性は共通のattribute types 。 拡張属性を取得するには、次のようにします:
if (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 を private 実装としたプレイスオブジェクトを構築します。
[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 を 1 つ設定します。
void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)
指定されたcontactType の連絡先details を設定します。
details が空の場合、QPlace::contactTypes() によって返されなくなるように、contactType が場所から削除される。
一般的な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 を割り当て、この場所への参照を返します。
©2024TheQt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。