Sur cette page

QPlaceManagerEngine Class

La classe QPlaceManagerEngine fournit une interface pour les implémenteurs de plugins QGeoServiceProvider qui souhaitent fournir un accès à la fonctionnalité des lieux. Plus d'informations...

Header: #include <QPlaceManagerEngine>
qmake: QT += location
Inherits: QObject

Fonctions publiques

QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)
virtual ~QPlaceManagerEngine()
virtual QPlaceCategory category(const QString &categoryId) const
virtual QList<QPlaceCategory> childCategories(const QString &parentId) const
virtual QStringList childCategoryIds(const QString &categoryId) const
virtual QPlace compatiblePlace(const QPlace &original) const
virtual QUrl constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
virtual QPlaceContentReply *getPlaceContent(const QPlaceContentRequest &request)
virtual QPlaceDetailsReply *getPlaceDetails(const QString &placeId)
virtual QPlaceReply *initializeCategories()
virtual QList<QLocale> locales() const
QString managerName() const
int managerVersion() const
virtual QPlaceMatchReply *matchingPlaces(const QPlaceMatchRequest &request)
virtual QString parentCategoryId(const QString &categoryId) const
virtual QPlaceIdReply *removeCategory(const QString &categoryId)
virtual QPlaceIdReply *removePlace(const QString &placeId)
virtual QPlaceIdReply *saveCategory(const QPlaceCategory &category, const QString &parentId)
virtual QPlaceIdReply *savePlace(const QPlace &place)
virtual QPlaceSearchReply *search(const QPlaceSearchRequest &request)
virtual QPlaceSearchSuggestionReply *searchSuggestions(const QPlaceSearchRequest &request)
virtual void setLocales(const QList<QLocale> &locales)

Signaux

void categoryAdded(const QPlaceCategory &category, const QString &parentId)
void categoryRemoved(const QString &categoryId, const QString &parentId)
void categoryUpdated(const QPlaceCategory &category, const QString &parentId)
void dataChanged()
void errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
void finished(QPlaceReply *reply)
void placeAdded(const QString &placeId)
void placeRemoved(const QString &placeId)
void placeUpdated(const QString &placeId)

Fonctions protégées

QPlaceManager *manager() const

Description détaillée

Note : Il n'y a aucune garantie de compatibilité source ou binaire pour les classes backend. L'API n'est garantie de fonctionner qu'avec la version de Qt pour laquelle elle a été développée. Les modifications de l'API ne seront toutefois apportées que dans les versions mineures. (6.6, 6.7, etc.).

Les développeurs d'applications n'ont pas à se préoccuper du QPlaceManagerEngine. Les implémenteurs de backend devront cependant dériver de QPlaceManagerEngine et fournir des implémentations pour les fonctions virtuelles abstraites.

Pour plus d'informations sur l'écriture d'un backend, voir la documentation Places Backend.

Voir également QPlaceManager.

Documentation des fonctions membres

[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

Construit un nouveau moteur avec l'adresse parent spécifiée, en utilisant parameters pour transmettre au moteur les données spécifiques à l'implémentation.

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

Détruit ce moteur.

[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const

Renvoie la catégorie correspondant à l'adresse categoryId.

[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)

Ce signal est émis si un category a été ajouté au magasin de données du moteur de gestion. Le parent de category est spécifié par parentId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)

Ce signal est émis lorsque la catégorie correspondant à categoryId a été supprimée du magasin de données du moteur de gestion. Le parent de la catégorie supprimée est spécifié par parentId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)

Ce signal est émis si une catégorie category a été modifiée dans le magasin de données du moteur de gestion. Le parent de la catégorie modifiée est spécifié par parentId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

Renvoie une liste de catégories qui sont des enfants de la catégorie correspondant à parentId. Si parentId est vide, toutes les catégories de niveau supérieur sont renvoyées.

