En esta página

Cambios en Qt Positioning

Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables para hacer de Qt un marco de trabajo mejor.

En este tema resumimos esos cambios en Qt Positioning y ofrecemos orientación para gestionarlos.

Cambios en las API públicas que rompen la compatibilidad

Esta sección contiene información sobre los cambios en las API que rompen la compatibilidad de código fuente.

Cambio de nombre de QGeoPolygon::path()

Los métodos QGeoPolygon::path() y QGeoPolygon::setPath() pasan a llamarse QGeoPolygon::perimeter() y QGeoPolygon::setPerimeter(), respectivamente. En QML, la propiedad QGeoPolygon::perimeter puede utilizarse sin ningún cambio.

Utiliza ` QGeoShape ` para el área de delimitación de ` QGeoLocation `

La clase QGeoLocation y su equivalente en QML, Location, se han actualizado para utilizar QGeoShape en lugar de QGeoRectangle como área delimitadora.

C++

QGeoLocation::boundingBox() y QGeoLocation::setBoundingBox() se sustituyen por QGeoLocation::boundingShape() y QGeoLocation::setBoundingShape() respectivamente. Ahora se utiliza un objeto QGeoShape como almacenamiento de datos subyacente.

QML

La propiedad ` QGeoLocation::boundingBox ` se sustituye por ` QGeoLocation::boundingShape`. Esta propiedad está disponible desde la versión QtPositioning 6.2, así que asegúrate de actualizar la versión de importación en los archivos QML.

import QtPositioning 6.2

Eliminar QGeoShape::extendShape()

El método QGeoShape::extendShape() quedó obsoleto en Qt 5.9 y finalmente se eliminó en Qt 6. Utiliza QGeoRectangle::extendRectangle() y QGeoCircle::extendCircle() si necesitas esta funcionalidad para estas clases.

Cambiar el nombre de la señal «error» por «errorOccurred»

En Qt 5, varias clases de « Qt Positioning » tenían la señal « error() », lo que provocaba un conflicto con el método « error() ». En Qt 6 hemos renombrado estas señales como « errorOccurred() ». Concretamente:

Eliminación de las señales de tiempo de espera de actualización

En Qt 5, se utilizaban las señales « QGeoPositionInfoSource::updateTimeout() » y « QGeoSatelliteInfoSource::requestTimeout() » para notificar los casos en los que no se podía recuperar la posición actual o la información del satélite dentro del tiempo de espera especificado. Estas señales se han eliminado en Qt 6. En su lugar, se utilizan las señales « errorOccurred() » con los nuevos tipos de error. En concreto:

Los mismos cambios se aplican al objeto QML ` PositionSource `. Se ha eliminado la señal ` PositionSource::updateTimeout() `. En su lugar, se utiliza la propiedad ` PositionSource::sourceError ` con un ` PositionSource.UpdateTimeoutError `.

Rediseño de la compatibilidad con NMEA

En Qt 5 contábamos con un complemento de posicionamiento «serialnmea » y una propiedad « nmeaSource » en el objeto « PositionSource ».

El complemento proporcionaba acceso a flujos NMEA a través del puerto serie, mientras que el objeto QML se encargaba de leer el flujo NMEA desde un socket TCP o un archivo local.

En Qt 6 hemos unificado todas estas funciones en el complemento, que ahora se denomina «nmea». Ahora es capaz de funcionar con las tres fuentes de datos NMEA: puerto serie, socket TCP y archivo local. Consulta la descripción del complemento para obtener más detalles.

Se ha eliminado la propiedad « nmeaSource » del objeto « PositionSource ».

Otros cambios en la API

Esta sección contiene mejoras de la API que no rompen la compatibilidad del código fuente. Sin embargo, pueden tener un impacto en la lógica de la aplicación, por lo que sigue siendo útil conocerlas.

Restablecimiento correcto de los errores

En Qt 5, los errores de las clases ` QGeoAreaMonitorSource`, ` QGeoPositionInfoSource ` y ` QGeoSatelliteInfoSource ` nunca se restablecían. Este comportamiento no es lógico, ya que llamar a ` startUpdates()`, ` startMonitoring() ` o ` requestUpdates() ` en una de estas clases o sus subclases significa, en la práctica, iniciar una nueva sesión de trabajo, lo que implica que no deberíamos tener en cuenta los errores anteriores. A partir de Qt 6, restablecemos el error a ` NoError ` una vez que se llama a uno de los métodos mencionados.

Añadir QGeoAddress::streetNumber

La clase ` QGeoAddress ` se ha ampliado con la propiedad ` streetNumber `, que contiene la información sobre el número de la calle, el nombre del edificio o cualquier otro dato que pueda utilizarse para distinguir una dirección de otra. Utiliza ` streetNumber()` y ` setStreetNumber()` para acceder a esta propiedad desde código C++.

La propiedad ` QGeoAddress::street ` ahora solo contiene el nombre de la calle.

Lo mismo se aplica a su equivalente en QML, ` Address `. La propiedad ` Address::street ` ahora se utiliza únicamente para el nombre de la calle, mientras que la propiedad ` Address::streetNumber ` se utiliza para otros detalles importantes de la dirección.

Añade el argumento de tiempo de espera a PositionSource::update()

El timeout se especifica en milisegundos. Si el timeout es cero (el valor por defecto), se establece por defecto un tiempo de espera razonable según corresponda a la fuente.

Reestructuración de las clases ` QGeoSatelliteInfo`, ` QGeoPositionInfo ` y ` QGeoAreaMonitorInfo `

Estas clases utilizan ahora ` QExplicitlySharedDataPointer ` en su implementación. Esto significa que las clases implementan «copia al escribir» (copy-on-write). De este modo, su copia resulta más económica, por lo que pueden pasarse por valor.

Otra mejora es la incorporación de soporte para operaciones de desplazamiento eficientes.

Cambios en la implementación del complemento « Qt Positioning »

Esta sección ofrece información sobre los cambios en la interfaz del complemento.

En Qt 5 teníamos dos versiones de la interfaz del complemento:

  • QGeoPositionInfoSourceFactory que proporcionaba las funciones básicas.
  • QGeoPositionInfoSourceFactoryV2 que ampliaba la clase base con la posibilidad de proporcionar parámetros personalizados para los objetos creados.

En Qt 6 hemos fusionado estas dos implementaciones en una sola, dejando únicamente la clase ` QGeoPositionInfoSourceFactory `. Sus métodos permiten ahora pasar parámetros personalizados.

Nota: El identificador de la interfaz se ha actualizado para reflejar la actualización de la versión principal. Utiliza "org.qt-project.qt.position.sourcefactory/6.0" en tus complementos Qt Positioning.

A continuación se muestra un ejemplo de declaración de una clase de complemento:

class MyPlugin : public QObject, public QGeoPositionInfoSourceFactory
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.qt.position.sourcefactory/6.0"
                      FILE "plugin.json")
    Q_INTERFACES(QGeoPositionInfoSourceFactory)

public:
    QGeoPositionInfoSource *positionInfoSource(QObject *parent, const QVariantMap &parameters) override;
    QGeoSatelliteInfoSource *satelliteInfoSource(QObject *parent, const QVariantMap &parameters) override;
    QGeoAreaMonitorSource *areaMonitor(QObject *parent, const QVariantMap &parameters) override;
};

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