# geopoint

> Representation of a geographic point for node.js and the browser

Latest version **1.0.1** (published 2013-08-26) · 0 weekly downloads

## Install

```sh
npm install geopoint
pnpm add geopoint
yarn add geopoint
bun add geopoint
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2013-08-26 |
| First published | 2013-08-26 |
| Weekly downloads | 0 |
| TypeScript types | separate (@types/geopoint) |
| Module format | CommonJS |
| Node | >= 0.8.0 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 79 |
| Author | David Wood |
| Maintainers | davidwood |
| Keywords | geolocation, point, distance, bounding box, radius |

## Links

- npm: https://www.npmjs.com/package/geopoint
- Repository: http://github.com/davidwood/node-geopoint
- Issues: https://github.com/davidwood/node-geopoint/issues
- npm.io page: https://npm.io/package/geopoint

## Recent versions

- 1.0.1 (latest) — 2013-08-26
- 1.0.0 — 2013-08-26

## README

# Geographic Point

GeoPoint represents a geographic point for node.js and the browser, and provides distance between points and radius bounding box calculations.

## Installation

    npm install geopoint 

## Usage

```
var GeoPoint = require('geopoint'),
    statueOfLiberty = new GeoPoint(40.689604, -74.04455);
```

## Constructor options

* `latitude`: Latitude
* `longitude`: Longitude
* `inRadians`: `true` if the latitude and longitude are in radians, defaults to `false`

## Methods

* `.latitude(inRadians)`: Return the point's latitude. By default, the latitude is in degrees, unless `inRadians` is `true`
* `.longitude(inRadians)`: Return the point's longitude. By default, the longitude is in degrees, unless `inRadians` is `true`
* `.distanceTo(point, inKilometers)`: Calculate the distance to another `GeoPoint` instance. By default, the distance is calculated in miles, unless `inKilometers` is `true`
* `.boundingCoordinates(distance, radius, inKilometers)`: Calculates the bounding coordinates of `distance` from the point and returns an array with the SW and NE points of the bounding box . If `radius` is not provided, the radius of the Earth will be used. The distance is calculated in miles unless `inKilometers` is `true`

## Static Methods

* `GeoPoint.degreesToRadians(value)`: Converts `value` in degrees to radians
* `GeoPoint.radiansToDegrees(value)`: Converts `value` in radians to degrees
* `GeoPoint.milesToKilometers(value)`: Converts `value` in miles to kilometers
* `GeoPoint.kilometersToMiles(value)`: Converts `value` in kilometers to miles

## Browser Support

The `GeoPoint` constructor is exposed via `window.GeoPoint`.

## Running Tests

Cachetree tests require [Mocha](http://visionmedia.github.com/mocha/) and can be run with either `npm test`.  You can specify Mocha options, such as the reporter, by adding a [mocha.opts](http://visionmedia.github.com/mocha/#mocha.opts) file, which is ignored by git, to the `test` directory.
 
# Credits

This library is derived from the code presented in [Finding Points Within a Distance of a Latitude/Longitude Using Bounding Coordinates](http://janmatuschek.de/LatitudeLongitudeBoundingCoordinates) by [Jan Philip Matuschek](http://janmatuschek.de/Contact).

---
_Source: https://npm.io/package/geopoint · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._