geolocation-coordinate

ES6 class to simplify formatting of Geolocation coordinates

Usage no npm install needed!

<script type="module">
  import geolocationCoordinate from 'https://cdn.skypack.dev/geolocation-coordinate';
</script>

README

geolocation-coordinate NPM version

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