En esta página

Qt Location QML Types

Visión general

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

  • Las instancias Place contienen información sobre el destino y los objetos circundantes, incluidas las representaciones visualizables.
  • Map permite mostrar la información contenida en los objetos Place, desplazarlos, ampliarlos, etc.
  • El route está determinado por un plugin, y cada routeSegment contiene las instrucciones de navegación, guiadas por el Location actual, continuamente actualizado.

Los plugins

Plugins suministran los datos necesarios para calcular las rutas y las instrucciones de navegación, y suelen estar vinculados a un servicio específico basado en la localización. Por ejemplo, un plugin puede permitir conectarse a un servicio que proporciona información sobre geocodificación y rutas, que puede ser consumida por la aplicación.

Puede haber varios plugins de GeoServices para diversas tareas, y algunos plugins proporcionan más de un servicio. Debe crearse una instancia de QML Plugin para cada complemento de GeoService. Se requieren plugins para enrutamiento y geocodificación, mapas y lugares, aunque el plugin por defecto gestiona estos cuatro servicios. Un plugin puede requerir acceso en línea o puede soportar mapas y datos a bordo.

Nota: es posible que los plugins no ofrezcan funciones como la paginación o las sugerencias de relevancia.

Los siguientes enlaces proporcionan 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 QML comunes

Plugin

Type describe un plugin de servicios basados en la localización

PluginParameter

Type describe un parámetro para un plugin

Tipos QML de mapas

GeoJsonData

Un modelo para representar, cargar y guardar documentos GeoJSON

Map

Type muestra un mapa

MapCircle

Type muestra un círculo geográfico en un mapa

MapCopyrightNotice

Item muestra el aviso de copyright válido actual para un elemento Map

MapItemGroup

Type es un contenedor para elementos de mapa

MapItemView

Se utiliza para rellenar un mapa a partir de un modelo

MapPolygon

El tipo muestra un polígono en un mapa

MapPolyline

Type muestra una polilínea en un mapa

MapQuickItem

Type muestra un objeto arbitrario Qt Quick en un mapa

MapRectangle

Type muestra un rectángulo en un mapa

MapRoute

Type muestra una ruta en un mapa

cameraCapabilities

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

mapType

Type contiene información sobre un tipo de mapa

RouteModel

Type proporciona acceso a las rutas

RouteQuery

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

route

Type representa una ruta geográfica

routeManeuver

Type representa la información relativa al punto de encuentro entre dos RouteSegments

routeSegment

Type representa un segmento de una ruta

Tipos QML de geocodificación

GeocodeModel

Type proporciona soporte para operaciones de búsqueda relacionadas con información geográfica

Lugares Tipos QML

Category

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

CategoryModel

Type proporciona un modelo de las categorías soportadas por un Plugin

ContactDetails

El tipo contiene los datos de contacto de un lugar

EditorialModel

Type proporciona un modelo de editoriales de lugares

ExtendedAttributes

El tipo contiene datos adicionales sobre un lugar

ImageModel

Type proporciona un modelo de imágenes de lugares

Place

El tipo representa un lugar que es una posición de interés

PlaceSearchModel

Proporciona acceso a los resultados de la 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 un detalle de contacto, como un número de teléfono o una dirección de sitio web

icon

El tipo representa el icono de un lugar

placeAttribute

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

ratings

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

supplier

Contiene datos sobre el proveedor de un lugar, su imagen, reseña o editorial.

user

El tipo identifica al usuario que ha contribuido a un determinado contenido de un lugar.

Listado alfabético de todos los tipos QML

Category

Type representa una categoría a la que puede asociarse un lugar

CategoryModel

Type proporciona un modelo de las categorías soportadas por un Plugin

ContactDetails

Type contiene los datos de contacto de un lugar

EditorialModel

Type proporciona un modelo de 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 proporciona soporte para operaciones de búsqueda relacionadas con información geográfica

ImageModel

El tipo proporciona un modelo de imágenes de lugares

Map

Type muestra un mapa

MapCircle

Type muestra un círculo geográfico en un mapa

MapCopyrightNotice

Tipo muestra el aviso de copyright válido actual para un elemento Mapa

MapItemGroup

Type es un contenedor de elementos de mapa

MapItemView

Se utiliza para rellenar el mapa a partir de un modelo

MapPolygon

El tipo muestra un polígono en un mapa

MapPolyline

Type muestra una polilínea en un mapa

MapQuickItem

Type muestra un objeto arbitrario Qt Quick en un mapa

MapRectangle

Type muestra un rectángulo en un mapa

MapRoute

El tipo muestra una ruta en un mapa

MapView

Un componente de visualización de mapas interactivos

Place

El tipo representa un lugar que es una posición de interés

PlaceSearchModel

Proporciona acceso a los resultados de la búsqueda de lugares

PlaceSearchSuggestionModel

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

Plugin

El tipo describe un plugin de servicios basados en la localización

PluginParameter

El tipo describe un parámetro para un plugin

ReviewModel

El tipo proporciona un modelo de reseñas de lugares

RouteModel

Type proporciona acceso a rutas

RouteQuery

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

cameraCapabilities

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

contactDetail

Type contiene información de contacto, como un número de teléfono o la dirección de un sitio web

icon

Type representa el icono de un lugar

mapType

Type 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 clasificación de un lugar

route

El tipo representa una ruta geográfica

routeManeuver

El tipo representa la información relativa al punto en el que confluyen dos routeSegments

routeSegment

El tipo representa un segmento de una ruta

supplier

Contiene datos sobre el proveedor de un lugar, su imagen, reseña o editorial

user

El tipo identifica al usuario que ha contribuido a un determinado contenido de 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.