En esta página

Posicionamiento (C++)

Posicionamiento

El componente «Posicionamiento» de la API de Qt Location se refiere a la posición geográfica, el tamaño y la dirección de un lugar. El componente «Posicionamiento» incluye una clase « QGeoCoordinate », que contiene la latitud, la longitud y la altitud en metros. « QGeoLocation » contiene una clase « QGeoCoordinate », además de información sobre la dirección y el tamaño (un rectángulo delimitador), de modo que las posiciones pueden ser algo más que puntos matemáticos. Se puede supervisar el movimiento de entrada o salida de las áreas delimitadas por el rectángulo de delimitación. La API también permite al desarrollador controlar la fuente de la información de posición.

Los datos de ubicación incluyen una posición especificada con precisión en la superficie terrestre —tal y como la proporcionan las coordenadas de latitud y longitud— junto con datos asociados, tales como:

  • La fecha y la hora en las que se comunicó la posición
  • La velocidad del dispositivo que comunicó la posición
  • La altitud de la posición comunicada (altura sobre el nivel del mar)
  • El rumbo del dispositivo en grados, respecto al norte verdadero

Estos datos pueden obtenerse mediante diversos métodos. Uno de los métodos de localización más conocidos es el GPS (Sistema de Posicionamiento Global), un sistema de acceso público que utiliza señales de ondas de radio recibidas de satélites en órbita terrestre para calcular la posición y la hora exactas del receptor. Otro método popular es el «posicionamiento por identificador de célula», que utiliza el identificador de la estación base que está prestando servicio al dispositivo receptor en ese momento para calcular su ubicación aproximada. Estos y otros métodos de localización pueden utilizarse con la API de localización; el único requisito para una fuente de datos de localización dentro de la API es que proporcione unas coordenadas de latitud y longitud junto con un valor de fecha y hora, con la opción de proporcionar los demás atributos mencionados anteriormente.

Las fuentes de datos de localización se crean creando una subclase de ` QGeoPositionInfoSource ` y proporcionando objetos ` QGeoPositionInfo ` a través de la señal ` QGeoPositionInfoSource::positionUpdated()`. Los clientes que necesiten datos de localización pueden conectarse a la señal ` positionUpdated()` y llamar a ` startUpdates()` o ` requestUpdate()` para activar la distribución de los datos de localización. La distribución de los datos de localización se puede detener llamando a la función ` stopUpdates()`.

En algunas plataformas puede estar disponible una fuente de posición predeterminada. Llama a QGeoPositionInfoSource::createDefaultSource() para crear una instancia de la fuente de posición predeterminada. El método devuelve nullptr si no hay ninguna fuente predeterminada disponible para la plataforma.

Si se produce un problema al acceder a la fuente de información, se emite una señal « errorOccurred()».

La clase ` QGeoAreaMonitorSource ` permite que se notifique a las aplicaciones cliente cuando el dispositivo receptor haya entrado o salido de una zona concreta, tal y como se especifica mediante unas coordenadas y un radio. Si la plataforma ofrece soporte integrado para la supervisión de zonas, el método ` QGeoAreaMonitorSource::createDefaultSource()` devuelve una instancia del monitor de zona predeterminado.

La información sobre satélites también se puede distribuir a través de la clase ` QGeoSatelliteInfoSource `. Llama a ` QGeoSatelliteInfoSource::createDefaultSource()` para crear una instancia de la fuente de datos de satélites predeterminada para la plataforma, si hay alguna disponible. Como alternativa, los clientes pueden crear una subclase de esta para proporcionar una fuente de datos de satélites personalizada.

Solicitar datos de ubicación a las fuentes de datos

Para recibir datos de una fuente, conéctate a su señal ` positionUpdated()` y, a continuación, llama a ` startUpdates()` o a ` requestUpdate()` para comenzar.

A continuación se muestra un ejemplo de un cliente que recibe datos de la fuente de datos de ubicación predeterminada, tal y como los devuelve QGeoPositionInfoSource::createDefaultSource():

class MyClass : public QObject
{
    Q_OBJECT
public:
    MyClass(QObject*parent = 0)
        : QObject(parent)
    {
        QGeoPositionInfoSource*source = QGeoPositionInfoSource::createDefaultSource(this);
        if (source) {
            connect(source, SIGNAL(positionUpdated(QGeoPositionInfo)),
                    this, SLOT(positionUpdated(QGeoPositionInfo)));
            source->startUpdates();
        }
    }

private slots:
    void positionUpdated(const QGeoPositionInfo&info)
    {
        qDebug() << "Position updated:" << info;
    }
};

