QPlaceManagerEngine Class
La clase `QPlaceManagerEngine` proporciona una interfaz para los desarrolladores de complementos de ` QGeoServiceProvider ` que deseen ofrecer acceso a la funcionalidad de «place». Más información...
| Header: | #include <QPlaceManagerEngine> |
| qmake: | QT += location |
| Inherits: | QObject |
Funciones públicas
| QPlaceManagerEngine(const QVariantMap ¶meters, 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: Nohay garantías de compatibilidad ni a nivel de código fuente ni a nivel binario para las clases del backend. Solo se garantiza que la API funcione con la versión de Qt para la que se desarrolló. No obstante, los cambios en la API solo se realizarán en versiones menores (6.6, 6.7, etc.).
Los desarrolladores de aplicaciones no tienen por qué preocuparse por QPlaceManagerEngine. Sin embargo, los implementadores de backends deberán derivar de QPlaceManagerEngine y proporcionar implementaciones para las funciones virtuales abstractas.
Para obtener más información sobre cómo escribir un backend, consulta la documentación de Places Backend.
Véase también QPlaceManager.
Documentación de las funciones de miembro
[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr)
Crea un nuevo motor con el parent especificado, utilizando parameters para pasar al motor cualquier dato específico de la implementación.
[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()
Destruye este motor.
[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const
Devuelve la categoría correspondiente al « categoryId » indicado.
[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)
Esta señal se emite si se ha añadido un objeto « category » al almacén de datos del motor de gestión. El elemento padre del « category » se especifica mediante « parentId ».
Esta señal solo la emiten los motores de gestión que admiten la característica 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 » se ha eliminado del almacén de datos del motor de gestión. La categoría principal de la categoría eliminada se especifica mediante « parentId ».
Esta señal solo la emiten los motores de gestión que admiten la función 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 una categoría ( category ) en el almacén de datos del motor de gestión. La categoría principal de la categoría modificada se especifica mediante ` parentId`.
Esta señal solo la emiten los motores de gestión que admiten la función QPlaceManager::NotificationsFeature.
Véase también dataChanged().
[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const
Devuelve una lista de las categorías que son subordinadas de la categoría correspondiente a parentId. Si parentId está vacío, se devuelven todas las categorías de primer nivel.
[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const
Devuelve los identificadores de las categorías secundarias de la categoría correspondiente a categoryId. Si categoryId está vacío, se devuelven todos los identificadores de las categorías de primer nivel.
[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const
Devuelve una versión recortada o modificada del lugar original, adecuada para ser guardada por el motor del gestor.
En la versión modificada solo figuran los datos del lugar compatibles con este gestor. Los datos específicos del gestor, como el identificador del lugar, no se copian desde original.
[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)
Crea una URL de icono a partir de un icon y un size dados. Se devuelve la URL de la imagen del icono que mejor se ajusta a los parámetros proporcionados.
[signal] void QPlaceManagerEngine::dataChanged()
*
El motor emite esta señal si se producen cambios a gran escala en su almacén de datos subyacente y el motor considera que dichos cambios son lo suficientemente radicales como para que los clientes tengan que volver a cargar todos los datos.
Si se emite esta 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 se emitirá a continuación 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 elimines el objeto ` reply ` en la ranura conectada a esta señal. Utiliza ` deleteLater()` en su lugar.
[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)
Esta señal se emite cuando « reply » ha finalizado el procesamiento.
Si reply->error() es igual a « QPlaceReply::NoError », el procesamiento ha finalizado correctamente.
Esta señal y QPlaceReply::finished() se emitirán al mismo tiempo.
Nota: No elimines el objeto ` reply ` en la ranura conectada a esta señal. Utiliza en su lugar ` deleteLater()`.
[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 datos 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. Estas configuraciones regionales sirven de indicación al motor de gestión sobre el idioma y la categoría en los que deben mostrarse los detalles.
Si no se puede aplicar la primera configuración regional especificada, el motor de gestión recurre a la siguiente y así sucesivamente.
La compatibilidad con las configuraciones regionales puede variar de un proveedor a otro. Para aquellos que sí la admiten, se utilizará por defecto la configuración regional global default locale. Si al motor de gestión no se le ha asignado ninguna configuración regional, utilizará implícitamente la configuración regional global por defecto. Para los motores que no admiten configuraciones regionales, la lista de configuraciones regionales siempre estará 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 del motor para distinguirse de las implementaciones proporcionadas por otros complementos.
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 esta implementación del motor.
La versión del gestor se establece automáticamente para que coincida con QGeoServiceProviderFactory::providerVersion().
[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)
Devuelve una respuesta que contiene una lista de lugares que se corresponden o coinciden con los especificados en request.
[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const
Devuelve el identificador de la categoría principal 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 que se ha añadido se especifica mediante ` placeId`.
Esta señal solo la emiten los motores de gestión que admiten la función 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 mediante ` placeId`.
Esta señal solo la emiten los motores de gestión que admiten la función 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 que se ha modificado se especifica mediante ` placeId`.
Esta señal solo la emiten los motores de gestión que admiten la función 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 elemento 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 una subcategoría de la categoría especificada en « parentId ». Si « parentId » está vacío, significa que « category » se guarda como categoría de primer nivel.
[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)
Guarda un « place » especificado en el almacén de datos del motor de gestión.
[virtual] QPlaceSearchReply *QPlaceManagerEngine::search(const QPlaceSearchRequest &request)
Busca lugares según los parámetros especificados en request.
[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)
Solicita una serie de sugerencias de términos de búsqueda según los parámetros especificados en request.
[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)
Configura la lista de sitios preferidos en 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.