Map QML Type

访问当前活动的map type 。

设置该属性可更改活动的map type 。有关可能的值，请参阅supportedMapTypes 属性。

另请参阅 mapType 。

该属性用于保存地图的方位，默认值为 0。默认值为 0。如果地图使用的插件支持方位，则该值的有效范围为 0 至 360。如果地图使用的插件不支持方位，则更改此属性不会有任何效果。

此属性在 QtLocation 5.9 中引入。

该属性保存占据映射视口中心的坐标。无效的中心坐标将被忽略。

默认值为任意有效坐标。

该属性用于设置地图元素的背景颜色。

该属性用于设置版权声明的可见性。通知通常显示在左下角。默认情况下，该属性设置为true 。

此只读属性保存最近发生的地图服务提供商错误。

• 地图。NoError - 未发生错误。
• Map.NotSupportedError -未设置地图插件属性或没有与插件关联的映射管理器。
• Map.UnknownParameterError -插件无法识别给定的参数。
• Map.MissingRequiredParameterError - 插件未找到预期参数之一。
• Map.ConnectionError - 插件无法连接其后台服务或数据库。

另请参阅 QGeoServiceProvider::Error 。

该只读属性包含最新映射提供程序错误的文本显示。如果未发生错误，则返回空字符串。

如果发生的错误没有相关的文本表述，也可能返回空字符串。

另请参阅 QGeoServiceProvider::errorString()。

该属性保存用于查看地图的摄像机的视场角，单位为度。如果未设置地图的插件属性，或者插件不支持映射，则该值为 45 度。

请注意，改变该值也会隐式地改变摄像机与地图之间的距离，因此在倾斜角度为 0 度时，该属性的任何值所产生的图像都是相同的。

有关此参数的更多信息，请查阅维基百科上有关视场角和视角的文章。

此属性在 QtLocation 5.9 中引入。

另请参阅 minimumFieldOfView 和maximumFieldOfView 。

不按特定顺序返回所有地图项的列表。这些项包括作为类型声明的一部分静态声明的项，以及动态项 (addMapItem,MapItemView)。

另请参见 addMapItem,removeMapItem, 和clearMapItems 。

该属性表示地图是否已成功初始化并可随时使用。某些方法，如fromCoordinate 和toCoordinate ，在地图准备就绪之前将无法使用。由于Map 的架构，建议使用该属性发出的信号代替Component.onCompleted ，以确保一切按预期进行。

该属性表示地图的最大有效视场角，单位为度。

plugin 使用的最小倾斜视场是该属性的上限。如果plugin 属性未设置或插件不支持映射，则该属性为179 。

该属性在 QtLocation 5.9 中引入。

另请参阅 fieldOfView 和minimumFieldOfView 。

该属性保存地图的最大有效倾斜度，单位为度。

plugin 所定义的最大倾斜度是该属性的上限。如果未设置plugin 属性或插件不支持映射，则该属性为89.5 。

自QtLocation 5.12 起，插件可根据当前缩放级别额外限制该值。

该属性在 QtLocation 5.9 中引入。

另请参阅 tilt 和minimumTilt 。

该属性保存地图的最大有效缩放级别。

最大缩放级别由所使用的plugin 定义。如果plugin 属性未设置或插件不支持映射，则该属性为30 。

该属性表示地图的最小有效视场角，单位为度。

plugin 使用的最小倾斜视场是该属性的下限。如果plugin 属性未设置或插件不支持映射，则该属性为1 。

此属性在 QtLocation 5.9 中引入。

另请参阅 fieldOfView 和maximumFieldOfView 。

该属性保存地图的最小有效倾斜度，单位为度。

plugin 所定义的最小倾斜度是该属性的下限。如果未设置plugin 属性或插件不支持映射，则该属性为0 。

自QtLocation 5.12 起，插件可根据当前缩放级别额外限制该值。

该属性在 QtLocation 5.9 中引入。

另请参阅 tilt 和maximumTilt 。

该属性保存地图的最小有效缩放级别。

plugin 所定义的最小缩放级别是该属性的下限。不过，返回值也与画布大小有关，可以高于用户指定的值或所用插件定义的最小缩放级别，以防止地图在任一维度上都小于视口。

如果未设置plugin 属性或插件不支持映射，则该属性为0 。

该属性包含提供映射功能的插件。

这是一个只写一次的属性。一旦映射有了关联插件，任何试图修改该插件的行为都将被忽略。

该只读属性包含该映射支持的map types 集合。

另请参阅 activeMapType 。

该属性保存地图的倾斜度，单位为度。默认值为 0。该值的有效范围是 [minimumTilt,maximumTilt ]。如果地图使用的插件不支持倾斜，则更改此属性不会有任何效果。

该属性在 QtLocation 5.9 中引入。

另请参阅 minimumTilt 和maximumTilt 。

