En esta página

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