h1. Geo calculations
Geo Calculation library. Useful functions to add to your geo arsenal, fx when designing your own Geo library.
h2. Status update (June 14, 2011)
Extracted GeoUnits and GeoPoint into separate gems:
h2. Install
@require 'geo_calc'@
h3. Gemfile
Insert in your Gemfile:
@gem 'geo_calc'@
From command line, run bundler
@$ bundle@
h2. Objective
The objective of this library is to act as a base for other geo libraries.
The geo calculation API only requires that the point objects used, have a #lat and #lon method, which return the latitude and longitude respectively. The lat/lng should each be a Numeric (ie. Float or Fixnum) within respective 'geo ranges': (-90 to 90, -180 to 180).
h3. Shortest distance
Calculate distance in kms between points p1 and p2
h3. Initial bearing (direction)
Calculate the initial bearing (direction in degrees which p1 points at p2)
h3. Final bearing (direction)
Calculate the final bearing (direction in degrees) between p1 -> p2)
h3. Midpoint
Find the midpoint between points p1 and p2
h3. Destination point
Find the destination point from walking a distance in a given bearing (direction in degrees from p1)
h3. Intersection point
Find the intersection point pcross between a path from p1 and a path from p2
h2. Rhumb lines
h2. Core Extensions
The library also extends core Ruby classes with geo related functions (see core_ext_spec.rb)
h3. Radians to degrees
h3. Degrees to radians
h3. DMS to degrees
Convert (degrees-minutes-seconds) to degrees (Float)
h3. Degrees to DMS
Convert degrees into to DMS format
And many more...
h2. Javascript
The libary also comes wih a javascript file with the same functionality.
See js/geo_calc.js in the /lib folder
h2. Contributing to geo_calc
h2. Copyright
Copyright (c) 2011 Kristian Mandrup. See LICENSE.txt for further details.