0.1.5 • Published 4 years ago
geolocation-coordinate v0.1.5
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