该属性保存 Map QML 元素内部的可见区域。它是一个矩形，其坐标相对于 Map 元素。它的大小将与 Map 元素的大小保持一致。visibleArea 为空意味着整个 Map 都是可见的。

该属性表示占据地图视口的区域。摄像机被放置在形状的中心位置，并尽可能以最大的整体缩放级别在屏幕上显示整个形状。这意味着，在设置该属性后不久读取返回的区域等于或大于设置的区域。

设置该属性会隐式更改地图的center 和zoomLevel 。之前为这些属性设置的任何值都将被覆盖。

该属性表示地图的缩放级别。

缩放级别值越大，提供的细节越多。缩放级别总是非负的。默认值为 8.0。根据所使用插件的不同，[minimumZoomLevel,maximumZoomLevel]范围以外的值可能会被接受或被箝制，该范围代表了可使用磁贴的范围。

当用户点击版权声明中的link 时会发出该信号。应用程序应在浏览器中打开该链接或向用户显示其内容。

将给定的item 添加到地图（例如MapQuickItem,MapCircle ）。如果对象已在地图上，则不会再次添加。

举例来说，如果您有一个代表您当前位置的MapCircle ，那么您就可以将其添加到地图上：

import QtQuick
import QtPositioning
import QtLocation

PositionSource {
    id: positionSource
}

Map {
    id: map
    property MapCircle circle

    Component.onCompleted: {
        circle = Qt.createQmlObject('import QtLocation; MapCircle {}', page)
        circle.center = positionSource.position.coordinate
        circle.radius = 5000.0
        circle.color = 'green'
        circle.border.width = 3
        map.addMapItem(circle)
    }
}

另请参阅 mapItems,removeMapItem, 和clearMapItems 。

将给定的itemGroup 中包含的地图项添加到地图中（例如MapQuickItem,MapCircle ）。

另请参阅 MapItemGroup 和removeMapItemGroup 。

将itemView 添加到地图。

另请参阅 MapItemView 和removeMapItemView 。

将coordinate 对齐到point 。此方法有效扩展了center qml 属性提供的功能，允许将坐标对齐到地图元素中心以外的点。这在场景中心（如光标）不需要完全位于地图中心的应用中非常有用。

如果地图是倾斜的，而coordinate 恰好位于摄像机后面，或者地图尚未准备就绪（参见mapReady ），调用此方法将没有任何效果。

随 Qt 5.10 发布的此 API 为技术预览版。

另请参阅 center 。

清除当前所选插件收集的地图数据。

另请参阅 plugin 。

从地图中删除所有项目和项目组。

另请参阅 mapItems,addMapItem,removeMapItem,addMapItemGroup 和removeMapItemGroup 。

将视口调整为特定的地理形状geoShape 。margins 以屏幕像素为单位。

另请参阅 visibleRegion 。

如果未提供参数，则将当前视口与所有地图项的边界拟合。摄像机会被放置在地图项的中心，并尽可能以最大的整体缩放级别在屏幕上显示所有地图项。如果提供items ，则仅将当前视口与指定地图项的边界相匹配。

另请参阅 fitViewportToVisibleMapItems 。

将当前视口与所有可见地图项的边界相匹配。摄像机位于地图项的中心，并尽可能以最大的整体缩放级别在屏幕上显示所有地图项。

另请参阅 fitViewportToMapItems 。

返回与coordinate 对应的地图项的相对位置。

如果clipToViewPort 是true ，或者没有提供，那么如果coordinate 不在当前视口内，则返回无效的QPointF 。

开始沿 x 轴平移地图dx 像素，沿 y 轴平移地图dy 像素。

dx 的正值会使地图向右移动，负值会使地图向左移动。dy 的正值使地图向下移动，负值使地图向上移动。

在平移过程中，center 和zoomLevel 可能会发生变化。

允许地图在空闲期间预取的可选提示

从地图中删除给定的item （例如MapQuickItem,MapCircle ）。如果该 MapItem 不存在或之前未添加到地图中，则该方法不会执行任何操作。

另请参阅 mapItems,addMapItem, 和clearMapItems 。

从地图中删除itemGroup 及其包含的项目。

另请参阅 MapItemGroup 和addMapItemGroup 。

从地图中删除itemView 及其实例化的项目。

另请参阅 MapItemView 和addMapItemView 。

将地图的方位设置为bearing ，并围绕coordinate 旋转。如果地图使用的插件支持轴承，bearing 的有效范围为 0 至 360。如果地图所使用的插件不支持方位，或者地图是倾斜的，而coordinate 恰好位于摄像头后方，或者地图尚未准备就绪（请参阅mapReady ），调用此方法将不起作用。

随 Qt 5.10 发布的此 API 为技术预览版。

返回position 相对于地图项的坐标。

如果clipToViewPort 是true ，或未提供，那么如果position 不在当前视口内，则返回无效坐标。