This library provides classes and functions for the computation of geometric data on the surface of the Earth. Code ported from the Google Maps Javascript API v3 and tubalmartin/spherical-geometry.
Branch: master
Clone or download
Pull request Compare This branch is 48 commits ahead of tubalmartin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Switch to jest for tests Dec 12, 2018
images Add logo and downloads badge Dec 30, 2018
src
test Implement computeOffsetOrigin Feb 1, 2019
.editorconfig Add prettier Dec 12, 2018
.gitignore Add prettier Dec 12, 2018
.travis.yml
LICENSE Add typings Dec 12, 2018
README.md Implement computeOffsetOrigin Feb 1, 2019
index.d.ts Implement computeOffsetOrigin Feb 1, 2019
package-lock.json [Security] Bump handlebars from 4.0.12 to 4.1.0 Feb 14, 2019
package.json Implement computeOffsetOrigin Feb 1, 2019
rollup.config.js Switch to jest for tests Dec 12, 2018
tsconfig.json

README.md

Spherical Geometry Library · Build Status npm Downloads

This library provides classes and functions for the computation of geometric data on the surface of the Earth.

This library ports a small but useful subset of classes from the Google Maps Javascript API version 3, to use as a separate module or in node. I also try to have readable code, so that you can understand what calculations are being made.

How to use

import * as geometry from 'spherical-geometry-js';

Or import individual modules

import { computeArea } from 'spherical-geometry-js';
import computeArea from 'spherical-geometry-js/compute-area';

Notes:

  • The API is nearly identical to the Google Maps Javascript API.
  • Functions automatically convert coordinate objects into LatLngs. See convertLatLng for more details.
  • All computed lengths are returned in meters.

API

The full API of the library is described in the typings file.

Classes and libraries ported from the Google Maps Javascript API:

This module tries to maintain full API compatibility with Google Maps so it can be used as a drop-in replacement.

For convenience, LatLng includes some extra methods.

const latlng = new LatLng(123, 56);
// Alias getters for longitude and latitude

latlng.x === latlng.lng();
latlng.y === latlng.lat();

latlng[0] === latlng.lng();
latlng[1] === latlng.lat();
import { equalLatLngs } from 'spherical-geometry-js';

equalLatLngs(latlng1, latlng2) === latlng1.equals(latlng2);

convertLatLng(like) ⇒ LatLng

import { LatLng, convertLatLng } from 'spherical-geometry-js';

convertLatLng({ lat: 123, lng: 56 }).equals(new LatLng(123, 56));
convertLatLng([56, 123]).equals(new LatLng(123, 56));
convertLatLng({ x: 56, y: 123 }).equals(new LatLng(123, 56));

Helper function that tries to convert and object into a LatLng. Tries a few different methods:

  1. If instanceof LatLng, clone the object and return it.

  2. If it has lat and lng properties...

    2a. if the properties are functions (like Google LatLngs), use the lat() and lng() values as latitude and longitude.

    2b. otherwise get lat and lng, parse them as floats and use them.

  3. If it has lat and long properties, parse them as floats use them.

  4. If it has number values for 0 and 1 (aka an array of two numbers), use 1 as latitude and 0 as longitude.

  5. If it has x and y properties, try using y as latitude and x and longitude.