Qt Location
El módulo Qt Location le ayuda a crear soluciones cartográficas utilizando los datos disponibles de los proveedores de servicios de localización más conocidos, como Open Street Map.
La API Qt Location le permite:
- Acceder y presentar datos de mapas.
- Soportar gestos táctiles sobre un área específica del mapa.
- Consultar una ubicación geográfica y una ruta concretas.
- Añadir capas adicionales, como polilíneas y círculos.
- Buscar lugares e imágenes relacionadas.
Uso del módulo
API QML
Para utilizar los tipos, añada las siguientes sentencias import a su archivo .qml:
import QtPositioning import QtLocation
Nota: Muchas APIs del módulo Qt Location QML utilizan tipos del módulo Qt Positioning. Por ejemplo, definir una coordenada para que sea el centro del mapa requiere tipos del módulo Qt Positioning.
API DE C
Para proyectos C++, incluya la cabecera apropiada para el caso de uso actual; por ejemplo, las aplicaciones que utilizan rutas pueden utilizar:
#include <QGeoRoute>Utilizar 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 Location)
target_link_libraries(mytarget PRIVATE Qt6::Location)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 += location
Submódulos
La API está dividida en submódulos, que proporcionan interfaces QML y C++ para fines específicos. Se centran principalmente en la información de Mapas y Lugares. Los datos de posición necesarios pueden recuperarse utilizando el módulo QtPositioning.
Lugares
El submódulo Lugares es el complemento natural de Posicionamiento, ya que proporciona una fuente de datos geográficos sobre Lugares de Interés (POI). Además de la información de origen, la API proporciona información sobre la ubicación, el tamaño y otros datos relacionados con un PDI. La API de Lugares también puede recuperar imágenes, reseñas y otros contenidos relacionados con un lugar.
Mapas y navegación
El módulo proporciona las alternativas QML y C++ para mapas y navegación. La alternativa C++ proporciona clases de utilidad para obtener información de geocodificación (encontrar una coordenada geográfica a partir de la dirección de una calle) y navegación (incluyendo indicaciones para llegar en coche y a pie), mientras que su homólogo QML proporciona componentes de interfaz de usuario para representar la información.
Ejemplos
| Aplicaciones de ejemplo | Ejemplos de uso de las API de Qt Location |
| Tutorial de mapas y navegación | Tutorial de introducción a los tipos de mapas QML |
Referencia API
A continuación se enumeran las clases y los componentes de interfaz de usuario proporcionados por el módulo, con aplicaciones de ejemplo para demostrar su uso:
| QML API Reference | Lista completa de componentes QML en la API Qt Location |
| Referencia de la API de C++ por dominio | Lista completa de clases y métodos C++ de las API Qt Location ordenados por dominio |
| C++ API Reference | Lista completa de clases y métodos C++ de las API Qt Location |
Referencias y parámetros de plugins
Información sobre plugins, notas importantes sobre su uso, parámetros que se pueden proporcionar para influir en su comportamiento.
Proporciona un mapa vacío destinado a ser utilizado como fondo para una superposición de capas para los elementos del mapa. | |
Utiliza Open Street Map y servicios relacionados. |
Implantación de nuevos back-end y portabilidad
Para integradores de sistemas y distribuidores, información relacionada con la puesta a disposición de Qt Location para una nueva plataforma.
| GeoServicios | Información sobre los complementos GeoServices de Qt Location |
| Lugares | Información para implementadores de backend de lugares |
| Cambios en la API | Información sobre la migración de Qt 5 a Qt 6 |
Licencias
Qt Location está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Vea Licencias Qt para 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.