[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

Renvoie les identifiants des catégories enfants de la catégorie correspondant à categoryId. Si categoryId est vide, tous les identifiants des catégories de premier niveau sont renvoyés.

[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

Renvoie une version élaguée ou modifiée du lieu original qui peut être sauvegardée par le moteur du gestionnaire.

Seuls les détails du lieu pris en charge par ce gestionnaire sont présents dans la version modifiée. Les données spécifiques au gestionnaire, telles que l'identifiant du lieu, ne sont pas copiées à partir de la version original.

[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

Construit un URL d'icône à partir de icon, size. L'URL de l'image de l'icône qui correspond le mieux aux paramètres donnés est renvoyée.

[signal] void QPlaceManagerEngine::dataChanged()

*

Ce signal est émis par le moteur s'il y a des changements à grande échelle dans son entrepôt de données sous-jacent et que le moteur considère que ces changements sont suffisamment radicaux pour exiger des clients qu'ils rechargent toutes les données.

Si ce signal est émis, aucun autre signal ne sera émis pour les changements associés.

[signal] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())

Ce signal est émis lorsqu'une erreur a été détectée dans le traitement de reply. Le signal QPlaceManager::finished() suivra probablement.

L'erreur sera décrite par le code d'erreur error. Si errorString n'est pas vide, il contiendra une description textuelle de l'erreur destinée aux développeurs et non aux utilisateurs finaux.

Ce signal et QPlaceReply::errorOccurred() seront émis en même temps.

Remarque : ne supprimez pas l'objet reply dans le slot connecté à ce signal. Utilisez plutôt deleteLater().

[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)

Ce signal est émis lorsque reply a terminé le traitement.

Si reply->error() est égal à QPlaceReply::NoError, le traitement s'est terminé avec succès.

Ce signal et QPlaceReply::finished() seront émis en même temps.

Note : Ne supprimez pas l'objet reply dans le slot connecté à ce signal. Utilisez plutôt deleteLater().

[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)

Récupère le contenu d'un lieu selon les paramètres spécifiés à l'adresse request.

[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)

Récupère les détails du lieu correspondant à l'adresse placeId.

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

Initialise les catégories du moteur de gestion.

[virtual] QList<QLocale> QPlaceManagerEngine::locales() const

Renvoie une liste des langues préférées. Les locales sont utilisées pour indiquer au moteur de gestion la langue dans laquelle les détails relatifs au lieu et à la catégorie doivent être renvoyés.

Si la première locale spécifiée ne peut être prise en compte, le moteur de gestion passe à la suivante, et ainsi de suite.

La prise en charge des langues peut varier d'un fournisseur à l'autre. Pour ceux qui le prennent en charge, c'est le site global default locale qui est utilisé par défaut. Si aucune locale n'est attribuée au moteur du gestionnaire, il utilise implicitement la locale globale par défaut. Pour les moteurs qui ne supportent pas les locales, la liste des locales est toujours vide.

Voir aussi setLocales().

[protected] QPlaceManager *QPlaceManagerEngine::manager() const

Renvoie l'instance de gestionnaire utilisée pour créer ce moteur.

QString QPlaceManagerEngine::managerName() const

Renvoie le nom que l'implémentation de ce moteur utilise pour se distinguer des implémentations fournies par d'autres plugins.

Le nom du gestionnaire est automatiquement défini pour être le même que celui de QGeoServiceProviderFactory::providerName().

int QPlaceManagerEngine::managerVersion() const

Retourne la version de l'implémentation de ce moteur.

La version du gestionnaire est automatiquement définie pour être la même que celle de QGeoServiceProviderFactory::providerVersion().

[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)

Renvoie une réponse contenant une liste de lieux qui correspondent à ceux spécifiés dans request.

[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

Renvoie l'identifiant de la catégorie parente de la catégorie correspondant à categoryId.

[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)

Ce signal est émis si un lieu a été ajouté au magasin de données du moteur de gestion. Le lieu particulier ajouté est spécifié par placeId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)

Ce signal est émis lorsqu'un lieu a été supprimé du magasin de données du moteur de gestion. Le lieu particulier qui a été supprimé est spécifié par placeId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)

Ce signal est émis si un lieu a été modifié dans le magasin de données du moteur de gestion. Le lieu modifié particulier est spécifié par placeId.

Ce signal n'est émis que par les moteurs de gestion qui prennent en charge la fonctionnalité QPlaceManager::NotificationsFeature.

Voir également dataChanged().

[virtual] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)

Supprime la catégorie correspondant à categoryId du magasin de données du moteur du gestionnaire.

[virtual] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)

Supprime le lieu correspondant à placeId du magasin de données du moteur du gestionnaire.

[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)

Enregistre un category qui est un enfant de la catégorie spécifiée par parentId. Un parentId vide signifie que category est sauvegardé en tant que catégorie de premier niveau.

[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)

Enregistre une adresse place spécifiée dans le magasin de données du moteur du gestionnaire.

Recherche de lieux en fonction des paramètres spécifiés dans request.

[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)

Demande un ensemble de suggestions de termes de recherche en fonction des paramètres spécifiés dans request.

[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)

Définir la liste des sites préférés locales.

Voir aussi locales().

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