Qt Positioning
La API de 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 conectados como puerto serie que proporcionan mensajes NMEA o que utilizan Windows.Devices.Geolocation).
Descripción general
La API de Qt Positioning te permite determinar una posición utilizando diversas fuentes, como satélites, wifi o archivos de texto. Esa información se puede utilizar, por ejemplo, para determinar una posición en un mapa. Además, puedes utilizar la API para recuperar información de satélites y realizar un seguimiento basado en áreas.
Uso del módulo
API de QML
Los tipos QML del módulo están disponibles a través de la importación QtPositioning. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:
import QtPositioningAPI de C++
Para utilizar la API de C++ de un módulo Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación cuentan con soporte específico para ello, entre ellas CMake y qmake.
Compilación con CMake
Utiliza 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 detalles, consulta la descripción general de «Compilación con CMake ».
Compilación con qmake
Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:
QT += positioningPermisos
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 solicita estos permisos por sí mismo, por lo que esto debe hacerse directamente desde la aplicación cliente.
Consulta 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 Complementos
- Interfaces entre el código C++ y QML en Qt Positioning
- Qt Positioning en Android
- Qt Positioning en iOS
- Qt Positioning Consideraciones de seguridad
Ejemplos
Referencia
Evolución del módulo
La sección«Cambios en Qt Positioning » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado 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 Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulta Licencias de Qt para obtener más detalles.
© 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.