Format coordinates

View inQMLC++
View on GitHub
Sample viewer app

Format coordinates in a variety of common notations.

screenshot

Use case

The coordinate formatter can format a map location in WGS84 in a number of common coordinate notations. Parsing one of these formats to a location is also supported. Formats include decimal degrees; degrees, minutes, seconds; Universal Transverse Mercator (UTM), and United States National Grid (USNG).

How to use the sample

Click on the map to see a callout with the clicked location's coordinate formatted in 4 different ways. You can also put a coordinate string in any of these formats in the text field. Hit Enter and the coordinate string will be parsed to a map location which the callout will move to.

How it works

  1. Get or create a map Point with a spatial reference.
  2. Use one of the static "to" methods on CoordinateFormatter such as CoordinateFormatter::toLatitudeLongitude(point, LatitudeLongitudeFormat::DecimalDegrees, 4) to get the formatted string.
  3. To go from a formatted string to a Point, use one of the "from" static methods like CoordinateFormatter::fromUtm(coordinateString, map.spatialReference(), UtmConversionMode::LatitudeBandIndicators).

Relevant API

  • CoordinateFormatter
  • LatitudeLongitudeFormat
  • UtmConversionMode

Tags

convert, coordinate, decimal degrees, degree minutes seconds, format, latitude, longitude, USNG, UTM

Sample Code

FormatCoordinates.qmlFormatCoordinates.cppFormatCoordinates.h
                                                                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
// [WriteFile Name=FormatCoordinates, Category=Geometry]
// [Legal]
// Copyright 2017 Esri.

// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// http://www.apache.org/licenses/LICENSE-2.0

// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// [Legal]

import QtQuick 2.6
import QtQuick.Controls 2.2
import QtQuick.Layouts 1.3
import Esri.Samples 1.0

Item {
    clip: true

    readonly property int fontPixelSize: 14
    property string labelSuffix: ":  "

    FormatCoordinatesSample {
        id: model
        mapView: view
    }

    Rectangle {
        anchors.fill: parent

        GridLayout {
            columns: 2
            anchors.fill: parent

            MapView {
                id: view
                Layout.fillWidth: true
                Layout.fillHeight: true
                Layout.columnSpan: 2
            }

            Text {
                id: labelDD
                font.pixelSize: fontPixelSize
                Layout.margins: 5
                horizontalAlignment: Text.AlignRight
                text: model.strDecimalDegrees + labelSuffix
            }

            TextField {
                id: textDD
                font.pixelSize: fontPixelSize
                text: model.coordinatesInDD.length === 0 ? "invalid point" : model.coordinatesInDD
                selectByMouse: true
                Layout.fillWidth: true
                Layout.margins: 5
                onAccepted: {
                    model.handleTextUpdate(model.strDecimalDegrees, text);
                }
            }

            Text {
                id: labelDMS
                font.pixelSize: fontPixelSize
                Layout.margins: 5
                horizontalAlignment: Text.AlignRight
                text: model.strDegreesMinutesSeconds + labelSuffix
            }

            TextField {
                id: textDMS
                font.pixelSize: fontPixelSize
                selectByMouse: true
                Layout.margins: 5
                text: model.coordinatesInDMS.length === 0 ? "invalid point" : model.coordinatesInDMS
                Layout.fillWidth: true
                onAccepted: {
                    model.handleTextUpdate(model.strDegreesMinutesSeconds, text);
                }
            }

            Text {
                id: labelUtm
                font.pixelSize: fontPixelSize
                Layout.margins: 5
                horizontalAlignment: Text.AlignRight
                text: model.strUtm + labelSuffix
            }

            TextField {
                id: textUtm
                font.pixelSize: fontPixelSize
                text: model.coordinatesInUtm.length === 0 ? "invalid point" : model.coordinatesInUtm
                selectByMouse: true
                Layout.fillWidth: true
                Layout.margins: 5
                onAccepted: {
                    model.handleTextUpdate(model.strUtm, text);
                }
            }

            Text {
                id: labelUsng
                font.pixelSize: fontPixelSize
                Layout.margins: 5
                horizontalAlignment: Text.AlignRight
                text: model.strUsng + labelSuffix
            }

            TextField {
                id: textUsng
                font.pixelSize: fontPixelSize
                text: model.coordinatesInUsng.length === 0 ? "invalid point" : model.coordinatesInUsng
                selectByMouse: true
                Layout.fillWidth: true
                Layout.margins: 5
                onAccepted: {
                    model.handleTextUpdate(model.strUsng, text);
                }
            }
        }
    }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.