https://github.com/im7mortal/utm

Bidirectional UTM-WGS84 converter for golang :earth_africa: :globe_with_meridians:
https://github.com/im7mortal/utm

geolocation latitude longitude utm

Last synced: 12 months ago
JSON representation

Bidirectional UTM-WGS84 converter for golang :earth_africa: :globe_with_meridians:

• Host: GitHub
• URL: https://github.com/im7mortal/utm
• Owner: im7mortal
• License: gpl-3.0
• Created: 2015-11-23T12:05:51.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-12-17T01:46:39.000Z (over 1 year ago)
• Last Synced: 2025-04-13T05:27:28.875Z (about 1 year ago)
• Topics: geolocation, latitude, longitude, utm
• Language: Go
• Homepage:
• Size: 92.8 KB
• Stars: 47
• Watchers: 4
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Build Status](https://travis-ci.org/im7mortal/UTM.svg)](https://travis-ci.org/im7mortal/UTM)

[![Coverage Status](https://coveralls.io/repos/im7mortal/UTM/badge.svg?branch=master)](https://coveralls.io/r/im7mortal/UTM?branch=master)

[![GoDoc](https://godoc.org/github.com/im7mortal/UTM?status.svg)](https://godoc.org/github.com/im7mortal/UTM)

UTM

===

Bidirectional UTM-WGS84 converter for golang. It use logic from [UTM python version](https://pypi.python.org/pypi/utm)

by Tobias Bieniek

Usage

-----

	go get github.com/im7mortal/UTM

Convert a latitude, longitude into an UTM coordinate

```go

    easting, northing, zoneNumber, zoneLetter, err := UTM.FromLatLon(40.71435, -74.00597, false)

```

Convert an UTM coordinate into a latitude, longitude.

```go

    latitude, longitude, err := UTM.ToLatLon(377486, 6296562, 30, "V")

```

Since the zone letter is not strictly needed for the conversion you may also

the ``northern`` parameter instead, which is a named parameter and can be set

to either ``true`` or ``false``. In this case you should define fields clearly(!).

You can't set ZoneLetter or northern both.

```go

    latitude, longitude, err := UTM.ToLatLon(377486, 6296562, 30, "", false)

```

The UTM coordinate system is explained on

this [Wikipedia page](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system)

Speed

-----

 Benchmark            | Amount of iterations | Average speed 

----------------------|----------------------|---------------

 ToLatLon             | 10000000             | 123 ns/op     

 ToLatLonWithNorthern | 10000000             | 121 ns/op     

 FromLatLon           | 20000000             | 80.6 ns/op    

> go test -bench=.

Full example

-----------

```go

package main

import (

	"github.com/im7mortal/UTM"

	"fmt"

)

func main() {

	easting, northing, zoneNumber, zoneLetter, err := UTM.FromLatLon(40.71435, -74.00597, false)

	if err != nil {

		panic(err.Error())

	}

	fmt.Println(

		fmt.Sprintf(

			"Easting: %d; Northing: %d; ZoneNumber: %d; ZoneLetter: %s;",

			easting,

			northing,

			zoneNumber,

			zoneLetter,

		))

	easting, northing, zoneNumber, zoneLetter, err = UTM.FromLatLon(40.71435, -74.00597, true)

	if err != nil {

		panic(err.Error())

	}

	fmt.Println(

		fmt.Sprintf(

			"Easting: %d; Northing: %d; ZoneNumber: %d; ZoneLetter: %s;",

			easting,

			northing,

			zoneNumber,

			zoneLetter,

		))

	latitude, longitude, err := UTM.ToLatLon(377486, 6296562, 30, "", true)

	fmt.Println(fmt.Sprintf("Latitude: %.5f; Longitude: %.5f;", latitude, longitude))

	latitude, longitude, err = UTM.ToLatLon(377486, 6296562, 30, "V")

	fmt.Println(fmt.Sprintf("Latitude: %.5f; Longitude: %.5f;", latitude, longitude))

}

```

Authors

-------

* Petr Lozhkin