Description
The gis-distance library allows you to calculate geographic distance between two points using the formula of your choice.
Installation
gem install gis-distance
Adding the trusted cert
gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/gis-distance/main/certs/djberg96_pub.pem)
Synopsis
require 'gis/distance' # or 'gis-distance'
# New York to Los Angeles
gis = GIS::Distance.new(40.47, 73.58, 34.3, 118.15)
# Set the formula of your choice
gis.formula = 'cosines'
gis.formula = 'haversine'
gis.formula = 'vincenty'
p gis.distance # Kilometers
p gis.distance.mi # Miles
Available Formulas
- haversine (https://en.wikipedia.org/wiki/Haversine_formula)
- cosine (https://en.wikipedia.org/wiki/Law_of_cosines)
- vincenty (https://en.wikipedia.org/wiki/Vincenty%27s_formulae)
See Also
http://en.wikipedia.org/wiki/Earth_radius
Miscellaneous
Ruby 2.x was dropped from the test matrix as of version 1.2 because of incompatibility with bundler. This library should still work fine with older versions of Ruby, but you should strongly consider upgrading at this point since Ruby 2.x is now EOL.
License
Artistic-2.0
Authors
- Daniel Berger
- Ardith Falkner