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.Unit enum contains all supported units:

import haversine

print(tuple(haversine.Unit))

outputs

(<Unit.FEET: 'ft'>, <Unit.INCHES: 'in'>, <Unit.KILOMETERS: 'km'>, 
 <Unit.METERS: 'm'>, <Unit.MILES: 'mi'>, <Unit.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.1.tar.gz (3.1 kB view details)

Uploaded Source

Built Distribution

haversine-2.1.1-py2.py3-none-any.whl (4.5 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: haversine-2.1.1.tar.gz
  • Upload date:
  • Size: 3.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.3

File hashes

Hashes for haversine-2.1.1.tar.gz
Algorithm Hash digest
SHA256 60cf0c8c3ba3692c37d0b5fa2d307f74b19cf67bd1dd5f21cb4c1d637a82a615
MD5 7873520df81cecb7f3ee5034efb52c3e
BLAKE2b-256 ad189d504f2dc872ed7b5c1f8389bc5c8c069d180489f12209fa91d34fdc1516

See more details on using hashes here.

File details

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

File metadata

  • Download URL: haversine-2.1.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.5.3

File hashes

Hashes for haversine-2.1.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 53c4769b4b45edfbff6a4149989b4b31724d928317cddeb8da680db4a77d1f54
MD5 f28c972d753a51c21b5a4344f6f97ea6
BLAKE2b-256 e3721a7b859168b618384133f53f23fa54965c5f79d749b50ec1b66fd6a62759

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