Skip to content

Commit 478b155

Browse files
committed
added utm and dms field calculator functions
1 parent f7083d1 commit 478b155

File tree

3 files changed

+160
-36
lines changed

3 files changed

+160
-36
lines changed

index.html

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -37,21 +37,21 @@
3737
</head>
3838
<body>
3939
<h1>Lat Lon Tools Plugin</h1>
40-
<p><strong><em>Lat Lon Tools</em></strong> makes it easy to capture, zoom to coordinates, convert coordinates in text fields into new point layers, export point geometry into text fields, and interact with other on-line mapping tools. It adds MGRS, Standard UTM, Geohash, and Plus Code coordinate support to QGIS. When working with <strong>Google Earth*<em>, <strong>Google Maps</strong> or other on-line mapping tools, coordinates are specified in the order of 'Latitude, Longitude'. By default </em></strong>Lat Lon Tools<strong><em> uses the standard Google Map format, but is very flexible and can use virtually any projection and coordinate format for input and output. The following tools are available in </em></strong>Lat Lon Tools***.</p>
40+
<p><strong><em>Lat Lon Tools</em></strong> makes it easy to capture, zoom to coordinates, convert coordinates in text fields into new point layers, export point geometry into text fields, and interact with other on-line mapping tools. It adds MGRS, Standard UTM, Geohash, and Plus Code coordinate support to QGIS. When working with <strong>Google Earth</strong>, <strong>Google Maps</strong> or other on-line mapping tools, coordinates are specified in the order of 'Latitude, Longitude'. By default <strong><em>Lat Lon Tools</em></strong> uses the standard Google Map format, but is very flexible and can use virtually any projection and coordinate format for input and output. The following tools are available in <strong><em>Lat Lon Tools</em></strong>.</p>
4141
<div style="text-align:center"><img src="doc/menu.jpg" alt="Lat Lon Tools Plugin"></div>
4242

4343
<p>Some of the functions can be accessed from the <strong><em>Lat Lon Tools</em></strong> toolbar. If for some reason the toolbar is missing, select the menu item <strong><em>View-&gt;Toolbars</em></strong> and make sure <strong><em>Lat Lon Tools Toolbar</em></strong> is enabled. The conversion algorithms can be run from the QGIS Processing Toolbox.</p>
4444
<div style="text-align:center"><img src="doc/toolbar.jpg" alt="Lat Lon Tools toolbar"></div>
4545

