Sur cette page

QPlace Class

La classe QPlace représente un ensemble de données sur un lieu. Plus d'informations...

Header: #include <QPlace>
qmake: QT += location

Fonctions publiques

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)

Fonctions protégées

QPlace(const QSharedDataPointer<QPlacePrivate> &dd)
bool operator!=(const QPlace &lhs, const QPlace &rhs)
bool operator==(const QPlace &lhs, const QPlace &rhs)

Description détaillée

Un lieu est un point d'intérêt, qu'il s'agisse d'un restaurant préféré, d'un parc ou de la maison de quelqu'un. Un objet QPlace représente un lieu en agissant comme un conteneur pour diverses informations sur ce lieu.

Ces informations peuvent être divisées en deux grandes catégories

  • Détails
  • Contenu riche

Les détails d'un lieu se composent des propriétés du lieu, telles que le nom, la localisation, les informations de contact, etc. Lorsqu'un lieu est renvoyé lors d'une recherche, ces détails sont renseignés. Parfois, afin d'économiser de la bande passante, il existe d'autres détails sur le lieu qui peuvent être récupérés individuellement, lieu par lieu, si l'utilisateur est intéressé. La fonction QPlace::detailsFetched() peut être interrogée pour savoir si tous les détails disponibles ont été récupérés, et si ce n'est pas le cas, QPlaceManager::getPlaceDetails() peut être utilisé pour les récupérer. Les détails qui sont renseignés lors d'une recherche et ceux qui doivent être récupérés individuellement peuvent varier d'un fournisseur à l'autre. Voir la documentation du plugin pour plus de détails.

Le contenu riche d'un lieu se compose d'éléments tels que des images, des critiques et des éditoriaux. Il est possible qu'il y ait de nombreux éléments de contenu riche, c'est pourquoi ils sont traités séparément des détails du lieu. Ils peuvent être récupérés de manière paginée via QPlaceManager::getPlaceContent(). Si nécessaire, le contenu peut être assigné à un lieu afin qu'il puisse servir de conteneur pratique.

Informations sur les contacts

Les informations de contact d'un lieu sont basées sur un ensemble commun de contact types. Pour récupérer tous les numéros de téléphone d'un lieu, il faut faire :

if (place.contactTypes().contains(QPlaceContactDetail::Phone)) { for(const QPlaceContactDetail &number: place.contactDetails(QPlaceContactDetail::Phone))        qDebug() << number.label() << ":" << number.value();
}

Les types de contact sont des valeurs de chaîne, afin de permettre aux fournisseurs d'introduire de nouveaux types de contact.

Pour des raisons pratiques, il existe une série de fonctions qui renvoient la valeur du premier contact de chaque type.

Attributs étendus

Les lieux peuvent avoir des attributs supplémentaires qui ne sont pas couverts par l'API officielle. Comme pour les contacts, les attributs sont basés sur un ensemble commun de attribute types. Pour récupérer un attribut étendu, il faut faire :

if (place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours))    qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();

Les types d'attributs sont des valeurs de chaîne, afin de permettre aux fournisseurs d'introduire de nouveaux types d'attributs.

Contenu

L'objet QPlace n'est qu'un conteneur pratique pour contenir un contenu riche tel que des images, des commentaires, etc. La récupération du contenu doit se faire via QPlaceManager::getPlaceContent().

Le contenu est stocké sous forme de QPlaceContent::Collection qui contient à la fois l'index du contenu et le contenu lui-même. Cela permet aux développeurs de vérifier si un élément particulier a déjà été récupéré et, si ce n'est pas le cas, de demander ce contenu.

Attribution

Les lieux disposent d'un champ pour une chaîne d'attribution en texte enrichi. Certains fournisseurs peuvent exiger que l'attribution soit affichée lorsqu'un lieu est présenté à un utilisateur.

Catégories

Différentes catégories peuvent être attribuées à un lieu pour indiquer que le lieu est associé à ces catégories. Lors de l'enregistrement d'un lieu, la seule donnée significative est l'identifiant de la catégorie, le reste des données de la catégorie est en fait ignoré. La catégorie doit déjà exister avant de sauvegarder le lieu (il n'est pas possible de créer une nouvelle catégorie, de l'attribuer au lieu, de sauvegarder le lieu et de s'attendre à ce que la catégorie soit créée).

Avertissements concernant l'enregistrement

L'API Lieux est actuellement conçue pour enregistrer uniquement les détails de core. L'enregistrement d'un contenu riche comme des images et des commentaires ou de détails comme le fournisseur et l'évaluation n'est pas un cas d'utilisation pris en charge. En règle générale, un gestionnaire ignore ces champs lors de l'enregistrement et peut produire un message d'avertissement s'ils sont renseignés.

