Calculate the distance between 2 points on Earth.

# Haversine

Calculate the distance (in various units) between two points on Earth using their latitude and longitude.

## Example

### Calculate the distance between Lyon and Paris

```from haversine import haversine, Units

lyon = (45.7597, 4.8422) # (lat, lon)
paris = (48.8567, 2.3508)

haversine(lyon, paris)
>> 392.2172595594006  # in kilometers

haversine(lyon, paris, unit=Units.MILES)
>> 243.71201856934454  # in miles

# you can also use the string abbreviation for units:
haversine(lyon, paris, unit='mi')
>> 243.71201856934454  # in miles

haversine(lyon, paris, unit=Units.NAUTICAL_MILES)
>> 211.78037755311516  # in nautical miles
```

The `haversine.Units` enum contains all supported units:

```import haversine

print(tuple(haversine.Units))
```

outputs

```(<Units.FEET: 'ft'>, <Units.INCHES: 'in'>, <Units.KILOMETERS: 'km'>,
<Units.METERS: 'm'>, <Units.MILES: 'mi'>, <Units.NAUTICAL_MILES: 'nmi'>)
```

## Installation

```\$ pip install haversine
```

## Contributing

Clone the project.

Install pipenv.

Run `pipenv install --dev`

Launch test with `pipenv run pytest`