4646
<ul>
4747
<li>
48-
<p><img src="images/copyicon.png" alt="Copy/Display coordinate"> <strong><em>Copy/Display Coordinate</em></strong> - This captures coordinates onto the clipboard when the user clicks on the map, using the standard Google Map format or a format specified in <strong><em>Settings</em></strong>. If the user specifies a <strong>Tab*<em> separator, then the coordinate can be pasted into a spreadsheet in separate columns. While this tool is selected, the coordinate the mouse is over is shown in the lower left-hand corner either in <strong>decimal degrees</strong>, <strong>DMS</strong>, <strong>Degrees Minutes</strong>, <strong>MGRS</strong>, <strong>Standard UTM</strong>, <strong>Plus Codes</strong>, <strong>Geohash</strong>, <strong>Maidenhead Grid Locator</strong>, <strong>WKT POINT</strong>, or <strong>GeoJSON</strong> notation depending on the <strong>Settings</strong>. By default it uses the geographic Latitude and Longitude to snapshot the coordinate, but this can be configured in <strong>Settings</strong> to use the project CRS or any other projection desired. See the <strong>Settings</strong> section for more details on the all the possibilities. An additional prefix or suffix can be added to the coordinate and is configured in <strong>Settings</strong>. If snapping is enabled under QGIS </em></strong>Project-&gt;Snapping Options...*<em><em> menu, then </em>Copy/Display Coordinate</em> will snap to any close vector vertices according to the parameters set in the snapping options.</p>
48+
<p><img src="images/copyicon.png" alt="Copy/Display coordinate"> <strong><em>Copy/Display Coordinate</em></strong> - This captures coordinates onto the clipboard when the user clicks on the map, using the standard Google Map format or a format specified in <strong><em>Settings</em></strong>. If the user specifies a <strong>Tab</strong> separator, then the coordinate can be pasted into a spreadsheet in separate columns. While this tool is selected, the coordinate the mouse is over is shown in the lower left-hand corner either in <strong>decimal degrees</strong>, <strong>DMS</strong>, <strong>Degrees Minutes</strong>, <strong>MGRS</strong>, <strong>Standard UTM</strong>, <strong>Plus Codes</strong>, <strong>Geohash</strong>, <strong>Maidenhead Grid Locator</strong>, <strong>WKT POINT</strong>, or <strong>GeoJSON</strong> notation depending on the <strong>Settings</strong>. By default it uses the geographic Latitude and Longitude to snapshot the coordinate, but this can be configured in <strong>Settings</strong> to use the project CRS or any other projection desired. See the <strong>Settings</strong> section for more details on the all the possibilities. An additional prefix or suffix can be added to the coordinate and is configured in <strong>Settings</strong>. If snapping is enabled under QGIS <strong><em>Project-&gt;Snapping Options...</em></strong> menu, then <em>Copy/Display Coordinate</em> will snap to any close vector vertices according to the parameters set in the snapping options.</p>
4949
</li>
5050
<li>
5151
<p><img src="images/mapicon.png" alt="Show in External Map"> <strong><em>Show in External Map</em></strong> - With this tool, the user can click on the QGIS map which launches an external browser and displays the location on an external map. The left and right mouse buttons can be configured to show different maps. Currently Open Street Map, Google Maps, MapQuest, Mapillary, Open Street Map iD Editor, and Bing Maps are supported along with Google Earth if it is installed on the system. The desired map that is displayed can be configured in <strong><em>Settings</em></strong> along with additonal user added map services. A temporary marker can be displayed on the map at the location clicked on. To turn this on go to <strong>Settings</strong>. If snapping is enabled, then the clicked location will snap to any close vector vertices according to the parameters set in the snapping options.</p>
5252
</li>
5353
<li>
54-
<p><img src="images/zoomicon.png" alt="Zoom-to"> <strong><em>Zoom to Coordinate</em></strong> - With this tool, type or paste a coordinate into the text area and hit <strong>Enter*<em>. QGIS centers the map on the coordinate, highlights the location and creates a temporary marker at the location. The marker can be removed with the <img src="doc/cleartool.jpg" alt="Clear marker"> button. If the default <strong>WGS 84</strong> (EPSG:4326 - latitude/longitude) coordinate system is specified, </em></strong>Zoom to Coordinate<strong><em> can interpret </em>*decimal degrees</strong>, <strong>DMS*<em>, <strong>WKT POINT</strong>, <strong>Standard UTM</strong>, <strong>MGRS</strong>, <strong>Plus Codes</strong>, or <strong>GeoJSON</strong> coordinates. It can also zoom to <strong>Geohash</strong> coordinates, amateur radio Maidenhead grid coordinates, or any other projection when configured in <strong>Settings</strong>. The </em></strong>Coordinate Order<strong><em> in </em></strong>Settings<strong><em> dictates whether the order is latitude followed by longitude (Y,X) or longitude followed by latitude (X,Y). By default the order is "Latitude, Longitude", the format used by Google Maps. Pressing the <img src="doc/zoomtool.jpg" alt="Zoom button"> also causes QGIS to zoom to that location. The behavior and coordinate types that are interpreted can be configured by pressing the </em>*Settings</strong> button <img src="doc/settings.png">.<br /><div style="text-align:center"><img src="doc/zoomto.jpg" alt="Zoom to Latitude, Longitude"></div><br />The following are acceptable coordinate formats when the <strong><em>Settings</em></strong> <strong>Zoom to Coordinate Type*<em> is set to </em></strong>WGS 84 (Latitude &amp; Longitude)***. When the letters "N, S, E, W" are used, then the coordinate order is not important. These letters can be used before or after the coordinates. As long as the coordinate is understandable, punctuation, spaces, and &deg; ' " are optional. In these examples "d" represents degree digits, "m" minutes, and "s" seconds. Here are some example input formats:</p>
54+
<p><img src="images/zoomicon.png" alt="Zoom-to"> <strong><em>Zoom to Coordinate</em></strong> - With this tool, type or paste a coordinate into the text area and hit <strong>Enter</strong>. QGIS centers the map on the coordinate, highlights the location and creates a temporary marker at the location. The marker can be removed with the <img src="doc/cleartool.jpg" alt="Clear marker"> button. If the default <strong>WGS 84</strong> (EPSG:4326 - latitude/longitude) coordinate system is specified, <strong><em>Zoom to Coordinate</em></strong> can interpret <strong>decimal degrees</strong>, <strong>DMS</strong>, <strong>WKT POINT</strong>, <strong>Standard UTM</strong>, <strong>MGRS</strong>, <strong>Plus Codes</strong>, or <strong>GeoJSON</strong> coordinates. It can also zoom to <strong>Geohash</strong> coordinates, amateur radio Maidenhead grid coordinates, or any other projection when configured in <strong>Settings</strong>. The <strong><em>Coordinate Order</em></strong> in <strong><em>Settings</em></strong> dictates whether the order is latitude followed by longitude (Y,X) or longitude followed by latitude (X,Y). By default the order is "Latitude, Longitude", the format used by Google Maps. Pressing the <img src="doc/zoomtool.jpg" alt="Zoom button"> also causes QGIS to zoom to that location. The behavior and coordinate types that are interpreted can be configured by pressing the <strong>Settings</strong> button <img src="doc/settings.png">.<br /><div style="text-align:center"><img src="doc/zoomto.jpg" alt="Zoom to Latitude, Longitude"></div><br />The following are acceptable coordinate formats when the <strong><em>Settings</em></strong> <strong>Zoom to Coordinate Type</strong> is set to <strong><em>WGS 84 (Latitude &amp; Longitude)</em></strong>. When the letters "N, S, E, W" are used, then the coordinate order is not important. These letters can be used before or after the coordinates. As long as the coordinate is understandable, punctuation, spaces, and &deg; ' " are optional. In these examples "d" represents degree digits, "m" minutes, and "s" seconds. Here are some example input formats:</p>
5555
<ul>
5656
<li>Decimal Degree: 38.959390&deg;, -95.265483&deg; / 38.959390, -95.265483 / 38.959390N, 95.265483 W (d.dddd, d.dddd)</li>
5757
<li>Degree, Minute: 38&deg; 57.5634'N 95&deg; 15.92890'W (d m.mmmm, d m.mmmm)</li>
@@ -62,10 +62,10 @@ <h1>Lat Lon Tools Plugin</h1>
6262
<li>WKT: POINT(-95.265483 38.959390)</li>
6363
<li>GeoJSON: {"type": "Point","coordinates": [-95.265483,38.959390]}</li>
6464
<li>Standard WGS84 UTM: 15N 303704.9 4314710.9 (zone easting northing)</li>
65-
<li>Example MGRS coordinate when <strong>Zoom to Coordinate Type*<em> is set to </em></strong>MGRS***: 15S UD 03704 14710</li>
66-
<li>Example Plus Code coordinate when <strong>Zoom to Coordinate Type*<em> is set to </em></strong>Plus Codes***: 86C6XP5M+QR</li>
67-
<li>Example Geohash coordinate when <strong>Zoom to Coordinate Type*<em> is set to </em></strong>Geohash***: 9yum8hmfckem</li>
68-
<li>Example Amateur Radio Maidenhead coordinate when <strong>Zoom to Coordinate Type*<em> is set to </em></strong>Maidenhead Grid Locator***: EM28ix (Note that the center point of the grid is the location that is returned.)</li>
65+
<li>Example MGRS coordinate when <strong>Zoom to Coordinate Type</strong> is set to <strong><em>MGRS</em></strong>: 15S UD 03704 14710</li>
66+
<li>Example Plus Code coordinate when <strong>Zoom to Coordinate Type</strong> is set to <strong><em>Plus Codes</em></strong>: 86C6XP5M+QR</li>
67+
<li>Example Geohash coordinate when <strong>Zoom to Coordinate Type</strong> is set to <strong><em>Geohash</em></strong>: 9yum8hmfckem</li>
68+
<li>Example Amateur Radio Maidenhead coordinate when <strong>Zoom to Coordinate Type</strong> is set to <strong><em>Maidenhead Grid Locator</em></strong>: EM28ix (Note that the center point of the grid is the location that is returned.)</li>
6969
</ul>
7070
</li>
7171
<li>
@@ -79,14 +79,14 @@ <h1>Lat Lon Tools Plugin</h1>
7979
<li><strong>"plus codes[,label,data1,...,data10]"</strong></li>
8080
<li><strong>"standard utm[,label,data1,...,data10]"</strong></li>
8181
</ul>
82-
<p>When the user clicks on a location in the list, QGIS centers the map on the location and highlights it. Double clicking on a <strong>Label*<em> or <strong>Data</strong> cell allows the text to be edited. By default the <strong>Data</strong> fields will not be visible, but can be added from </em></strong>Settings<strong><em>. More than one location can be selected by clicking on the first point and then Shift-Click to select a range or using Ctrl-Click to add additional selected items. Markers for all selected items will be displayed. The following are additional functions.
83-
* <img src="doc/open.png" alt="Open"> </em></strong>Open Location List<strong><em> reads in a set of coordinates that are comma separated with an optional label. There should only be one location per line and formatted as </em>*"latitude,longitude,label,data1,...,data10"</strong> or simply <strong>"latitude,longitude"*<em>.
84-
* <img src="doc/save.png" alt="Save"> </em></strong>Save Location List<strong><em> saves all of the zoom-to entries in a .csv file, formatted as </em>*"latitude,longitude,label,data1,...,data10"</strong>.
82+
<p>When the user clicks on a location in the list, QGIS centers the map on the location and highlights it. Double clicking on a <strong>Label</strong> or <strong>Data</strong> cell allows the text to be edited. By default the <strong>Data</strong> fields will not be visible, but can be added from <strong><em>Settings</em></strong>. More than one location can be selected by clicking on the first point and then Shift-Click to select a range or using Ctrl-Click to add additional selected items. Markers for all selected items will be displayed. The following are additional functions.
83+
* <img src="doc/open.png" alt="Open"> <strong><em>Open Location List</em></strong> reads in a set of coordinates that are comma separated with an optional label. There should only be one location per line and formatted as <strong>"latitude,longitude,label,data1,...,data10"</strong> or simply <strong>"latitude,longitude"</strong>.
84+
* <img src="doc/save.png" alt="Save"> <strong><em>Save Location List</em></strong> saves all of the zoom-to entries in a .csv file, formatted as <strong>"latitude,longitude,label,data1,...,data10"</strong>.
8585
* <img src="doc/delete.png" alt="Delete"> <strong><em>Delete Selected Location</em></strong> removes all selected locations.
8686
* <img src="doc/deleteall.png" alt="Clear All"> <strong><em>Clear All Locations</em></strong> clears the list of all locations.
8787
* <img src="doc/newlayer.png" alt="New"> <strong><em>Create Vector Layer From Location List</em></strong> creates a memory layer out of the zoom-to locations.
88-
* <img src="doc/settings.png" alt="Settings"> <strong><em>Show Style Settings</em></strong> chooses a style for the layer created from the create layer button. This displays the <strong>Settings*<em> dialog box.
89-
* <img src="images/coordinate_capture.png" alt="Start capture"> </em></strong>Start Capture*** enables the user to click on the map to capture coordinates directly to the list.</p>
88+
* <img src="doc/settings.png" alt="Settings"> <strong><em>Show Style Settings</em></strong> chooses a style for the layer created from the create layer button. This displays the <strong>Settings</strong> dialog box.
89+
* <img src="images/coordinate_capture.png" alt="Start capture"> <strong><em>Start Capture</em></strong> enables the user to click on the map to capture coordinates directly to the list.</p>
9090
<p><div style="text-align:center"><img src="doc/multizoom.jpg" alt="Multi-location Zoom"></div></p>
9191
<ul>
9292
<li>The <strong><em>Show all markers</em></strong> displays markers of all locations.</li>
@@ -173,7 +173,7 @@ <h3>Capture &amp; Display Settings</h3>
173173
<ul>
174174
<li><strong>WGS 84 (Latitude &amp; Longitude)</strong> - This captures the coordinates as a latitude and longitude regardless of what the project CRS is set to. This is the default setting.</li>
175175
<li><strong>Project CRS</strong> - This captures the coordinates using the project's specified CRS.</li>
176-
<li><strong>Custom CRS*<em> - The captures the coordinate in any coordinate reference system regardless of what the project CRS is set to. When this is selected, then the </em></strong>Custom CRS*** dialog box is activated allowing selection of any projection.</li>
176+
<li><strong>Custom CRS</strong> - The captures the coordinate in any coordinate reference system regardless of what the project CRS is set to. When this is selected, then the <strong><em>Custom CRS</em></strong> dialog box is activated allowing selection of any projection.</li>
177177
<li><strong>MGRS</strong> - This captures the coordinates in the <a href="https://en.wikipedia.org/wiki/Military_grid_reference_system">MGRS</a> format,</li>
178178
<li><strong>Plus Codes</strong> - This captures the coordinate in <a href="https://plus.codes/">Google Plus Codes</a> format.</li>
179179
<li><strong>Standard UTM</strong> - This has the form of '12N 417159.0 4515540.6'</li>
@@ -207,7 +207,7 @@ <h3>Capture &amp; Display Settings</h3>
207207
<li><strong>Comma Space</strong> - This is a comma followed by a space. </li>
208208
<li><strong>Tab</strong> - This useful if you are pasting the coordinates into two columns of a spreadsheet.</li>
209209
<li><strong>Space</strong></li>
210-
<li><strong>Other*<em> - With this selected, the contents of </em></strong>Other delimiter*** is used.</li>
210+
<li><strong>Other</strong> - With this selected, the contents of <strong><em>Other delimiter</em></strong> is used.</li>
211211
</ul>
212212
</li>
213213
<li><strong><em>DMS second precision</em></strong> - Used when formatting DMS coordinates and specifies the number of digits after the decimal.</li>
@@ -227,7 +227,7 @@ <h3>Zoom to Settings</h3>
227227

