En esta página

Qt Location

El módulo « Qt Location » te ayuda a crear soluciones de mapas utilizando datos disponibles de proveedores de servicios de localización populares, como OpenStreetMap.

La API de Qt Location te permite:

  • Acceder a datos cartográficos y presentarlos.
  • Admitir gestos táctiles en un área específica del mapa.
  • Buscar 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 de QML

Para utilizar los tipos, añade las siguientes declaraciones de importación a tu archivo ` .qml `:

import QtPositioning
import QtLocation

Nota: Muchas API de módulos QML de Qt Location utilizan tipos del módulo Qt Positioning. Por ejemplo, para definir una coordenada como el centro del mapa se necesitan tipos del módulo Qt Positioning.

API de C++

Para proyectos en C++, incluye el encabezado adecuado para el caso de uso actual; por ejemplo, las aplicaciones que utilizan rutas pueden usar:

#include <QGeoRoute>

Para utilizar la API de C++ de un módulo de Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen 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 Location)
target_link_libraries(mytarget PRIVATE Qt6::Location)

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ñada el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:

QT += location

Submódulos

La API se divide 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 se pueden obtener mediante el módulo QtPositioning.

Lugares

El submódulo «Places» es el complemento natural de «Positioning», 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 ofrece datos sobre la ubicación, el tamaño y otros detalles relacionados con un POI. La API de «Places» también puede recuperar imágenes, reseñas y otros contenidos relacionados con un lugar.

Introducción a «Lugares»:para QMLpara C++

Mapas y navegación

El módulo ofrece alternativas en QML y C++ para mapas y navegación. La alternativa en C++ proporciona clases de utilidad para obtener información de geocodificación (determinación de coordenadas geográficas a partir de una dirección postal) y navegación (incluidas indicaciones para ir en coche y a pie), mientras que su equivalente en QML ofrece componentes de interfaz de usuario para visualizar la información.

Introducción a los mapas y la navegación:para QMLpara C++

Ejemplos

Aplicaciones de ejemploEjemplos que muestran el uso de las API de Qt Location
Tutorial de mapas y navegaciónTutorial de introducción a los tipos de mapas de QML

Referencia de la API

A continuación se incluyen listas de las clases y los componentes de interfaz de usuario que ofrece el módulo, junto con aplicaciones de ejemplo que ilustran su uso:

QML API ReferenceLista completa de componentes QML de la API « Qt Location »
Referencia de la API de C++ por dominioLista completa de clases y métodos en C++ de las API de Qt Location, ordenados por dominio
C++ API ReferenceLista completa de clases y métodos en C++ de las API de Qt Location

Referencias y parámetros de los complementos

Información sobre los complementos, notas importantes sobre su uso y los parámetros que se pueden proporcionar para influir en su comportamiento.

Qt Location Items Overlay Plugin

Proporciona un mapa vacío destinado a utilizarse como fondo para capas superpuestas de elementos del mapa.

Qt Location Open Street Map Plugin

Utiliza OpenStreetMap y servicios relacionados.

Implementación de nuevos back-ends y portabilidad

Para integradores de sistemas y distribuidores, información relacionada con la adaptación de Qt Location a una nueva plataforma.

GeoServicesInformación sobre los complementos GeoServices de Qt Location
LugaresInformación para los responsables de la implementación del back-end de «Lugares»
Cambios en la APIInformación sobre la migración de Qt 5 a Qt 6

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