En esta página

Mapas y navegación (QML)

Mapas y navegación proporciona tipos de interfaz de usuario de QtQuick para mostrar información geográfica en un mapa, además de permitir la interacción del usuario con los objetos superpuestos en el mapa y con la propia visualización. También contiene utilidades para la geocodificación (buscar unas coordenadas geográficas a partir de una dirección postal) y la navegación (incluidas las indicaciones para ir en coche y a pie).

Para realizar la navegación necesitamos un routeas desde el punto de partida hasta el destino. Estas rutas se componen de segmentos, en los que cada « routeSegment » puede considerarse una subtarea de navegación; por ejemplo, «conducir 100 metros» o «girar a la izquierda». El inicio y el final de cada segmento son puntos de ruta, es decir, una parte del trayecto.

Un caso de uso típico de la API es el de un usuario que busca un tipo concreto de lugar, como un restaurante; el usuario introduce una cadena de búsqueda en la aplicación de mapas y se le muestra una lista de resultados de restaurantes «cerca» del dispositivo. A continuación, la aplicación puede utilizarse para navegar hasta el destino elegido mediante una ruta optimizada en función de las características del entorno que puedan facilitar o dificultar el trayecto. La navegación continúa mientras se supervisa el avance del usuario a través de su ubicación actual.

Los tipos se basan en los conceptos y tipos de la API de posicionamiento de QML. En el tutorial de Mapas y Navegación se puede encontrar una introducción más práctica a los tipos de Mapas y Navegación.

Mapas

Visualización de mapas

La visualización de un mapa se realiza mediante los tipos QML de Map. El tipo «Map» admite la interacción del usuario a través del tipo QML de MapView. El objeto «Map» dibuja el mapa en pantalla utilizando OpenGL (ES), lo que permite un renderizado acelerado por hardware cuando esté disponible.

Tipos clave

PluginUn complemento de servicios basados en la ubicación proporciona datos, incluidos datos de mapas, que luego se muestran en un objeto «Map».
MapQtQuick Elemento para mostrar un mapa en pantalla.
MapViewAyuda de interacción para los gestos de desplazamiento, deslizamiento rápido y pellizcar para ampliar en un Map.

Ten en cuenta que el cliente debe crear un objeto « Plugin » antes de utilizar un tipo « Map » para poder acceder a los datos del mapa que se van a mostrar.

Colocación de objetos en un mapa (objetos de superposición de mapa)

Los mapas también pueden contener objetos de superposición, que se utilizan para mostrar información en su superficie. Existe un conjunto de objetos de superposición básicos predefinidos, así como la posibilidad de implementar objetos de superposición personalizados utilizando el tipo ` MapQuickItem `, que puede contener cualquier elemento estándar de tipo ` QtQuick `.

Tipos clave

MapCircleUn círculo geográfico (todos los puntos situados a una distancia determinada del centro), opcionalmente con un borde.
MapRectangleUn rectángulo cuyos puntos superior izquierdo e inferior derecho se especifican como tipos « geoCoordinate », opcionalmente con un borde.
MapPolygonUn polígono formado por una lista arbitraria de « coordinates ».
MapPolylineUna polilínea formada por una lista arbitraria de elementos « coordinates ».
MapQuickItemConvierte cualquier elemento « QtQuick » arbitrario en un objeto de superposición de mapa. « MapQuickItem » permite especificar objetos de superposición de mapa personalizados.

Diseño «modelo-vista» con objetos de superposición de mapas

Para generar automáticamente objetos de superposición de mapas basados en el contenido de un modelo de « QtQuick » (por ejemplo, un elemento de « ListModel »), se dispone del tipo « MapItemView ». Acepta cualquier objeto de superposición de mapas como su delegado y solo puede crearse dentro de un « Map ».

Tipos de clave

MapItemViewRellena un mapa con objetos de superposición de mapas basándose en los datos proporcionados por un modelo.

Interacción con los objetos de superposición de mapas

Las propiedades de los objetos de superposición de mapas que influyen en su apariencia en la pantalla se pueden modificar en cualquier momento, y muchas de ellas también se pueden utilizar en animaciones. La animación de objetos de superposición de mapas basados en coordenadas, como MapPolygon y MapPolyline, aún no está disponible.

Geocodificación: de dirección a coordenadas y viceversa

La geocodificación es la conversión de coordenadas geográficas en direcciones, o viceversa. Dicha conversión suele implicar el envío de los datos de origen a un servidor, que a continuación realiza la conversión y devuelve los resultados, aunque algunos proveedores de servicios basados en la ubicación plugins pueden ofrecer cierta funcionalidad de geocodificación sin necesidad de enviar datos a un servidor remoto. La disponibilidad y la precisión de la conversión suelen depender de la ubicación o dirección que se esté convirtiendo, ya que las diferentes zonas de la Tierra están cartografiadas con distintos grados de precisión.

Una consulta de geocodificación en QML se realiza utilizando el tipo GeocodeModel. Para una consulta de dirección a coordenadas, su propiedad query puede establecerse en un objeto Address o en una cadena que contenga la forma textual de la dirección que se va a buscar. Para realizar la operación inversa, la misma propiedad puede establecerse en un geoCoordinate. Los resultados están disponibles en el contenido del modelo.

Tipos de claves

PluginUn complemento de servicios basados en la ubicación proporciona datos, incluidos los resultados de las traducciones de geocodificación, que se ponen a disposición de los clientes a través de un GeocodeModel.
GeocodeModelConsulta al complemento para obtener traducciones de geocodificación y proporciona acceso a los resultados a través de índices en el modelo.
AddressDirección estructurada para su uso en consultas y resultados de geocodificación.

Ten en cuenta que el cliente debe crear un objeto Plugin antes de utilizar un objeto GeocodeModel. Esto permitirá el acceso a los servicios de traducción de geocodificación y, por lo tanto, a los datos que se van a mostrar.

Rutas y navegación

El cálculo de rutas consiste en determinar un trayecto navegable de un punto a otro en un mapa. Partiendo de un mapa que tiene en cuenta los elementos que facilitan o dificultan la navegación, como puentes, vías navegables, etc., se puede construir una serie de segmentos que conforman el trayecto. Si estos « routeSegment» son sencillos, podemos añadir información de navegación en los puntos de conexión, los « routeManeuver», entre los segmentos.

Tipos clave

routeEl recorrido completo que se va a seguir.
routeSegmentLos componentes individuales de una ruta.
routeManeuverLa información de navegación que une los segmentos.
RouteModelEl método para realizar solicitudes en el backend con el fin de obtener información sobre la ruta.

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