228228
<p>The <strong><em>Zoom to Latitude, Longitude</em></strong> tool accepts the following input coordinates as specified by <strong><em>Zoom to Coordinate Type</em></strong>:</p>
229229
<ul>
230-
<li><strong>WGS 84 (Latitude &amp; Longitude) / Auto Detect Format*<em> - Input coordinates can be either in decimal degrees, DMS degrees, WKT, or GeoJSON. For decimal and DMS formats, the order of the coordinates are determined by </em></strong>Zoom to Coordinate Order***. It also auto detects MGRS, Plus Codes, and Standard UTM formats so it is generally unnecessary to specify them separately.</li>
230+
<li><strong>WGS 84 (Latitude &amp; Longitude) / Auto Detect Format</strong> - Input coordinates can be either in decimal degrees, DMS degrees, WKT, or GeoJSON. For decimal and DMS formats, the order of the coordinates are determined by <strong><em>Zoom to Coordinate Order</em></strong>. It also auto detects MGRS, Plus Codes, and Standard UTM formats so it is generally unnecessary to specify them separately.</li>
231231
<li><strong>Project CRS</strong> - This accepts coordinates formatted in the CRS of the QGIS project. The numbers can be formatted in decimal or WKT notation.</li>
232232
<li><strong>Custom CRS</strong> - You can specify any CRS for the input coordinates and QGIS zooms to that coordinate regardless of the project CRS. The numbers can be formatted in decimal or WKT notation.</li>
233233
<li><strong>MGRS</strong> - This only accepts <a href="https://en.wikipedia.org/wiki/Military_grid_reference_system">MGRS</a> coordinates as input.</li>

0 commit comments

Comments
 (0)