本页内容

Qt Location QML Types

概述

简而言之,主要 QML 类型及其作用如下:

  • Place 实例保存有关目标对象及其周围对象的信息,包括可显示的表示形式。
  • Map 使Place 对象中所包含的信息能够被显示、平移、缩放等。
  • route 由插件确定,每个routeSegment 都包含导航指令,并受持续更新的当前Location 指导。

插件

Plugin提供计算路线和导航指令所需的数据,通常与特定的基于位置的服务相关联。例如,一个插件可能允许连接到提供地理编码和路线规划信息的服务,应用程序可以利用这些信息。

可能存在用于各种任务的多种 GeoServices 插件,其中一些插件提供不止一项服务。每个 GeoService 插件都必须创建一个 QMLPlugin 实例。路由、地理编码、地图和地点功能都需要插件,但默认插件可处理这四项服务。 插件可能需要在线访问,也可能支持本地地图和数据。

注意:插件 可能不提供分页或相关性提示等功能。

以下链接提供了有关地图和地点的更多信息:

地图与导航显示地图和查找路线
地点搜索和管理兴趣点

常见的 QML 类型

Plugin

Type 描述了一个基于位置的服务插件

PluginParameter

类型描述了插件的参数

地图 QML 类型

GeoJsonData

用于表示、加载和保存GeoJSON文档的模型

Map

用于显示地图的类型

MapCircle

Type 在地图上显示地理圆

MapCopyrightNotice

Item 显示地图元素当前有效的版权声明

MapItemGroup

该类型是地图项的容器

MapItemView

用于从模型填充地图

MapPolygon

类型在地图上显示多边形

MapPolyline

类型在地图上显示一条折线

MapQuickItem

该类型在地图上显示任意Qt Quick 对象

MapRectangle

Type在地图上显示一个矩形

MapRoute

该类型在地图上显示一条路线

cameraCapabilities

该类型包含关于特定地图类型摄像机功能的信息

mapType

该类型保存有关地图类型的信息

RouteModel

该类型提供对路线的访问

RouteQuery

该类型用于向 RouteModel 提供查询参数

route

“Type” 表示一条地理路线

routeManeuver

“Type” 表示与两个 routeSegment 交汇点相关的信息

routeSegment

该类型表示路线的一个路段

地理编码 QML 类型

GeocodeModel

该类型为与地理信息相关的搜索操作提供支持

地点 QML 类型

Category

该类型表示“地点”可关联的类别

CategoryModel

“类型”提供了一个插件所支持的类别模型

ContactDetails

“类型”保存“地点”的联系方式

EditorialModel

“类型”提供了地点编辑内容的模型

ExtendedAttributes

“类型”包含有关“地点”的附加数据

ImageModel

“类型”提供地点图片的模型

Place

“类型”代表一个值得关注的地点

PlaceSearchModel

提供对地点搜索结果的访问

PlaceSearchSuggestionModel

提供搜索词建议的访问功能

ReviewModel

“类型”提供地点评论的模型

contactDetail

“类型”包含联系方式,例如电话号码或网站地址

icon

“类型”代表一个地点的图标

placeAttribute

该类型保存通用地点属性信息

ratings

该类型包含场所评分信息

supplier

存储有关场所供应商、场所图片、评论或编辑内容的数据

user

类型标识了贡献特定场所内容项的用户

所有 QML 类型的按字母顺序列表

Category

类型代表场所可关联的类别

CategoryModel

类型提供插件所支持的分类模型

ContactDetails

类型存储地点的联系方式

EditorialModel

类型提供地点编辑内容的模型

ExtendedAttributes

类型存储有关“地点”的附加数据

GeoJsonData

用于表示、加载和保存 GeoJSON 文档的模型

GeocodeModel

该类型为与地理信息相关的搜索操作提供支持

ImageModel

该类型提供了一个地点图片的模型

Map

Type 显示地图

MapCircle

该类型在地图上显示地理圆

MapCopyrightNotice

Item 显示地图元素的当前有效版权声明

MapItemGroup

该类型是地图项的容器

MapItemView

用于从模型中填充地图

MapPolygon

类型在地图上显示多边形

MapPolyline

类型在地图上显示一条多线

MapQuickItem

该类型在地图上显示任意Qt Quick 对象

MapRectangle

Type在地图上显示一个矩形

MapRoute

该类型在地图上显示一条路线

MapView

交互式地图查看器组件

Place

该类型表示一个感兴趣的位置

PlaceSearchModel

提供对地点搜索结果的访问

PlaceSearchSuggestionModel

提供搜索词建议

Plugin

Type 描述了一个基于位置的服务插件

PluginParameter

“类型”描述了插件的一个参数

ReviewModel

类型提供了一个地点评论模型

RouteModel

该类型提供对路线的访问

RouteQuery

该类型用于向 RouteModel 提供查询参数

cameraCapabilities

Type 包含特定地图类型的相机功能信息

contactDetail

Type 包含联系详情,例如电话号码或网站地址

icon

Type 表示地点的图标

mapType

Type 包含有关地图类型的信息

placeAttribute

“类型”存储通用地点属性信息

ratings

“类型”字段包含地点的评分信息

route

类型表示一条地理路线

routeManeuver

类型代表两个路线段交汇点的相关信息

routeSegment

类型表示路线中的一段

supplier

包含有关地点供应商、地点图片、评论或编辑内容的数据

user

“类型”标识了贡献特定地点内容的用户

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