geoCoordinate QML Value Type

地理坐标类型表示并存储地理位置。更多

属性

• altitude : real
• isValid : bool
• latitude : real
• longitude : real

方法

• geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
• real azimuthTo(geoCoordinate other)
• real distanceTo(geoCoordinate other)

详细说明

该类型是QGeoCoordinate 的 QML 表示法，以latitude 、longitude 和altitude 属性的形式表示地理位置。latitude 属性指定赤道上下的十进制度数。正纬度表示北半球，负纬度表示南半球。longitude 属性指定东经和西经的十进制度数。正经度表示东半球，负经度表示西半球。altitude 属性指定海拔高度的米数。这些属性共同指定了地球表面或其附近任何地方的三维位置。

isValid 属性可用于测试坐标是否有效。如果一个坐标具有有效的经度和纬度，则该坐标被认为是有效的。不需要有效的高度。纬度必须在 -90 至 90 之间（含 90），经度必须在 -180 至 180 之间（含 180）。

Qt Location 模块中的许多其他类型都使用地理坐标类型，用于指定对象在地图上的位置、设备的当前位置以及许多其他任务。它们还具有许多重要的实用方法，使原本复杂的计算变得简单易用，例如atDistanceAndAzimuth()。

精确度

存储在地理坐标类型中的纬度、经度和海拔属性以双倍表示，精度约为小数点后 16 位，足以指定微米。在azimuthTo() 和distanceTo() 等 geoCoordinate 方法中执行的计算也使用双倍来表示所有中间值，但其球形地球模型固有的不准确性会影响其输出的误差。

使用示例

要创建地理坐标，请使用下面描述的方法之一。在所有情况下，指定altitude 属性都是可选的。

要创建地理坐标值，请使用QtPositioning.coordinate() 函数：

import QtPositioning

Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }

或作为单独的latitude 、longitude 和altitude 组件：

Location {
    coordinate {
        latitude: -27.5
        longitude: 153.1
    }
}

与 C++ 集成时，请注意从 C++ 传入 QML 的任何QGeoCoordinate 值都会自动转换为地理坐标值，反之亦然。

属性文档

方法文档