L'API Lieux ne prend en charge que l'enregistrement des informations de base suivantes :

  • nom
  • identifiant du lieu
  • lieu
  • coordonnées du contact
  • icône
  • catégories (noms semblables à des tags pour décrire un lieu)
  • champ de visibilité

Il est possible que les fournisseurs ne prennent en charge qu'un sous-ensemble de ces éléments. Voir la documentation du plugin pour plus de détails.

L'enregistrement de propriétés telles que l'évaluation, les attributs étendus, les images, les critiques, les éditoriaux et les fournisseurs n'est explicitement pas pris en charge par l'API Lieux.

Documentation sur les fonctions membres

QPlace::QPlace()

Construit un objet de lieu vide.

[protected] QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)

Construit un objet lieu en utilisant dd comme implémentation privée.

[noexcept] QPlace::QPlace(const QPlace &other)

Construit une copie de other.

[noexcept] QPlace::~QPlace()

Détruit cet endroit.

void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)

Ajoute un contact detail d'un contactType spécifié.

Voir QPlaceContactDetail pour une liste de contact types.

QString QPlace::attribution() const

Renvoie une chaîne d'attribution en texte enrichi du lieu. Remarque : certains fournisseurs peuvent exiger que l'attribution soit affichée chaque fois qu'un lieu est présenté à un utilisateur final.

Voir aussi setAttribution().

QList<QPlaceCategory> QPlace::categories() const

Retourne les catégories auxquelles ce lieu appartient.

Voir aussi setCategories().

QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const

Renvoie une liste des coordonnées de la personne spécifiée contactType.

Voir QPlaceContactDetail pour une liste de contact types.

Voir aussi setContactDetails().

QStringList QPlace::contactTypes() const

Renvoie le type de coordonnées de ce lieu.

Voir QPlaceContactDetail pour une liste de contact types courants.

QPlaceContent::Collection QPlace::content(QPlaceContent::Type type) const

Renvoie une collection de contenus associés à un lieu. Cette collection est une carte dont la clé est l'index de l'objet de contenu et la valeur l'objet de contenu lui-même.

L'adresse type précise le type de contenu à récupérer.

Voir aussi setContent().

bool QPlace::detailsFetched() const

Retourne true si les détails de ce lieu ont été récupérés, sinon retourne false.

Voir aussi setDetailsFetched().

QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const

Renvoie l'attribut étendu correspondant à l'adresse attributeType spécifiée. Si le lieu ne possède pas ce type d'attribut particulier, un QPlaceExtendedAttribute construit par défaut est renvoyé.

Voir également setExtendedAttribute().

QStringList QPlace::extendedAttributeTypes() const

Renvoie les types d'attributs étendus dont dispose ce lieu.

QPlaceIcon QPlace::icon() const

Renvoie l'icône du lieu.

Voir aussi setIcon().

void QPlace::insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

Ajoute une collection de content de l'adresse type donnée au lieu. Tout index existant dans content est écrasé.

bool QPlace::isEmpty() const

Renvoie un booléen indiquant si tous les champs du lieu sont vides ou non.

QGeoLocation QPlace::location() const

Renvoie l'emplacement du lieu.

Voir aussi setLocation().

QString QPlace::name() const

Renvoie le nom du lieu.

Voir aussi setName().

QString QPlace::placeId() const

Renvoie l'identifiant du lieu. L'identifiant du lieu n'a de sens que pour le site QPlaceManager qui l'a généré et n'est pas transférable d'un gestionnaire à l'autre. L'identifiant du lieu n'est pas garanti comme étant universellement unique, mais il est unique pour le gestionnaire qui l'a généré.

Voir aussi setPlaceId().

QString QPlace::primaryEmail() const

Renvoie l'adresse électronique principale de ce lieu. Cette fonction de commodité permet d'accéder au premier contact de l'adresse email type. Si aucune adresse électronique n'existe, une chaîne vide est renvoyée.

QString QPlace::primaryFax() const

Renvoie le numéro de télécopie principal pour ce lieu. Cette fonction de commodité permet d'accéder à la première coordonnée de fax type. Si aucune coordonnée de télécopie n'existe, une chaîne vide est renvoyée.

QString QPlace::primaryPhone() const

Renvoie le numéro de téléphone principal de ce lieu. Cela permet d'accéder au premier contact de l'adresse phone number type. S'il n'y a pas de coordonnées téléphoniques, une chaîne vide est renvoyée.

