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, Unit

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

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

haversine(lyon, paris, unit=Unit.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=Unit.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.2.tar.gz (3.1 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: haversine-2.1.2.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.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.5.3

File hashes

Hashes for haversine-2.1.2.tar.gz
Algorithm Hash digest
SHA256 d88d4218c52a5e91fbbdf286943d00595312e6183dd4b42248a39c7625782d8c
MD5 6f0d66bff2e0558ecd90a08cc6b62090
BLAKE2b-256 6863185226b1f050ee584d3569b155d7502aa5d1b89d7a1ae23be1987126dde4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: haversine-2.1.2-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.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.5.3

File hashes

Hashes for haversine-2.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 17c1d30a36ab8b81c2b890322846478624aa2bc23b80eaa879518812b6b5e24a
MD5 9a05862376de28049246852348c9a9b1
BLAKE2b-256 d72678d4fadc73b7e4c3543f9d5401892cb9a3f4202be789984826033922ec5a

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