En esta página

Qt Location QML Types

Resumen

En resumen, los principales tipos de QML y sus funciones son los siguientes:

  • Las instancias de ` Place ` contienen información sobre el destino y los objetos circundantes, incluidas las representaciones visualizables.
  • El ` Map ` permite visualizar, desplazar, ampliar y reducir, etc., la información contenida en los objetos ` Place `.
  • El ` route ` viene determinado por un complemento, y cada ` routeSegment ` contiene las instrucciones de navegación, guiadas por el ` Location` actual, que se actualiza continuamente.

Los complementos

Pluginproporcionan los datos necesarios para calcular rutas e instrucciones de navegación, y suelen estar vinculados a un servicio específico basado en la ubicación. Por ejemplo, un complemento puede permitir conectarse a un servicio que proporcione información de geocodificación y cálculo de rutas, que la aplicación puede utilizar.

Puede haber varios complementos de GeoServices para diversas tareas, y algunos complementos pueden proporcionar más de un servicio. Se debe crear una instancia de QML Plugin para cada complemento de GeoService. Se requieren complementos para el cálculo de rutas y la geocodificación, los mapas y los lugares; sin embargo, el complemento predeterminado gestiona estos cuatro servicios. Un complemento puede requerir acceso a Internet o bien puede admitir mapas y datos integrados.

Nota: Es posible quelos complementos no ofrezcan funciones como la paginación o las sugerencias de relevancia.

Los siguientes enlaces ofrecen más información sobre mapas y lugares:

Mapas y navegaciónVisualización de mapas y búsqueda de rutas
LugaresBúsqueda y gestión de puntos de interés

Tipos comunes de QML

Plugin

El tipo describe un complemento de servicios basados en la ubicación

PluginParameter

El tipo describe un parámetro para un complemento

Tipos QML de mapas

GeoJsonData

Un modelo para representar, cargar y guardar documentos GeoJSON

Map

El tipo muestra un mapa

MapCircle

El tipo muestra un círculo geográfico en un mapa

MapCopyrightNotice

El elemento «Item» muestra el aviso de derechos de autor válido actualmente para un elemento del mapa

MapItemGroup

El tipo es un contenedor de elementos del mapa

MapItemView

Se utiliza para rellenar el mapa a partir de un modelo

MapPolygon

El tipo muestra un polígono en un mapa

MapPolyline

El tipo muestra una polilínea en un mapa

MapQuickItem

El tipo muestra un objeto « Qt Quick » arbitrario en un mapa

MapRectangle

El tipo muestra un rectángulo en un mapa

MapRoute

El tipo muestra una ruta en un mapa

cameraCapabilities

El tipo contiene información sobre las capacidades de la cámara para un tipo de mapa específico

mapType

El tipo contiene información sobre un tipo de mapa

RouteModel

El tipo proporciona acceso a las rutas

RouteQuery

El tipo se utiliza para proporcionar parámetros de consulta a un RouteModel

route

El tipo representa una ruta geográfica

routeManeuver

El tipo «Type» representa la información relevante para el punto en el que se unen dos «routeSegments»

routeSegment

El tipo representa un segmento de una ruta

Tipos QML de geocodificación

GeocodeModel

El tipo ofrece soporte para operaciones de búsqueda relacionadas con la información geográfica

Tipos de QML de «Lugares»

Category

El tipo representa una categoría a la que se puede asociar un «Place»

CategoryModel

El tipo proporciona un modelo de las categorías compatibles con un complemento

ContactDetails

El tipo contiene los datos de contacto de un lugar

EditorialModel

El tipo proporciona un modelo de artículos editoriales sobre lugares

ExtendedAttributes

El tipo contiene datos adicionales sobre un lugar

ImageModel

El «Tipo» proporciona un modelo de las imágenes de un lugar

Place

El tipo representa una ubicación que constituye un punto de interés

PlaceSearchModel

Proporciona acceso a los resultados de búsqueda de lugares

PlaceSearchSuggestionModel

Proporciona acceso a sugerencias de términos de búsqueda

ReviewModel

El tipo proporciona un modelo de reseñas de lugares

contactDetail

El tipo contiene datos de contacto, como un número de teléfono o la dirección de una página web

icon

El tipo representa el icono de un lugar

placeAttribute

El tipo contiene información genérica sobre los atributos del lugar

ratings

El tipo contiene información sobre la valoración del lugar

supplier

Contiene datos relativos al proveedor de un lugar, una imagen del lugar, una reseña o un artículo editorial

user

El tipo identifica a un usuario que ha aportado un elemento de contenido concreto sobre un lugar

Lista alfabética de todos los tipos de QML

Category

El tipo representa una categoría a la que se puede asociar un lugar

CategoryModel

El tipo proporciona un modelo de las categorías compatibles con un complemento

ContactDetails

El tipo contiene los datos de contacto de un lugar

EditorialModel

El tipo proporciona un modelo de los artículos editoriales de un lugar

ExtendedAttributes

El tipo contiene datos adicionales sobre un lugar

GeoJsonData

Un modelo para representar, cargar y guardar documentos GeoJSON

GeocodeModel

El tipo ofrece soporte para operaciones de búsqueda relacionadas con la información geográfica

ImageModel

El tipo proporciona un modelo de imágenes de lugares

Map

El tipo muestra un mapa

MapCircle

El tipo muestra un círculo geográfico en un mapa

MapCopyrightNotice

El elemento muestra el aviso de derechos de autor válido actualmente para un elemento del mapa

MapItemGroup

El tipo es un contenedor de elementos del mapa

MapItemView

Se utiliza para rellenar el mapa a partir de un modelo

MapPolygon

El tipo muestra un polígono en un mapa

MapPolyline

El tipo muestra una polilínea en un mapa

MapQuickItem

El tipo muestra un objeto « Qt Quick » arbitrario en un mapa

MapRectangle

El tipo muestra un rectángulo en un mapa

MapRoute

El tipo muestra una ruta en un mapa

MapView

Un componente de visualización de mapas interactivo

Place

El tipo representa una ubicación que es un punto de interés

PlaceSearchModel

Proporciona acceso a los resultados de búsqueda de lugares

PlaceSearchSuggestionModel

Proporciona acceso a sugerencias de términos de búsqueda

Plugin

«Type» describe un complemento de servicios basados en la ubicación

PluginParameter

El tipo describe un parámetro para un complemento

ReviewModel

El tipo proporciona un modelo de reseñas de lugares

RouteModel

El tipo proporciona acceso a rutas

RouteQuery

El tipo se utiliza para proporcionar parámetros de consulta a un RouteModel

cameraCapabilities

El tipo contiene información sobre las capacidades de la cámara para un tipo de mapa específico

contactDetail

El tipo contiene datos de contacto, como un número de teléfono o la dirección de una página web

icon

El tipo representa el icono de un lugar

mapType

El tipo contiene información sobre un tipo de mapa

placeAttribute

El tipo contiene información genérica sobre los atributos de un lugar

ratings

El tipo contiene información sobre la valoración de un lugar

route

El tipo representa una ruta geográfica

routeManeuver

El tipo representa la información relevante sobre el punto en el que se unen dos segmentos de ruta

routeSegment

El tipo representa un segmento de una ruta

supplier

Contiene datos relativos al proveedor de un lugar, una imagen del lugar, una reseña o un contenido editorial

user

El tipo identifica a un usuario que ha aportado un elemento de contenido concreto sobre un lugar

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