En esta página

QPlaceManagerEngine Class

La clase QPlaceManagerEngine proporciona una interfaz para los implementadores de plugins QGeoServiceProvider que quieren proporcionar acceso a la funcionalidad de lugar. Más...

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

Funciones públicas

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)

Señales

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)

Funciones protegidas

QPlaceManager *manager() const

Descripción detallada

Nota: No existen garantías de compatibilidad binaria o de código fuente para las clases del backend. Sólo se garantiza que la API funcione con la versión de Qt con la que se desarrolló. No obstante, sólo se realizarán cambios en la API en versiones menores. (6.6, 6.7, etc.).

Los desarrolladores de aplicaciones no necesitan preocuparse por el QPlaceManagerEngine. Sin embargo, los implementadores de backend necesitarán derivar de QPlaceManagerEngine y proporcionar implementaciones para las funciones virtuales abstractas.

Para más información sobre cómo escribir un backend consulta la documentación de Places Backend.

Ver también QPlaceManager.

Documentación de Funciones Miembro

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

Construye un nuevo motor con la dirección parent especificada, utilizando parameters para pasar cualquier dato específico de la implementación al motor.

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

Destruye este motor.

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

Devuelve la categoría correspondiente a la dirección categoryId.

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

Esta señal se emite si se ha añadido un category al almacén de datos del motor de gestión. El padre de category se especifica en parentId.

Esta señal sólo es emitida por los motores de gestión que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Esta señal se emite cuando la categoría correspondiente a categoryId ha sido eliminada del almacén de datos del motor de gestión. El padre de la categoría eliminada se especifica en parentId.

Esta señal sólo es emitida por los gestores que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Esta señal se emite si se ha modificado un category en el almacén de datos del motor de gestión. El padre de la categoría modificada se especifica en parentId.

Esta señal sólo es emitida por los motores de gestión que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Devuelve una lista de categorías que son hijas de la categoría correspondiente a parentId. Si parentId está vacía, se devuelven todas las categorías de nivel superior.

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

Devuelve los identificadores de categoría hija de la categoría correspondiente a categoryId. Si categoryId está vacío, se devuelven todos los identificadores de categoría de nivel superior.

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

Devuelve una versión podada o modificada del lugar original que es adecuada para ser guardada por el motor del gestor.

En la versión modificada sólo están presentes los detalles del lugar que admite este gestor. Los datos específicos del gestor, como el id del lugar, no se copian de original.

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

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

Construye una url de icono a partir de icon, size. Se devuelve la URL de la imagen del icono que más se aproxime a los parámetros dados.

[signal] void QPlaceManagerEngine::dataChanged()

*

Esta señal es emitida por el motor si se producen cambios a gran escala en su almacén de datos subyacente y el motor considera que estos cambios son lo suficientemente radicales como para requerir que los clientes vuelvan a cargar todos los datos.

Si se emite la señal, no se emitirán otras señales para los cambios asociados.

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

Esta señal se emite cuando se ha detectado un error en el procesamiento de reply. Probablemente le seguirá la señal QPlaceManager::finished() .

El error se describirá mediante el código de error error. Si errorString no está vacío, contendrá una descripción textual del error destinada a los desarrolladores y no a los usuarios finales.

Esta señal y QPlaceReply::errorOccurred() se emitirán al mismo tiempo.

Nota: No elimine el objeto reply de la ranura conectada a esta señal. Utilice deleteLater() en su lugar.

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

Esta señal se emite cuando reply ha terminado de procesar.

Si reply->error() es igual a QPlaceReply::NoError entonces el procesamiento ha finalizado con éxito.

Esta señal y QPlaceReply::finished() se emitirán al mismo tiempo.

Nota: No elimine el objeto reply en la ranura conectada a esta señal. Utilice deleteLater() en su lugar.

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

Recupera el contenido de un lugar según los parámetros especificados en request.

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

Recupera los detalles del lugar correspondiente a la dirección placeId.

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

Inicializa las categorías del motor de gestión.

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

Devuelve una lista de configuraciones regionales preferidas. Las configuraciones regionales se utilizan como una pista para el motor del gestor sobre el idioma en el que deben devolverse los detalles del lugar y la categoría.

Si no se puede utilizar la primera configuración regional especificada, el motor de gestión pasa a la siguiente y así sucesivamente.

La compatibilidad con las configuraciones regionales puede variar de un proveedor a otro. Para los que sí lo admiten, se utilizará por defecto global default locale. Si el motor del gestor no tiene ninguna configuración regional asignada, utilizará implícitamente la configuración regional global por defecto. Para los motores que no admiten configuraciones regionales, la lista de configuraciones regionales siempre está vacía.

Véase también setLocales().

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

Devuelve la instancia del gestor utilizada para crear este motor.

QString QPlaceManagerEngine::managerName() const

Devuelve el nombre que utiliza esta implementación de motor para distinguirse de las implementaciones proporcionadas por otros plugins.

El nombre del gestor se establece automáticamente para que sea el mismo que el de QGeoServiceProviderFactory::providerName().

int QPlaceManagerEngine::managerVersion() const

Devuelve la versión de la implementación de este motor.

La versión del gestor se establece automáticamente para que sea la misma que la de QGeoServiceProviderFactory::providerVersion().

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

Devuelve una respuesta que contiene una lista de lugares que corresponden/coinciden con los especificados en request.

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

Devuelve el identificador de categoría padre de la categoría correspondiente a categoryId.

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

Esta señal se emite si se ha añadido un lugar al almacén de datos del motor de gestión. El lugar concreto añadido se especifica en placeId.

Esta señal sólo es emitida por los motores gestores que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Esta señal se emite si se ha eliminado un lugar del almacén de datos del motor de gestión. El lugar concreto que se ha eliminado se especifica en placeId.

Esta señal sólo es emitida por los motores gestores que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Esta señal se emite si se ha modificado un lugar en el almacén de datos del motor de gestión. El lugar concreto modificado se especifica en placeId.

Esta señal sólo es emitida por los motores gestores que soportan QPlaceManager::NotificationsFeature.

Véase también dataChanged().

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

Elimina la categoría correspondiente a categoryId del almacén de datos del motor de gestión.

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

Elimina el lugar correspondiente a placeId del almacén de datos del motor de gestión.

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

Guarda un category que es hijo de la categoría especificada por parentId. Un parentId vacío significa que category se guarda como categoría de nivel superior.

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

Guarda un place especificado en el almacén de datos del motor de gestión.

Busca lugares según los parámetros especificados en request.

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

Solicita un conjunto de sugerencias de términos de búsqueda según los parámetros especificados en request.

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

Establece la lista de preferidos locales.

Véase también 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.