En esta página

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 QtPositioning

API 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 += 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 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

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.