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
| Plugin | Un complemento de servicios basados en la ubicación proporciona datos, incluidos datos de mapas, que luego se muestran en un objeto «Map». |
| Map | QtQuick Elemento para mostrar un mapa en pantalla. |
| MapView | Ayuda 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
| MapCircle | Un círculo geográfico (todos los puntos situados a una distancia determinada del centro), opcionalmente con un borde. |
| MapRectangle | Un rectángulo cuyos puntos superior izquierdo e inferior derecho se especifican como tipos « geoCoordinate », opcionalmente con un borde. |
| MapPolygon | Un polígono formado por una lista arbitraria de « coordinates ». |
| MapPolyline | Una polilínea formada por una lista arbitraria de elementos « coordinates ». |
| MapQuickItem | Convierte 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
| MapItemView | Rellena 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
| Plugin | Un 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. |
| GeocodeModel | Consulta al complemento para obtener traducciones de geocodificación y proporciona acceso a los resultados a través de índices en el modelo. |
| Address | Direcció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
| route | El recorrido completo que se va a seguir. |
| routeSegment | Los componentes individuales de una ruta. |
| routeManeuver | La información de navegación que une los segmentos. |
| RouteModel | El 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.