Aspectos relacionados con el control de las fuentes de datos

El método QGeoPositionInfoSource::setUpdateInterval() se puede utilizar para controlar la frecuencia con la que se reciben las actualizaciones de posición. Por ejemplo, si la aplicación cliente solo necesita actualizaciones cada 30 segundos, puede llamar a ` setUpdateInterval(30000)`. Si no se establece ningún intervalo de actualización, o si se llama a ` setUpdateInterval()` con un valor de 0, la fuente utiliza un intervalo predeterminado o alguna otra lógica interna para determinar cuándo deben proporcionarse las actualizaciones.

QGeoPositionInfoSource::setPreferredPositioningMethods() permite a las aplicaciones cliente solicitar que se utilice un determinado tipo de método de posicionamiento. Por ejemplo, si la aplicación prefiere utilizar únicamente el posicionamiento por satélite —que ofrece un posicionamiento en exteriores bastante preciso, pero que puede consumir muchos recursos de energía—, puede llamar a este método con el valor « QGeoPositionInfoSource::SatellitePositioningMethods ». Sin embargo, este método solo debe utilizarse en aplicaciones cliente especializadas; en la mayoría de los casos, no deben modificarse los métodos de posicionamiento predeterminados, ya que una fuente puede utilizar internamente diversos métodos de posicionamiento que pueden resultar útiles para la aplicación.

Datos NMEA

NMEA es un protocolo común basado en texto para especificar datos de navegación. Por comodidad, se proporciona el valor « QNmeaPositionInfoSource » para permitir que las aplicaciones cliente lean y distribuyan datos NMEA tanto en modo en tiempo real (por ejemplo, al transmitir desde un dispositivo GPS) como en modo de simulación (por ejemplo, al leer desde un archivo de registro NMEA). En el modo de simulación, la fuente emitirá actualizaciones según la marca de tiempo de cada frase NMEA para producir una «reproducción» de los datos registrados.

Por lo general, las capacidades que ofrece la fuente de posición predeterminada, tal y como la devuelve QGeoPositionInfoSource::createDefaultSource(), junto con la clase QNmeaPositionInfoSource, son suficientes para recuperar datos de ubicación. Sin embargo, en algunos casos, es posible que los desarrolladores deseen crear su propia fuente de datos de ubicación personalizada.

El ejemplo «Fuente de posición de archivo de registro (C++) » muestra cómo crear una subclase de ` QGeoPositionInfoSource ` para crear una fuente de posicionamiento personalizada.

Ejemplos

Ejemplo de fuente de posición de archivo de registro

El ejemplo de fuente de posición de archivo de registro muestra cómo crear una subclase de ` QGeoPositionInfoSource ` para crear una fuente de posicionamiento personalizada.

Ejemplo de información meteorológica

El ejemplo de información meteorológica muestra cómo utilizar la posición actual del usuario para recuperar contenido local de un servicio web en un complemento de C++ para QML.

Clases de posicionamiento

QGeoAddress

Representa la dirección de un QGeoLocation

QGeoAreaMonitorInfo

Describe los parámetros de un área o región que se va a supervisar en busca de proximidad

QGeoAreaMonitorSource

Permite detectar cambios de proximidad para un conjunto específico de coordenadas

QGeoCircle

Define un área geográfica circular

QGeoCoordinate

Define una posición geográfica en la superficie de la Tierra

QGeoLocation

Representa información básica sobre una ubicación

QGeoPath

Define una ruta geográfica

QGeoPolygon

Define un polígono geográfico

QGeoPositionInfo

Contiene información recopilada sobre una posición global, una dirección y una velocidad en un momento determinado

QGeoPositionInfoSource

Clase base abstracta para la distribución de actualizaciones de posición

QGeoRectangle

Define un área geográfica rectangular

QGeoSatelliteInfo

Contiene información básica sobre un satélite

QGeoSatelliteInfoSource

Clase base abstracta para la distribución de actualizaciones de información sobre satélites

QGeoShape

Define un área geográfica

QNmeaPositionInfoSource

Información de posición utilizando una fuente de datos NMEA

QNmeaSatelliteInfoSource

Información sobre satélites a partir de una fuente de datos NMEA

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