geolocation-coordinate

ES6 class to simplify formatting of Geolocation coordinates

Installation

# NPM
npm install geolocation-coordinate --save

# Yarn
yarn add geolocation-coordinate

Getting Started

Creating a Coordinate instance from the browser Geolocation API

import { Coordinate } from 'geolocation-coordinate';


navigator.geolocation.getCurrentPosition((position) => {
  let { latitude, longitude } = position.coords;

  let latCoord = new Coordinate(latitude, 'latitude');
  let lngCoord = new Coordinate(longitude, 'longitude');

  latCoord.degrees; // 59.2349887712
  latCoord.minutes; // 14.09932627200007
  latCoord.seconds; // 5.959576320004203
  latCoord.cardinalCoordinate; // "North"

  latCoord.toString('dd'); // "59.235° North"
  latCoord.toString('ddm'); // "59° 14.099' North"
  latCoord.toString('dms'); // "59° 14' 6" North"
});

Documentation

Coordinate Class

Properties

Property Name	Type	Description
degrees	Float	Degrees as decimal
minutes	Float	Minutes as decimal
seconds	Float	Seconds as decimal
cardinalDirection	String	Direction (North, East, South, West)

Methods

toString([format])

Returns coordinate as a pretty string

Format options

Argument	Description	Example
Default	Returns string in decimal degrees	59.235° North
'dd'	Returns string in decimal degrees format	59.235° North
'ddm'	Returns string in degree decimal minute format	59° 14.099' North
'dms'	Returns string in degree minutes seconds	59° 14' 6" North

License

MIT License Copyright (c) 2018 Joel Colucci