Qt Positioning

La API Qt Positioning proporciona información de posicionamiento a través de interfaces QML y C++.

Actualmente, la API es compatible con Android, iOS, macOS, Linux y Windows (con receptores GPS expuestos como un puerto serie que proporciona sentencias NMEA o utilizando Windows.Devices.Geolocation).

Visión general

La API Qt Positioning permite determinar una posición utilizando diversas fuentes posibles, como satélite, wifi o archivos de texto. Esa información puede utilizarse, por ejemplo, para determinar una posición en un mapa. Además, puede utilizar la API para recuperar información de satélite y realizar un seguimiento por zonas.

Uso del módulo

API QML

Los tipos QML del módulo están disponibles a través de la importación QtPositioning. Para utilizar los tipos, añada la siguiente sentencia import a su archivo .qml:

import QtPositioning

API C

El uso de la API C++ de un módulo Qt requiere enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.

Compilación con CMake

Utilice el comando find_package() para localizar el componente del módulo necesario en el paquete Qt6:

find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)

Para obtener más información, consulta la descripción general de la compilación con CMake.

Compilación con qmake

Para configurar el módulo para su compilación con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += positioning

Permisos

A partir de Qt 6.6, el módulo Qt Positioning utiliza la nueva API QPermission para gestionar los permisos de location. Esto significa que Qt ya no consulta estos permisos, por lo que debe hacerse directamente desde la aplicación cliente.

Consulte la página Permisos de la aplicación para ver un ejemplo de cómo integrar la nueva API QPermission en la aplicación.

Artículos y guías

• Introducción al posicionamiento en C
• Introducción al posicionamiento en QML
• Qt Positioning Plugins
• Interfaces entre código C++ y QML en Qt Positioning
• Qt Positioning en Android
• Qt Positioning en iOS

Ejemplos

• Qt Positioning Ejemplos

Referencia

• Qt Positioning C++ Classes
• Qt Positioning QML Types

Evolución de los módulos

Cambios en Qt Positioning enumera los cambios importantes en la API del módulo y la funcionalidad que se hicieron para la serie Qt 6 de Qt.

Licencias

Qt Positioning está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Desde Qt 5.4, estas licencias de software libre son la GNU Lesser General Public License, versión 3, o la GNU General Public License, versión 2. Vea Licencias de Qt para más detalles.