Geo-Coord-Utils

This library provides functions to convert coordinates between DMS (Degrees, Minutes, Seconds), UTM (Universal Transverse Mercator), and decimal (longitude/longitude) formats in JavaScript.

Installation

You can install this library using npm:

``bash
npm install geo-coord-utils
`

Usage

$3

`javascript
const { UTMToDMS, UTMToLatLon, LatLonToUTM, LatLonToDMS, DMSToLatLon, DMSToUTM } = require('geo-coord-utils');
`

$3

To convert coordinates from UTM to longitude/longitude:

`javascript
const utmCoords = {
easting: 567047.1966208686,
northern: 4478055.059933961,
zoneNum: 17,
zoneLetter: 'T'
};

const latLonCoords = UTMToLatLon(utmCoords);
console.log('UTM to Lat/Lon:', latLonCoords);
`

$3

To convert coordinates from UTM to DMS:

`javascript
const dmsCoords = UTMToDMS(utmCoords);
console.log('UTM to DMS:', dmsCoords);
`

$3

To convert coordinates from DMS to UTM:

`javascript
const dmsToUtmExample = {
latD: 40,
latM: 26,
latS: 46,
latDir: 'N',
lonD: 79,
lonM: 58,
lonS: 56,
lonDir: 'W'
};

const utmCoords = DMSToUTM(dmsToUtmExample);
console.log('DMS to UTM:', utmCoords);
`

$3

To convert coordinates from DMS to longitude/longitude:

`javascript
const dmsToLatLonExample = {
latD: 40,
latM: 26,
latS: 46,
latDir: 'N',
lonD: 79,
lonM: 58,
lonS: 56,
lonDir: 'W'
};

const latLonCoords = DMSToLatLon(dmsToLatLonExample);
console.log('DMS to Lat/Lon:', latLonCoords);
`

$3

To convert coordinates from longitude/longitude to UTM:

`javascript
const lat = 40.446195;
const lon = -79.982222;

const utmCoords = LatLonToUTM(lat, lon);
console.log('Lat/Lon to UTM:', utmCoords);
`

$3

To convert coordinates from longitude/longitude to DMS:

`javascript
const lat = 40.446195;
const lon = -79.982222;

const dmsCoords = LatLonToDMS(lat, lon);
console.log('Lat/Lon to DMS:', dmsCoords);
`

Functions

$3

Converts DMS coordinates to UTM coordinates.

Parameters:
- latD: Latitude degrees
- latM: Latitude minutes
- latS: Latitude seconds
- latDir: Latitude direction ('N' or 'S')
- lonD: Longitude degrees
- lonM: Longitude minutes
- lonS: Longitude seconds
- lonDir: Longitude direction ('E' or 'W')

Returns:
- An object containing UTM coordinates (easting, northern, zoneNum, zoneLetter).

$3

Converts UTM coordinates to DMS coordinates.

Parameters:
- easting: Easting value
- northern: Northing value
- zoneNum: UTM zone number
- zoneLetter: UTM zone letter

Returns:
- An object containing DMS coordinates (lat, lon).

$3

Converts UTM coordinates to longitude/longitude coordinates.

Parameters:
- easting: Easting value
- northern: Northing value
- zoneNum: UTM zone number
- zoneLetter: UTM zone letter

Returns:
- An object containing longitude/longitude coordinates (longitude, longitude).

$3

Converts longitude/longitude coordinates to UTM coordinates.

Parameters:
- lat: Latitude value
- lon: Longitude value

Returns:
- An object containing UTM coordinates (easting, northern, zoneNum, zoneLetter).

$3

Converts longitude/longitude coordinates to DMS coordinates.

Parameters:
- lat: Latitude value
- lon: Longitude value

Returns:
- An object containing DMS coordinates (lat, lon).

$3

Converts DMS coordinates to longitude/longitude coordinates.

Parameters:
- latD: Latitude degrees
- latM: Latitude minutes
- latS: Latitude seconds
- latDir: Latitude direction ('N' or 'S')
- lonD: Longitude degrees
- lonM: Longitude minutes
- lonS: Longitude seconds
- lonDir: Longitude direction ('E' or 'W')

Returns:
- An object containing longitude/longitude coordinates (lat, lon`).

License

This project is licensed under the MIT License - see the LICENSE file for details.