QPlace Class
La classe QPlace représente un ensemble de données relatives à un lieu. En savoir plus...
| Header: | #include <QPlace> |
| qmake: | QT += location |
Fonctions publiques
| QPlace() | |
| QPlace(const QPlace &other) | |
| QPlace(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) |
Personnes concernées non membres
| 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 ; il peut s'agir d'un restaurant préféré, d'un parc ou du domicile de quelqu'un. Un objet QPlace représente un lieu en servant de conteneur à diverses informations le concernant.
Ces informations peuvent être classées en deux grandes catégories
- Détails
- Contenu enrichi
Les détails relatifs à un lieu comprennent ses caractéristiques, telles que son nom, son emplacement, ses coordonnées, etc. Lorsqu'un lieu est trouvé à la suite d'une recherche, ces détails sont renseignés. Parfois, afin d'économiser de la bande passante, des informations supplémentaires sur le lieu peuvent être récupérées au cas par cas, si l'utilisateur le souhaite. La fonction ` QPlace::detailsFetched()` permet de vérifier si toutes les informations disponibles ont été récupérées ; si ce n'est pas le cas, la fonction ` QPlaceManager::getPlaceDetails()` peut être utilisée pour les récupérer. Les informations qui sont renseignées automatiquement lors d'une recherche et celles qui doivent être récupérées individuellement peuvent varier d'un fournisseur à l'autre. Consultez la documentation du plugin pour plus de détails.
Le contenu enrichi d’un lieu se compose d’éléments tels que des images, des avis et des articles rédactionnels. Comme il peut y avoir un grand nombre d’éléments de contenu enrichi, ceux-ci sont traités séparément des détails du lieu. Ils peuvent être récupérés par pages via QPlaceManager::getPlaceContent(). Si nécessaire, le contenu peut être attribué à un lieu afin que celui-ci serve de conteneur pratique.
Coordonnées
Les coordonnées d’un lieu s’appuient sur un ensemble commun d’ contact types. Pour récupérer tous les numéros de téléphone d’un lieu, il suffit d’utiliser la commande suivante :
if (place.contactTypes().contains(QPlaceContactDetail::Phone)) {
for (const QPlaceContactDetail&number: place.contactDetails(QPlaceContactDetail::Phone))
qDebug() << number.label() << ":" << number.value();
}Les types de contact sont, par conception, des valeurs de type chaîne de caractères afin de permettre aux fournisseurs d'introduire de nouveaux types de contact.
Pour plus de commodité, il existe un ensemble de fonctions qui renvoient la valeur de la première coordonnée de chaque type.
Attributs étendus
Les lieux peuvent posséder des attributs supplémentaires qui ne sont pas pris en charge par l'API officielle. À l'instar des contacts, ces attributs s'appuient sur un ensemble commun d'attribute types. Pour récupérer un attribut étendu, il faut procéder comme suit :
if (place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours))
qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();Les types d'attributs sont, par conception, des valeurs de type chaîne de caractères afin de permettre aux fournisseurs d'introduire de nouveaux types d'attributs.
Contenu
L'objet QPlace est uniquement destiné à servir de conteneur pratique pour stocker du contenu riche, tel que des images, des avis, etc. La récupération du contenu doit s'effectuer via la méthode ` QPlaceManager::getPlaceContent()`.
Le contenu est stocké sous la forme d’un ` 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, dans le cas contraire, de demander ce contenu.
Attribution
Les lieux disposent d’un champ destiné à une chaîne d’attribution au format 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 celui-ci 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 relatives à la catégorie est en effet ignoré. La catégorie doit déjà exister avant l’enregistrement du lieu (il n’est pas possible de créer une nouvelle catégorie, de l’attribuer au lieu, d’enregistrer ce dernier et de s’attendre à ce que la catégorie soit créée).
Précisions concernant l’enregistrement
L’API Places est actuellement conçue pour enregistrer uniquement les détails de l’ core. L’enregistrement de contenu enrichi tel que des images et des avis, ou de détails tels que le fournisseur et la note, n’est pas pris en charge. En règle générale, un gestionnaire ignorera ces champs lors de l’enregistrement et un message d’avertissement pourra s’afficher s’ils sont renseignés.
L’API Places ne prend en charge l’enregistrement que des informations essentielles suivantes :
- nom
- identifiant du lieu
- emplacement
- coordonnées
- icône
- catégories (noms de type « balises » pour décrire un lieu)
- champ d'application de la visibilité
Il est possible que certains fournisseurs ne prennent en charge qu’une partie de ces éléments. Consultez la documentation du plugin pour plus de détails.
L'enregistrement de propriétés telles que la note, les attributs étendus, les images, les avis, les articles rédactionnels et le fournisseur n'est explicitement pas pris en charge par l'API Places.
Documentation des fonctions membres
QPlace::QPlace()
Crée un objet « place » vide.
[protected] QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)
Crée un objet « place » en utilisant « dd » comme implémentation privée.
[noexcept] QPlace::QPlace(const QPlace &other)
Crée une copie de other.
[constexpr noexcept default] QPlace::QPlace(QPlace &&other)
Crée par construction une instance de ` QPlace`.
[noexcept] QPlace::~QPlace()
Ça met cet endroit à sac.
void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)
Ajoute une detail de contact à une contactType spécifiée.
Voir QPlaceContactDetail pour obtenir la liste des contact types courantes.
QString QPlace::attribution() const
Renvoie une chaîne de texte enrichi contenant les informations de crédit relatives au lieu. Attention : certains fournisseurs peuvent exiger que ces informations de crédit apparaissent chaque fois qu'un lieu est affiché à un utilisateur final.
Voir également setAttribution().
QList<QPlaceCategory> QPlace::categories() const
Renvoie les catégories auxquelles appartient ce lieu.
Voir aussi setCategories().
QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const
Renvoie une liste des coordonnées de l'contactType spécifiée.
Voir QPlaceContactDetail pour une liste des contact types courantes.
Voir également setContactDetails().
QStringList QPlace::contactTypes() const
Renvoie le type de coordonnées associées à ce lieu.
Consultez QPlaceContactDetail pour obtenir la liste des « contact types » courantes.
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é correspond à l'index de l'objet de contenu et dont la valeur correspond à l'objet de contenu lui-même.
La fonction ` type ` spécifie le type de contenu à récupérer.
Voir également setContent().
bool QPlace::detailsFetched() const
Renvoie « true » si les informations relatives à ce lieu ont été récupérées ; sinon, renvoie « false ».
Voir aussi setDetailsFetched().
QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const
Renvoie l'attribut étendu correspondant à l'attributeType spécifié. Si l'objet `place` ne dispose pas de ce type d'attribut particulier, un objet `QPlaceExtendedAttribute` créé par défaut est renvoyé.
Voir également setExtendedAttribute().
QStringList QPlace::extendedAttributeTypes() const
Renvoie les types d'attributs étendus associés à 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 à l'emplacement une collection d'content s de l'type spécifié. Tout index de content qui existe déjà est écrasé.
bool QPlace::isEmpty() const
Renvoie une valeur booléenne indiquant si tous les champs de l'endroit 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 l'QPlaceManager qui l'a généré et n'est pas transférable d'un gestionnaire à un autre. L'unicité de l'identifiant du lieu n'est pas garantie à l'échelle universelle, mais il est unique pour le gestionnaire qui l'a généré.
Voir également setPlaceId().
QString QPlace::primaryEmail() const
Renvoie l'adresse e-mail principale associée à ce lieu. Cette fonction pratique accède à la première coordonnée de l'objet « email type ». S'il n'y a aucune adresse e-mail, une chaîne vide est renvoyée.
QString QPlace::primaryFax() const
Renvoie le numéro de fax principal associé à ce lieu. Cette fonction pratique accède à la première coordonnée de l'fax type. Si aucune coordonnée de fax n'est disponible, une chaîne vide est renvoyée.
QString QPlace::primaryPhone() const
Renvoie le numéro de téléphone principal associé à ce lieu. Cette fonction accède aux coordonnées du premier contact de l'phone number type. Si aucune coordonnée téléphonique n'est disponible, une chaîne vide est renvoyée.
QUrl QPlace::primaryWebsite() const
Renvoie le site web principal du lieu. Cette fonction pratique permet d'accéder aux premières coordonnées de l'website type. S'il n'existe aucun site web, une chaîne vide est renvoyée.
QPlaceRatings QPlace::ratings() const
Renvoie une note globale attribuée à ce lieu.
Voir aussi setRatings().
void QPlace::removeContactDetails(const QString &contactType)
Supprime toutes les coordonnées d'une « contactType » donnée.
L'contactType n'est plus renvoyée lorsque la fonction QPlace::contactTypes() est appelée.
void QPlace::removeExtendedAttribute(const QString &attributeType)
Supprimez l'attribut « attributeType » de cet emplacement.
Cet attribut n'apparaîtra plus dans la liste renvoyée par la fonction QPlace::extendedAttributeTypes()
void QPlace::setAttribution(const QString &attribution)
Définit la chaîne « attribution » de l'emplacement.
Voir aussi ` attribution()`.
void QPlace::setCategories(const QList<QPlaceCategory> &categories)
Définit l'categories e à laquelle appartient ce lieu.
Voir aussi categories().
void QPlace::setCategory(const QPlaceCategory &category)
Définit une seule entité « category » à laquelle cet endroit appartient.
void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)
Définit l'details de contact d'un contactType spécifié.
Si « details » est vide, l'contactType est supprimé de l'emplacement, de sorte qu'il ne soit plus renvoyé par la fonction « QPlace::contactTypes() ».
Voir QPlaceContactDetail pour une liste des contact types courantes.
Voir également contactDetails().
void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
Définit un ensemble d'content s pour l'type donné.
Voir aussi content().
void QPlace::setDetailsFetched(bool fetched)
Indique si les informations relatives à ce lieu ont été fetched ou non.
Voir aussi detailsFetched().
void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)
Attribue une instance d'attribute de l'attributeType spécifiée à un emplacement. Si l'attributeType spécifiée existe déjà à cet emplacement, elle est écrasée.
Si ` attribute ` est une ` QPlaceAttribute` construite par défaut, alors l'` attributeType ` est supprimée de l'emplacement, ce qui signifie qu'elle ne sera pas répertoriée par ` QPlace::extendedAttributeTypes()` ().
Voir également extendedAttribute().
void QPlace::setIcon(const QPlaceIcon &icon)
Définit l'icon e du lieu.
Voir aussi icon().
void QPlace::setLocation(const QGeoLocation &location)
Définit l'location e du lieu.
Voir aussi location().
void QPlace::setName(const QString &name)
Définit l'name e du lieu.
Voir aussi name().
void QPlace::setPlaceId(const QString &identifier)
Définit l'identifier s du lieu.
Voir aussi placeId().
void QPlace::setRatings(const QPlaceRatings &rating)
Définit l'rating agrégée du lieu.
Voir aussi ratings().
void QPlace::setSupplier(const QPlaceSupplier &supplier)
Définit le fournisseur de ce lieu sur supplier.
Voir également supplier().
void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)
Définit l'totalCount des objets de contenu de l'type spécifiée.
Voir aussi totalContentCount().
void QPlace::setVisibility(QLocation::Visibility visibility)
Définit la visibilité du lieu sur « visibility ».
Voir aussi visibility().
QPlaceSupplier QPlace::supplier() const
Renvoie le fournisseur associé à ce lieu.
Voir aussi setSupplier().
int QPlace::totalContentCount(QPlaceContent::Type type) const
Renvoie le nombre total d'objets de contenu de l'type e indiquée. Ce nombre total indique le nombre d'objets dont le gestionnaire/fournisseur devrait disposer (par opposition au nombre d'objets actuellement attribués à cette instance de lieu).
Un nombre négatif indique que le nombre total d'éléments est inconnu. Par défaut, le nombre total de contenus est défini sur 0.
Voir également setTotalContentCount().
QLocation::Visibility QPlace::visibility() const
Renvoie la visibilité du lieu.
La visibilité par défaut d'un nouveau lieu est définie sur QtLocatin::Unspecified. Si un lieu est enregistré avec une visibilité non spécifiée, le backend choisit une visibilité par défaut appropriée à utiliser lors de l'enregistrement.
Voir également la fonction ` setVisibility()`.
[noexcept] QPlace &QPlace::operator=(const QPlace &other)
Attribue la valeur « other » à cet emplacement et renvoie une référence à cet emplacement.
© 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.