geokit

geokit

An assortment of geolocation related tools, all packaged in one easy to use kit.

Methods

Geokit.distance(start: LatLngLiteral, end: LatLngLiteral, unit?: string): number

Static method which returns the distance, in kilometers, between start and end.

start and end must be LatLngLiterals { lat: 0, lng: 0 }.

There exists an optional third argument, where if the string 'miles' is inputted, the result returned will be in miles rather than kilometers.

import { Geokit, LatLngLiteral } from 'geokit';

const start: LatLngLiteral = { lat: 40.7128,  lng: -74.0060 };
const end: LatLngLiteral = { lat: 37.7749,  lng: -122.4194 };

const distance: number = Geokit.distance(location1, location2, 'miles');  // distance === 2568.4458439997047

Geokit.hash(coordinates: LatLngLiteral, precision?: number): string

Static method which generates the geohash of a point.

coordinates must be LatLngLiterals { lat: 0, lng: 0 }.

There exists an optional second argument of precision, where the hash produced will be as many characters as the number inputted. It defaults to 10.

import { Geokit, LatLngLiteral } from 'geokit';

const coordinates: LatLngLiteral = { lat: 41.3083,  lng: -72.9279 };

const hash: string = Geokit.hash(coordinates);  // hash === 'drk4urzw2c'

Geokit.decodeHash(hash: string): LatLngLiteral

Static method which decodes geohash into its Latitude and Longitude as a LatLngLiteral.

import { Geokit, LatLngLiteral } from 'geokit';

const hash: string = 'r3gx2f77b';

const coordinates: LatLngLiteral = Geokit.decodeHash(hash);  // coordinates === { lat: -33.86881113052368,  lng: 151.2093186378479 }

Changelog

0.1.4 (2019-06-17)

Build System / Dependencies

• deps-dev:
  • bump firebase-tools from 5.0.1 to 6.11.0 (c773ba86)
  • bump firebase-tools from 5.0.1 to 6.11.0 (2e1fbd21)
  • bump rollup-plugin-commonjs from 9.2.0 to 9.3.4 (f157d89b)
  • bump @types/mocha from 5.2.5 to 5.2.7 (cf81bb70)
  • bump rollup-plugin-uglify from 6.0.0 to 6.0.2 (a94fcaf5)
  • bump rollup-plugin-commonjs from 9.2.0 to 9.3.4 (7d865520)
  • bump rollup-plugin-uglify from 6.0.0 to 6.0.2 (80a7392b)
  • bump @types/mocha from 5.2.5 to 5.2.7 (a35476bc)
  • bump mocha from 5.2.0 to 6.1.4 (33ad2fea)
  • bump mocha from 5.2.0 to 6.1.4 (25321c20)
• deps:
  • [security] bump axios from 0.18.0 to 0.18.1 (c52e02ef)
  • [security] bump axios from 0.18.0 to 0.18.1 (0034907e)
• rollup: call copy only once during rollup build (4b9db1a6)

Chores

• update dependencies (892c678e)