Coordinate QML Type

Tools to convert and parse GPS coordinates. More...

• List of all members, including inherited members

Properties

• availableConvertFormats : QStringList
• availableParseFormats : QStringList

Methods

• object convert(qgeocoordinate coordinate, string format)
• object convert(qgeocoordinate coordinate, string format, object options)
• object parse(string text)
• object parse(string text, object options)

Detailed Description

The Coordinate component provides methods to either parse a text representation of geographic coordinates into a valid location format, as well as methods to convert a location value between different coordinate formats. This component is a singleton, and as such does not need to be instantiated.

The following code sample demonstrates a potential usage of the Coordinate component. The center of the map provides a value that is converted into the coordinate output below, while the text field above the map can be used to enter a coordinate in text, that will be parsed as a valid coordinate value that the map will zoom to.

Map {
    id: map
    plugin: Plugin { preferred: [ "esri" ] }
    center: QtPositioning.coordinate(  34.057252, -117.194581 )
    zoomLevel: 17
    copyrightsVisible: false

    TextField {
        width: parent.width
        text: "34°03.4351'N 117°11.6749'W" // geographic (dd, dms, ddm), geouri, srs, utm and mgrs
        placeholderText: qsTr( "Enter coordinate" )
        validator: InputValidator {
            validate: function ( input ) {
                let info = Coordinate.parse( input );
                return info.coordinateValid ? InputValidator.Acceptable : InputValidator.Intermediate;
            }
        }
        onAccepted: {
            let info = Coordinate.parse( text );
            map.center = QtPositioning.coordinate( info.coordinate.latitude, info.coordinate.longitude );
        }
    }

    Text {
        anchors.bottom: parent.bottom
        width: parent.width
        text: coordinateToDMS( map.center )
    }

    function coordinateToDMS( coordinate ) {
        let format = "dms"; // mgrs, utm, ups, universalGrid, srs, dd, ddm, dms
        let options = { precision: 4 };
        let info = Coordinate.convert( coordinate, format, options );
        return info.dms.latitudeText + " " + info.dms.longitudeText;
    }
}

Property Documentation

Method Documentation