Skip to main content

Calculate the distance between 2 points on Earth.

Project description

Haversine Build Status

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

haversine-2.1.0.tar.gz (3.1 kB view details)

Uploaded Source

Built Distribution

haversine-2.1.0-py2.py3-none-any.whl (4.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file haversine-2.1.0.tar.gz.

File metadata

  • Download URL: haversine-2.1.0.tar.gz
  • Upload date:
  • Size: 3.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/2.7.13

File hashes

Hashes for haversine-2.1.0.tar.gz
Algorithm Hash digest
SHA256 e70673bbebfdea217261fd78d63a5b736aa909076aacdf201d435ed23a38df71
MD5 76bb99ed66f03946cc6661447d121805
BLAKE2b-256 6c08367e7bdd6eb6fd49eb37755c49cbd4156ff87afdcb7eaff6fe0de167c367

See more details on using hashes here.

File details

Details for the file haversine-2.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: haversine-2.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/2.7.13

File hashes

Hashes for haversine-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ed3756c1ff6a72cd24a1af4a5f32465184506c4a30c040702555080be1aca8ce
MD5 cbbb8d8d0468f463ddaa401628d66959
BLAKE2b-256 58badeee1c08d73da075ff296229f9672c46ed3ac804dd772c02db52299d3e52

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page