QPlace Class
La clase QPlace representa un conjunto de datos sobre un lugar. Más información...
| Header: | #include <QPlace> |
| qmake: | QT += location |
Funciones públicas
| 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) |
Funciones protegidas
| QPlace(const QSharedDataPointer<QPlacePrivate> &dd) |
Personas no afiliadas relacionadas
| bool | operator!=(const QPlace &lhs, const QPlace &rhs) |
| bool | operator==(const QPlace &lhs, const QPlace &rhs) |
Descripción detallada
Un lugar es un punto de interés; puede ser un restaurante favorito, un parque o la casa de alguien. Un objeto QPlace representa un lugar actuando como contenedor de diversa información sobre ese lugar.
Esta información se puede dividir en dos grandes categorías
- Detalles
- Contenido enriquecido
Los detalles del lugar consisten en las características del mismo, como el nombre, la ubicación, la información de contacto, etc. Cuando se muestra un lugar como resultado de una búsqueda, se rellenan estos detalles. A veces, para ahorrar ancho de banda, hay más detalles sobre el lugar que se pueden recuperar de forma individual para cada lugar, si el usuario está interesado. Se puede consultar la función ` QPlace::detailsFetched()` para comprobar si se han recuperado todos los detalles disponibles y, en caso contrario, se puede utilizar ` QPlaceManager::getPlaceDetails()` para recuperarlos. Los detalles concretos que se rellenan durante una búsqueda y los que deben recuperarse individualmente pueden variar de un proveedor a otro. Consulta la documentación del complemento para obtener más detalles.
El contenido enriquecido de un lugar está compuesto por elementos como imágenes, reseñas y artículos editoriales. Es posible que haya muchos elementos de contenido enriquecido, por lo que se tratan por separado de los detalles del lugar. Se pueden recuperar por páginas mediante QPlaceManager::getPlaceContent(). Si es necesario, el contenido se puede asignar a un lugar para que este actúe como un contenedor práctico.
Información de contacto
La información de contacto de un lugar se basa en un conjunto común de contact types. Para recuperar todos los números de teléfono de un lugar, se haría lo siguiente:
if (place.contactTypes().contains(QPlaceContactDetail::Phone)) {
for (const QPlaceContactDetail&number: place.contactDetails(QPlaceContactDetail::Phone))
qDebug() << number.label() << ":" << number.value();
}Los tipos de contacto son valores de cadena por diseño, para permitir que los proveedores introduzcan nuevos tipos de contacto.
Para mayor comodidad, hay un conjunto de funciones que devuelven el valor del primer dato de contacto de cada tipo.
Atributos ampliados
Las ubicaciones pueden tener atributos adicionales que no se incluyen en la API oficial. Al igual que en el caso de los contactos, los atributos se basan en un conjunto común de attribute types. Para recuperar un atributo ampliado, se haría lo siguiente:
if (place.extendedAttributeTypes().contains(QPlaceAttribute::OpeningHours))
qDebug() << place.extendedAttribute(QPlaceAttribute::OpeningHours).text();Los tipos de atributos son, por diseño, valores de cadena, para permitir que los proveedores introduzcan nuevos tipos de atributos.
Contenido
El objeto QPlace está pensado únicamente como un contenedor práctico para albergar contenido enriquecido, como imágenes, reseñas, etc. La recuperación del contenido debe realizarse mediante la función ` QPlaceManager::getPlaceContent()`.
El contenido se almacena como un ` QPlaceContent::Collection `, que contiene tanto el índice del contenido como el propio contenido. Esto permite a los desarrolladores comprobar si un elemento concreto ya se ha recuperado y, en caso contrario, solicitar dicho contenido.
Atribución
Los lugares cuentan con un campo para una cadena de atribución en formato de texto enriquecido. Algunos proveedores pueden exigir que se muestre la atribución cuando se muestra un lugar a un usuario.
Categorías
Se pueden asignar diferentes categorías a un lugar para indicar que este está asociado a dichas categorías. Al guardar un lugar, el único dato relevante es el identificador de la categoría; el resto de los datos de la categoría se ignoran de hecho. La categoría debe existir ya antes de guardar el lugar (no es posible crear una nueva categoría, asignársela al lugar, guardar el lugar y esperar que se cree la categoría).
Advertencias sobre el guardado
Actualmente, la API de Places está diseñada únicamente para guardar datos de « core ». No se admite el guardado de contenido enriquecido, como imágenes y reseñas, ni de datos como el proveedor y la valoración. Por lo general, el gestor ignorará estos campos al guardar y puede que aparezca un mensaje de advertencia si se rellenan.
La API de Places solo admite el guardado de los siguientes datos básicos:
- nombre
- ID del lugar
- ubicación
- datos de contacto
- icono
- categorías (nombres similares a etiquetas para describir un lugar)
- ámbito de visibilidad
Es posible que los proveedores solo admitan un subconjunto de estos. Consulta la documentación del complemento para obtener más detalles.
La API de Places no admite explícitamente el almacenamiento de propiedades como la valoración, los atributos ampliados, las imágenes, las reseñas, los artículos editoriales y el proveedor.
Documentación de las funciones de miembro
QPlace::QPlace()
Crea un objeto «place» vacío.
[protected] QPlace::QPlace(const QSharedDataPointer<QPlacePrivate> &dd)
Crea un objeto «place» utilizando « dd » como implementación privada.
[noexcept] QPlace::QPlace(const QPlace &other)
Crea una copia de other.
[constexpr noexcept default] QPlace::QPlace(QPlace &&other)
Crea una instancia de ` QPlace` mediante la construcción por asignación.
[noexcept] QPlace::~QPlace()
Arruina este sitio.
void QPlace::appendContactDetail(const QString &contactType, const QPlaceContactDetail &detail)
Añade un contacto detail de un contactType especificado.
Consulta QPlaceContactDetail para ver una lista de contact types más habituales.
QString QPlace::attribution() const
Devuelve una cadena de texto enriquecido con la atribución del lugar. Ten en cuenta que algunos proveedores pueden exigir que la atribución se muestre cada vez que se muestre un lugar a un usuario final.
Véase también setAttribution().
QList<QPlaceCategory> QPlace::categories() const
Devuelve las categorías a las que pertenece este lugar.
Véase también setCategories().
QList<QPlaceContactDetail> QPlace::contactDetails(const QString &contactType) const
Devuelve una lista con los datos de contacto de los contactType especificados.
Consulta QPlaceContactDetail para ver una lista de los contact types más comunes.
Véase también setContactDetails().
QStringList QPlace::contactTypes() const
Devuelve el tipo de datos de contacto que tiene este lugar.
Consulta QPlaceContactDetail para ver una lista de los « contact types » más habituales.
QPlaceContent::Collection QPlace::content(QPlaceContent::Type type) const
Devuelve una colección de contenidos asociados a un lugar. Esta colección es un mapa en el que la clave es el índice del objeto de contenido y el valor es el propio objeto de contenido.
El parámetro « type » especifica qué tipo de contenido se va a recuperar.
Véase también setContent().
bool QPlace::detailsFetched() const
Devuelve «true» si se han obtenido los datos de este lugar; en caso contrario, devuelve «false».
Véase también setDetailsFetched().
QPlaceAttribute QPlace::extendedAttribute(const QString &attributeType) const
Devuelve el atributo extendido correspondiente al attributeType especificado. Si el lugar no dispone de ese tipo de atributo concreto, se devuelve un objeto QPlaceExtendedAttribute creado por defecto.
Véase también setExtendedAttribute().
QStringList QPlace::extendedAttributeTypes() const
Devuelve los tipos de atributos extendidos que tiene este lugar.
QPlaceIcon QPlace::icon() const
Devuelve el icono del lugar.
Véase también setIcon().
void QPlace::insertContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
Añade al lugar una colección de content correspondiente a la dirección type indicada. Cualquier índice de content que ya exista se sobrescribe.
bool QPlace::isEmpty() const
Devuelve un valor booleano que indica si todos los campos del lugar están vacíos o no.
QGeoLocation QPlace::location() const
Devuelve la ubicación del lugar.
Véase también setLocation().
QString QPlace::name() const
Devuelve el nombre del lugar.
Véase también setName().
QString QPlace::placeId() const
Devuelve el identificador del lugar. El identificador del lugar solo tiene sentido para el « QPlaceManager » que lo generó y no es transferible entre gestores. No se garantiza que el identificador del lugar sea universalmente único, pero sí es único para el gestor que lo generó.
Véase también setPlaceId().
QString QPlace::primaryEmail() const
Devuelve la dirección de correo electrónico principal de este lugar. Esta función de conveniencia accede al primer dato de contacto de email type. Si no hay ninguna dirección de correo electrónico, se devuelve una cadena vacía.
QString QPlace::primaryFax() const
Devuelve el número de fax principal de este lugar. Esta función de conveniencia accede al primer dato de contacto de fax type. Si no hay datos de fax, se devuelve una cadena vacía.
QString QPlace::primaryPhone() const
Devuelve el número de teléfono principal de este lugar. Para ello, se accede al primer dato de contacto de phone number type. Si no hay ningún dato de teléfono, se devuelve una cadena vacía.
QUrl QPlace::primaryWebsite() const
Devuelve la página web principal del lugar. Esta función de conveniencia accede al primer dato de contacto de website type. Si no hay ninguna página web, se devuelve una cadena vacía.
QPlaceRatings QPlace::ratings() const
Devuelve una valoración global del lugar.
Véase también setRatings().
void QPlace::removeContactDetails(const QString &contactType)
Elimina todos los datos de contacto de un contactType determinado.
El objeto ` contactType ` ya no se devuelve al llamar a ` QPlace::contactTypes()`.
void QPlace::removeExtendedAttribute(const QString &attributeType)
Elimina el atributo « attributeType » de ese lugar.
El atributo ya no aparecerá en la lista de QPlace::extendedAttributeTypes()
void QPlace::setAttribution(const QString &attribution)
Establece la cadena « attribution » del lugar.
Véase también attribution().
void QPlace::setCategories(const QList<QPlaceCategory> &categories)
Establece el « categories » al que pertenece este lugar.
Véase también categories().
void QPlace::setCategory(const QPlaceCategory &category)
Establece un único « category » al que pertenece este lugar.
void QPlace::setContactDetails(const QString &contactType, QList<QPlaceContactDetail> details)
Establece el contacto « details » de un « contactType » especificado.
Si details está vacío, el contactType se elimina de la lista, de modo que ya no lo devuelve la función QPlace::contactTypes().
Consulta QPlaceContactDetail para obtener una lista de contact types habituales.
Véase también contactDetails().
void QPlace::setContent(QPlaceContent::Type type, const QPlaceContent::Collection &content)
Establece una colección de « content » para el « type » indicado.
Véase también content().
void QPlace::setDetailsFetched(bool fetched)
Indica si los datos de este lugar han sido fetched o no.
Véase también detailsFetched().
void QPlace::setExtendedAttribute(const QString &attributeType, const QPlaceAttribute &attribute)
Asigna un ` attribute ` del ` attributeType ` indicado a un lugar. Si el ` attributeType ` indicado ya existe en ese lugar, se sobrescribe.
Si attribute es un QPlaceAttribute construido por defecto, entonces el attributeType se elimina de ese lugar, lo que significa que no aparecerá en la lista de QPlace::extendedAttributeTypes().
Véase también extendedAttribute().
void QPlace::setIcon(const QPlaceIcon &icon)
Establece el « icon » del lugar.
Véase también icon().
void QPlace::setLocation(const QGeoLocation &location)
Establece el « location » del lugar.
Véase también location().
void QPlace::setName(const QString &name)
Establece el « name » del lugar.
Véase también name().
void QPlace::setPlaceId(const QString &identifier)
Establece el « identifier » del lugar.
Véase también placeId().
void QPlace::setRatings(const QPlaceRatings &rating)
Establece el valor agregado de « rating » del lugar.
Véase también ratings().
void QPlace::setSupplier(const QPlaceSupplier &supplier)
Establece el proveedor de este lugar como supplier.
Véase también supplier().
void QPlace::setTotalContentCount(QPlaceContent::Type type, int totalCount)
Establece el valor de « totalCount » de los objetos de contenido del type especificado.
Véase también totalContentCount().
void QPlace::setVisibility(QLocation::Visibility visibility)
Establece la visibilidad del lugar en « visibility ».
Véase también visibility().
QPlaceSupplier QPlace::supplier() const
Devuelve el proveedor de este lugar.
Véase también setSupplier().
int QPlace::totalContentCount(QPlaceContent::Type type) const
Devuelve el recuento total de objetos de contenido de la instancia de « type » especificada. Este recuento total indica cuántos objetos debería tener disponibles el gestor o proveedor (a diferencia del número de objetos que tiene asignados actualmente esta instancia de «place»).
Un recuento negativo indica que se desconoce el número total de elementos. Por defecto, el recuento total de contenido se establece en 0.
Véase también setTotalContentCount().
QLocation::Visibility QPlace::visibility() const
Devuelve la visibilidad del lugar.
La visibilidad predeterminada de un nuevo lugar se establece en QtLocatin::Unspecified. Si se guarda un lugar con visibilidad no especificada, el backend elige una visibilidad predeterminada adecuada para utilizarla al guardarlo.
Véase también setVisibility().
[noexcept] QPlace &QPlace::operator=(const QPlace &other)
Asigna ` other ` a este lugar y devuelve una referencia a este lugar.
Personas relacionadas que no son miembros
[noexcept] bool operator!=(const QPlace &lhs, const QPlace &rhs)
Devuelve «true» si lhs no es igual a rhs; en caso contrario, devuelve «false».
[noexcept] bool operator==(const QPlace &lhs, const QPlace &rhs)
Devuelve «true» si « lhs » es igual a « rhs »; en caso contrario, devuelve «false».
© 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.