QUrl QPlace::primaryWebsite() const

Renvoie le site web principal du lieu. Cette fonction de commodité permet d'accéder aux premières coordonnées du site website type. S'il n'existe pas de site web, une chaîne vide est renvoyée.

QPlaceRatings QPlace::ratings() const

Renvoie une évaluation agrégée du lieu.

Voir aussi setRatings().

void QPlace::removeContactDetails(const QString &contactType)

Supprime toutes les coordonnées d'un contactType donné.

L'adresse contactType n'est plus renvoyée lorsque QPlace::contactTypes() est appelé.

void QPlace::removeExtendedAttribute(const QString &attributeType)

Supprimer l'attribut attributeType du lieu.

L'attribut ne sera plus listé par QPlace::extendedAttributeTypes()

void QPlace::setAttribution(const QString &attribution)

Définit la chaîne attribution du lieu.

Voir aussi attribution().

void QPlace::setCategories(const QList<QPlaceCategory> &categories)

Définit le site categories auquel ce lieu appartient.

Voir aussi categories().

void QPlace::setCategory(const QPlaceCategory &category)

Définit une seule category à laquelle cet endroit appartient.

void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)

Définit le contact details d'un contactType spécifié.

Si details est vide, l'adresse contactType est supprimée de l'emplacement de sorte qu'elle ne soit plus renvoyée par QPlace::contactTypes().

Voir QPlaceContactDetail pour une liste des contact types courants.

Voir également contactDetails().

void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)

Définit une collection de content pour le type donné.

Voir aussi content().

void QPlace::setDetailsFetched(bool fetched)

Définit si les détails de ce lieu ont été fetched ou non.

Voir aussi detailsFetched().

void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)

Affecte un attribute du attributeType donné à un lieu. Si l'adresse attributeType existe déjà dans le lieu, elle est remplacée.

Si attribute est une construction par défaut de QPlaceAttribute, alors attributeType est supprimé du lieu, ce qui signifie qu'il ne sera pas listé par QPlace::extendedAttributeTypes().

Voir aussi extendedAttribute().

void QPlace::setIcon(const QPlaceIcon &icon)

Définit le site icon du lieu.

Voir aussi icon().

void QPlace::setLocation(const QGeoLocation &location)

Définit le site location du lieu.

Voir aussi location().

void QPlace::setName(const QString &name)

Définit le site name du lieu.

Voir aussi name().

void QPlace::setPlaceId(const QString &identifier)

Définit le site identifier du lieu.

Voir aussi placeId().

void QPlace::setRatings(const QPlaceRatings &rating)

Définit l'agrégat rating du lieu.

Voir aussi ratings().

void QPlace::setSupplier(const QPlaceSupplier &supplier)

Fixe le fournisseur de ce lieu à supplier.

Voir aussi supplier().

void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)

Définit le totalCount des objets de contenu du type donné.

Voir aussi totalContentCount().

void QPlace::setVisibility(QLocation::Visibility visibility)

Fixe la visibilité du lieu à visibility.

Voir aussi visibility().

QPlaceSupplier QPlace::supplier() const

Renvoie le fournisseur de ce lieu.

Voir aussi setSupplier().

int QPlace::totalContentCount(QPlaceContent::Type type) const

Renvoie le nombre total d'objets de contenu de l'adresse type. Ce nombre total indique le nombre d'objets que le gestionnaire/fournisseur devrait avoir à sa disposition. (Par opposition au nombre d'objets actuellement attribués à cette instance de lieu).

Un nombre négatif indique que le nombre total d'objets est inconnu. Par défaut, le nombre total de contenus est fixé à 0.

Voir également setTotalContentCount().

QLocation::Visibility QPlace::visibility() const

Renvoie la visibilité du lieu.

La visibilité par défaut d'un nouveau lieu est fixée à QtLocatin::Unspecified visibility. Si un lieu est sauvegardé avec une visibilité non spécifiée, le backend choisit une visibilité par défaut appropriée à utiliser lors de la sauvegarde.

Voir aussi setVisibility().

[noexcept] QPlace &QPlace::operator=(const QPlace &other)

Attribue other à ce lieu et renvoie une référence à ce lieu.

Non-membres apparentés

[noexcept] bool operator!=(const QPlace &lhs, const QPlace &rhs)

Retourne vrai si lhs n'est pas égal à rhs, sinon retourne faux.

[noexcept] bool operator==(const QPlace &lhs, const QPlace &rhs)

Retourne vrai si lhs est égal à rhs, sinon retourne faux.

© 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.