geo_point 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem "geo_calc",   '~> 0.7.3'
+gem "geo_units",  '>= 0.2.0'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec",    ">= 2.6.0"
+  gem "bundler",  "~> 1.0.6"
+  gem "jeweler",  "~> 1.6.2"
+  gem "rcov",     ">= 0"
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Kristian Mandrup
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,103 @@
+h1. Geo Point
+
+Adds the concept of a GeoPoint for geo libraries. A GeoPoint encapsulates latitude and longitude, and: 
+
+* a coordinates mode (coord_mode) that can be set to either :lng_lat or :lat_lng
+* calculations such as distance, bearing, midpoint etc.
+* parsing from various String, Hash or Array formats, including from DMS string format, such as "58 38 38N, 003 04 12W"
+
+Using GeoPoints makes it much easier and more efficient to transport location point data and various geo libraries adds additional functionality such as 
+vector operations on top (see fx _geo_vectors_ gem). Enjoy!
+
+h2. Install
+
+Gemfile:
+
+@gem 'geo_point'@
+
+$ bundle
+
+h2. Quick start (Usage)
+
+First define the points on the globe you want to work with.
+The GeoPoint initializer is very flexible with regards to the arguments it can handle.
+
+<pre>
+  # factory method on core ruby classes
+  "51 12 03 N, 24 10 02 E".geo_point
+  [51.5136, -0.0983].geo_point
+  {:latitude => 27.3, :longitude => "24 10 02 E"}.geo_point
+
+  # two arguments
+  p1 = GeoPoint.new 51.5136, -0.0983
+  p2 = GeoPoint.new "14 11 01 N", "-0.0983"
+  p3 = GeoPoint.new 51.5136, "24 10 02 E"
+
+  # a String
+  p1 = GeoPoint.new "51.5136, -0.0983"
+  p1 = GeoPoint.new "51.5136, 24 10 02 E"
+  p3 = GeoPoint.new "51.4778, -0.0015"  
+  p1 = GeoPoint.new "51 12 03 N, 24 10 02 E"
+
+  # an Array
+  p2 = GeoPoint.new [51.5136, -0.0983]
+  p2 = GeoPoint.new [51.5136, "24 10 02 E"]
+  p2 = GeoPoint.new [51.5136, {:lon => 27.3}]
+
+  # a Hash
+  p4 = GeoPoint.new {:lat => 27.3, :lng => "24 10 02 E"}
+  p4 = GeoPoint.new {:latitude => 27.3, :longitude => "24 10 02 E"}  
+</pre> 
+
+h2. Utility methods
+
+These are some of the utility methods you can use on a GeoPoint object
+  
+<pre>
+  p1 = GeoPoint.new 5.1, -7
+  p1.lat          # latitude
+  p1.lon          # longitude
+  p1.to_lat_lng   # Array representation of [lat, lng]
+  p1.to_lng_lat   # Array representation of [lng, lat]
+  p1.to_s         # String representation (DMS format)
+  p1.to_coords    # calls either #to_lat_lng or #to_lng_lat depending on global :coord_mode setting
+</pre>  
+
+h2. Global configuration options
+
+<pre>
+  GeoPoint.coord_mode = :lat_lng
+  GeoPoint.coord_mode = :lng_lat
+  
+  GeoPoint.earth_radius_km  = 6379 
+  GeoPoint.earth_radius_km  = 6371 
+</pre>
+
+h2. GeoPoint functionality
+
+A GeoPoint always has the following calculation API available:
+
+* bearing
+* destination
+* distancer
+* intersection
+* midpoint 
+* rhumb (distance)
+
+See the _geo_calc_ gem for details on how to use this Api
+
+h2. Contributing to geo_point
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+h2. Copyright
+
+Copyright (c) 2011 Kristian Mandrup. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "geo_point"
+  gem.homepage = "http://github.com/kristianmandrup/geo_point"
+  gem.license = "MIT"
+  gem.summary = %Q{A GeoPoint encapsulates latitude, longitude and various geo calculations relative to itself}
+  gem.description = %Q{Allows for easy parsing of Strings, Hashes and Arrays into a GeoPoint with lat/long}
+  gem.email = "kmandrup@gmail.com"
+  gem.authors = ["Kristian Mandrup"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "geo_point #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/geo_point.gemspec

@@ -0,0 +1,72 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{geo_point}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{Kristian Mandrup}]
+  s.date = %q{2011-06-13}
+  s.description = %q{Allows for easy parsing of Strings, Hashes and Arrays into a GeoPoint with lat/long}
+  s.email = %q{kmandrup@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.textile"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.textile",
+    "Rakefile",
+    "VERSION",
+    "geo_point.gemspec",
+    "lib/geo_point.rb",
+    "lib/geo_point/calc.rb",
+    "lib/geo_point/class_methods.rb",
+    "lib/geo_point/core_extension.rb",
+    "lib/geo_point/shared.rb",
+    "spec/geo_point/class_methods_spec.rb",
+    "spec/geo_point/initializer_spec.rb",
+    "spec/geo_point/lat_lon.rb",
+    "spec/geo_point_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/kristianmandrup/geo_point}
+  s.licenses = [%q{MIT}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.5}
+  s.summary = %q{A GeoPoint encapsulates latitude, longitude and various geo calculations relative to itself}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<geo_calc>, ["~> 0.7.3"])
+      s.add_runtime_dependency(%q<geo_units>, [">= 0.2.0"])
+      s.add_development_dependency(%q<rspec>, [">= 2.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.6"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<geo_calc>, ["~> 0.7.3"])
+      s.add_dependency(%q<geo_units>, [">= 0.2.0"])
+      s.add_dependency(%q<rspec>, [">= 2.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.6"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<geo_calc>, ["~> 0.7.3"])
+    s.add_dependency(%q<geo_units>, [">= 0.2.0"])
+    s.add_dependency(%q<rspec>, [">= 2.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.6"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/lib/geo_point/calc.rb

@@ -0,0 +1,59 @@
+class GeoPoint
+  module Calc
+    def self.included(base)      
+      base.send :include, ::GeoCalc
+      base.send :include, Destination
+      base.send :include, Intersection
+      base.send :include, Midpoint
+    end
+  
+    module Destination
+      def destination_point brng, dist
+        GeoPoint.new GeoCalc::Destination.destination_point(self, brng, dist).to_coords
+      end
+
+      # Returns the destination point from this point having travelled the given distance (in km) on the 
+      # given initial bearing (bearing may vary before destination is reached)
+      # 
+      #   see http:#williams.best.vwh.net/avform.htm#LL
+      # 
+      # - Numeric bearing: Initial bearing in degrees
+      # - Numeric dist: Distance in km
+      # Returns GeoPoint: Destination point
+      def self.destination_point base_point, brng, dist
+        GeoPoint.new GeoCalc::Destination.destination_point(base_point, brng, dist).to_coords
+      end
+    end
+  
+    module Intersection
+      # see(#intersection)
+      # @returns [GeoPoint] Destination point (null if no unique intersection defined)    
+      def self.intersection_point p1, brng1, p2, brng2    
+        GeoPoint.new GeoCalc::Intersection.intersection(p1, brng1, p2, brng2).to_coords
+      end
+
+      # see(#intersection)
+      # @returns [GeoPoint] Destination point (null if no unique intersection defined)    
+      def intersection_point brng1, p2, brng2    
+        GeoPoint.new GeoCalc::Intersection.intersection(self, brng1, p2, brng2).to_coords
+      end
+    end  
+
+    module Midpoint  
+      def midpoint_to point
+        GeoPoint.new GeoCalc::Midpoint.midpoint_to(self, point).to_coords
+      end
+
+      # Returns the midpoint between this point and the supplied point.
+      # see(http:#mathforum.org/library/drmath/view/51822.html for derivation)
+      # 
+      # @param [GeoPoint] base_point: Starting point (latitude, longitude)
+      # @param [GeoPoint] point: Destination point (latitude, longitude)
+      # @return [Array] Midpoint between this point and the supplied point
+      #
+      def self.midpoint_to base_point, point
+        GeoPoint.new GeoCalc::Midpoint.midpoint_to(base_point, point).to_coords
+      end
+    end
+  end
+end

data/lib/geo_point/class_methods.rb

@@ -0,0 +1,15 @@
+require 'geo_point/shared'
+
+class GeoPoint
+  module ClassMethods
+    def earth_radius_km  
+      @earth_radius_km ||= 6371
+    end    
+
+    def coord_mode  
+      @coord_mode ||= :lat_lng
+    end    
+           
+    include Shared
+  end
+end

data/lib/geo_point/core_extension.rb

@@ -0,0 +1,16 @@
+class GeoPoint
+  module CoreExtension
+    def to_coords    
+      send(:"to_#{GeoPoint.coord_mode}")
+    end
+
+    def geo_point
+      GeoPoint.new to_coords
+    end
+  end
+end  
+
+[Array, Hash, String].each do |cls|
+  cls.send :include, GeoPoint::CoreExtension
+end
+

data/lib/geo_point/shared.rb

@@ -0,0 +1,37 @@
+class GeoPoint
+  module Shared
+    def unit
+      :degrees
+    end
+
+    def earth_radius_km= radius_km
+      raise ArgumentException, "Not a valid earth km radius: #{radius_km}" unless valid_earth_radius? radius_km
+      @earth_radius_km = radius_km
+    end
+
+    def coord_mode= mode
+      raise ArgumentException, "Not a valid coordinates mode: #{mode}" unless valid_mode? mode
+      @coord_mode = mode
+    end
+  
+    protected
+
+    def is_numeric? arg
+      arg.is_a? Numeric
+    end  
+
+    alias_method :is_num?, :is_numeric?
+  
+    def check_numeric! arg
+      raise ArgumentError, "Argument must be Numeric" if !is_numeric? arg
+    end
+
+    def valid_earth_radius? radius_km
+      is_numeric?(radius_km) && radius_km.is_between?(6350, 6380)            
+    end           
+
+    def valid_mode? mode 
+      [:lng_lat, :lat_lng].include? mode
+    end    
+  end
+end

data/lib/geo_point.rb

@@ -0,0 +1,142 @@
+require 'sugar-high/arguments'
+require 'geo_calc'
+ #  Sample usage:                                                                                 
+ #    p1 = GeoPoint.new(51.5136, -0.0983)                                                      
+ #    p2 = GeoPoint.new(51.4778, -0.0015)                                                      
+ #    dist = p1.distance_to(p2)          # in km                                             
+ #    brng = p1.bearing_to(p2)           # in degrees clockwise from north                   
+ #    ... etc                                                                                     
+ # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
+
+class GeoPoint  
+  autoload :Calc,           'geo_point/calc'
+  autoload :Shared,         'geo_point/shared'
+  autoload :ClassMethods,   'geo_point/class_methods'
+  autoload :CoreExtension,  'geo_point/core_extension'
+
+  include GeoPoint::Calc
+  include GeoCalc::PrettyPrint
+
+  attr_reader   :lat, :lon  
+
+  # Creates a point on the earth's surface at the supplied latitude / longitude
+  # 
+  # - Numeric latitude in numeric degrees
+  # - Numeric longitude in numeric degrees  
+
+  # Optional options
+  # - :radius - earth radius in km
+  # - :mode - coordinates mode, either :lng_lat or :lat_lng, otherwise uses global setting as per GeoPoint.coord_mode
+  def initialize *args
+    options = args.is_a?(GeoPoint) ? {} : args.last_option
+    earth_radius_km = options[:radius]
+    coord_mode = options[:mode]
+    
+    case args.size
+    when 1
+      create_from_one args
+    when 2
+      create_from_two *args
+    else
+      raise "GeoPoint must be initialized with either one or to arguments defining the (latitude, longitude) coordinate on the map"
+    end
+  end
+
+  extend ClassMethods
+  include Shared
+
+  def coord_mode
+    @coord_mode ||= GeoPoint.coord_mode
+  end
+
+  def earth_radius_km  
+    @earth_radius_km ||= GeoPoint.earth_radius_km  # default
+  end
+
+  def lat= value 
+    @lat = value.to_lat
+  end
+
+  def lon= value
+    @lon = value.to_lng
+  end
+
+  (Symbol.lng_symbols - [:lon]).each do |sym|
+    class_eval %{
+      alias_method :#{sym}, :lon
+      alias_method :#{sym}=, :lon=
+    }
+  end    
+  alias_method :to_lng, :lng
+
+  (Symbol.lat_symbols - [:lat]).each do |sym|
+    class_eval %{
+      alias_method :#{sym}, :lat
+      alias_method :#{sym}=, :lat=
+    }
+  end
+  alias_method :to_lat, :lat
+
+  def [] key
+    case key
+    when Fixnum   
+      raise ArgumentError, "Index must be 0 or 1" if !(0..1).cover?(key)
+      to_a[key] 
+    when String, Symbol
+      send(key) if respond_to? key
+    else
+      raise ArgumentError, "Key must be a Fixnum (index) or a method name"  
+    end    
+  end
+
+  alias_method :to_dms, :to_s
+
+  def reverse_point!
+    self.lat = lat * -1
+    self.lng = lng * -1
+    self    
+  end
+
+  def reverse_point
+    self.dup.reverse_point!
+  end
+
+  def to_lat_lng
+    [lat, lng]
+  end
+
+  def to_lng_lat
+    [lng, lat]
+  end
+
+  def to_a
+    send(:"to_#{coord_mode}")
+  end
+  
+  protected
+
+  def is_numeric? arg
+    arg.is_a? Numeric
+  end  
+
+  alias_method :is_num?, :is_numeric?
+
+  def check_numeric! arg
+    raise ArgumentError, "Argument must be Numeric" if !is_numeric? arg
+  end
+
+  def to_coords points
+    points.send(:"to_#{coord_mode}")
+  end
+  
+  def create_from_one args
+    args = args.first
+    create_from_two *to_coords(args)
+  end
+  
+  def create_from_two lat, lon
+    @lat    = lat.to_lat
+    @lon    = lon.to_lng
+  end  
+end
+

data/spec/geo_point/class_methods_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+# - www.movable-type.co.uk/scripts/latlong.html
+describe GeoPoint do  
+  describe 'Class methods' do     
+    describe '#coord_mode' do
+      it 'should change global coordinates mode' do
+        GeoPoint.coord_mode = :lng_lat
+        GeoPoint.coord_mode.should == :lng_lat        
+
+        GeoPoint.coord_mode = :lat_lng
+        GeoPoint.coord_mode.should == :lat_lng                        
+      end
+      
+      it 'shoould not allow setting invalid coord mode' do
+        lambda { GeoPoint.coord_mode = :blip }.should raise_error
+      end
+    end
+    
+    describe '#earth_radius_km' do
+      it 'should change global earth_radius_km' do
+        GeoPoint.earth_radius_km = 6360
+        GeoPoint.earth_radius_km.should == 6360
+      end
+      
+      it 'shoould not allow setting invalid earth radius' do
+        lambda { GeoPoint.earth_radius_km = 6100 }.should raise_error
+      end    
+    end
+  end
+end

data/spec/geo_point/initializer_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+
+# - www.movable-type.co.uk/scripts/latlong.html
+describe GeoPoint do  
+  before do
+    GeoPoint.earth_radius_km = 6371
+  end
+  
+  describe '#initializer' do
+    describe '1 argument' do
+      describe 'single String' do
+        describe '50.1, 5.0 ' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new "50.1, 5.0"
+            p1.should be_a(GeoPoint)
+            p1.lat.should == 50.1
+            p1.lon.should == 5.0
+            p1.unit.should == :degrees
+            p1.earth_radius_km.should == 6371
+          end
+        end    
+
+        describe '(50.1, 5.0)' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new "(50.1, 5.2)"
+            p1.should be_a(GeoPoint)
+            p1.lat.should == 50.1
+            p1.lon.should == 5.2
+            p1.unit.should == :degrees
+            p1.earth_radius_km.should == 6371
+          end
+        end 
+      
+        describe '58 38 38N, 003 04 12W' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new "58 38 38N, 003 04 12W"
+            p1.should be_a(GeoPoint)
+            p1.lat.should be_within(0.5).of(58.38)
+            p1.lon.should be_within(0.5).of(-3)
+            p1.unit.should == :degrees
+            p1.earth_radius_km.should == 6371
+          end
+        end 
+
+        describe '(58 38 38N, 003 04 12W)' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new "(58 38 38N, 003 04 12W)"
+            p1.should be_a(GeoPoint)
+            p1.lat.should be_within(0.5).of(58.38)
+            p1.lon.should be_within(0.5).of(-3) # W is negative, then normalize
+            p1.unit.should == :degrees
+            p1.earth_radius_km.should == 6371
+          end
+        end
+      end
+    
+      describe 'single Array' do
+        describe '2 Fixed numbers: 50,5 ' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new [50, 5]
+            p1.should be_a(GeoPoint)
+            p1.lat.should == 50
+            p1.lon.should == 5
+            p1.unit.should == :degrees        
+            p1.earth_radius_km.should == 6371
+          end
+        end
+      
+        describe '2 Float numbers: 50.1, 5.0 ' do
+          it 'should create a GeoPoint' do
+            p1 = GeoPoint.new [50.1, 5.0]
+            p1.should be_a(GeoPoint)
+            p1.lat.should == 50.1
+            p1.lon.should == 5.0
+            p1.unit.should == :degrees
+            p1.earth_radius_km.should == 6371
+          end
+        end            
+      
+        describe 'single Hash' do
+          describe 'with: {:lat => 50.1, :lng => 5.1}' do
+            it 'should create a GeoPoint' do
+              p1 = GeoPoint.new :lat => 50.1, :lng => 5.1
+              p1.should be_a(GeoPoint)
+              p1.lat.should == 50.1
+              p1.lon.should == 5.1
+              p1.unit.should == :degrees
+              p1.earth_radius_km.should == 6371
+            end
+          end            
+  
+          describe 'with: {:lat => 50.1, :long => 5.1}' do
+            it 'should create a GeoPoint' do
+              p1 = GeoPoint.new :lat => 50.1, :long => 5.1
+              p1.should be_a(GeoPoint)
+              p1.lat.should == 50.1
+              p1.lon.should == 5.1
+              p1.unit.should == :degrees
+              p1.earth_radius_km.should == 6371
+            end
+          end            
+  
+          describe 'with: {:latitude => 50.1, :longitude => 5.1}' do
+            it 'should create a GeoPoint' do
+              p1 = GeoPoint.new :latitude => 50.1, :longitude => 5.1
+              p1.should be_a(GeoPoint)
+              p1.lat.should == 50.1
+              p1.lon.should == 5.1
+              p1.unit.should == :degrees
+              p1.earth_radius_km.should == 6371
+            end
+          end
+        end
+      end     
+    end 
+  
+    describe 'with 2 arguments' do
+      describe '2 Fixed numbers (Fixnum)' do
+        it 'should create a GeoPoint' do
+          p1 = GeoPoint.new 50, 5
+          p1.should be_a(GeoPoint)
+          p1.lat.should == 50
+          p1.lon.should == 5
+          p1.unit.should == :degrees        
+          p1.earth_radius_km.should == 6371
+        end
+      end
+
+      describe '2 Float numbers' do
+        it 'should create a GeoPoint' do
+          p1 = GeoPoint.new 50.1, 5.0
+          p1.should be_a(GeoPoint)
+          p1.lat.should == 50.1
+          p1.lon.should == 5.0
+          p1.unit.should == :degrees
+          p1.earth_radius_km.should == 6371
+        end
+      end    
+    
+      describe '2 Strings: "58 38 38N", "003 04 12W"' do
+        it 'should create a GeoPoint' do
+          p1 = GeoPoint.new "58 38 38N", "003 04 12W"
+          p1.should be_a(GeoPoint)
+          p1.lat.should be_within(0.5).of(58.38)
+          p1.lon.should be_within(0.5).of(-3)
+          p1.unit.should == :degrees
+          p1.earth_radius_km.should == 6371
+        end
+      end  
+    end
+  end # initializer
+end

data/spec/geo_point/lat_lon.rb

@@ -0,0 +1,115 @@
+require 'spec_helper'
+
+# - www.movable-type.co.uk/scripts/latlong.html
+describe GeoPoint do  
+  describe '#lat' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+
+    it 'should return latitude' do
+      @p1.lat.should == 50
+    end
+
+    describe '#latitude (alias)' do
+      it 'should return latitude' do
+        @p1.latitude.should == 50
+      end
+    end
+
+    describe '#to_lat (alias)' do
+      it 'should return latitude' do
+        @p1.to_lat.should == 50
+      end
+    end
+  end
+
+  describe '#lat=' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+
+    it 'should set new latitude' do
+      @p1.lat = 60
+      @p1.lat.should == 60
+    end
+
+    it 'should set new latitude -2' do
+      @p1.lat = -2
+      @p1.lat.should == -2
+    end
+
+    it 'should convert latitude -182 to -2' do
+      @p1.lat = -2
+      @p1.lat.should == -2
+    end
+
+
+    it 'should set new latitude within allowed range' do
+      @p1.lat = 520
+      @p1.lat.should be_between(0, 360)
+    end
+
+    describe '#latitude (alias)' do
+      it 'should set latitude' do
+        @p1.lat = 72
+        @p1.latitude.should == 72
+      end
+    end
+  end
+
+  describe '#lon' do
+    before :each do
+      @p1 = GeoPoint.new 5, 50
+    end
+
+    it 'should return longitude' do
+      @p1.lon.should == 50
+    end
+
+    it 'should return longitude (via lng)' do
+      @p1.lng.should == 50
+    end
+
+    describe '#longitude (alias)' do
+      it 'should return longitude' do
+        @p1.longitude.should == 50
+      end
+    end
+
+    describe '#to_lng (alias)' do
+      it 'should return latitude' do
+        @p1.to_lng.should == 50
+      end
+    end
+  end
+
+  describe '#lon=' do
+    before :each do
+      @p1 = GeoPoint.new 5, 50
+    end
+
+    it 'should set new longitude' do
+      @p1.lat.should == 5
+      @p1.lon = 60
+      @p1.lon.should == 60
+    end
+
+    it 'should return longitude (via lng)' do
+      @p1.lng = 70
+      @p1.lng.should == 70
+    end
+
+    it 'should set new latitude within allowed range' do
+      @p1.lon = 520
+      @p1.longitude.should be_between(-180, 180)
+    end
+
+    describe '#latitude (alias)' do
+      it 'should set latitude' do
+        @p1.longitude = 72
+        @p1.longitude.should == 72
+      end
+    end
+  end
+end

data/spec/geo_point_spec.rb

@@ -0,0 +1,99 @@
+require 'spec_helper'
+
+# - www.movable-type.co.uk/scripts/latlong.html
+describe GeoPoint do  
+  describe '#reverse_point' do
+    before :each do
+      @p = GeoPoint.new -2, 5
+    end
+  
+    it 'should return reverse GeoPoint (2, -5)' do
+      @p2 = @p.reverse_point
+      @p2.should_not == @p  
+      @p2.lat.should == 2
+      @p2.lng.should == -5
+    end
+  end
+
+  describe '#reverse_point!' do
+    before :each do
+      @p = GeoPoint.new -2, 5
+    end
+  
+    it 'should return reverse GeoPoint (2, -5)' do
+      @p.reverse_point!
+      @p.lat.should == 2
+      @p.lng.should == -5
+    end
+  end
+
+  describe '#to_s' do
+    before :each do
+      @p1 = GeoPoint.new 50.1, 5
+    end
+  
+    it 'should return GeoPoint as a dms formatted String' do
+      @p1.to_s.should match /50.+5/
+    end
+  
+    it 'should return GeoPoint as a dms formatted String' do
+      @p1.to_s(:dm, 2).should match /50.+5/
+    end
+  end
+
+  describe '#[]' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+  
+    it 'index of 0 should return latitude' do
+      @p1[0].should == 50
+    end
+
+    it 'index of 1 should return longitude' do
+      @p1[1].should == 5
+    end
+
+    it 'index of 2 should raise error' do
+      lambda {@p1[2]}.should raise_error
+    end
+
+    it ':lat should return latitude' do
+      @p1[:lat].should == 50
+    end
+
+    it ':long should return longitude' do
+      @p1[:long].should == 5
+    end
+  end
+  
+  describe '#to_a' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+  
+    it 'should return GeoPoint as an array depending on state of reverse_arr' do
+      @p1.to_a.should == [50, 5]
+    end  
+  end
+  
+  describe '#to_lat_lng' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+  
+    it 'should return GeoPoint as an array of [lat, lng]' do
+      @p1.to_lat_lng.should == [50, 5]
+    end  
+  end
+
+  describe '#to_lng_lat' do
+    before :each do
+      @p1 = GeoPoint.new 50, 5
+    end
+  
+    it 'should return GeoPoint as an array of [lng, lat]' do
+      @p1.to_lng_lat.should == [5, 50]
+    end  
+  end  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+require 'geo_point'
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: geo_point
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Kristian Mandrup
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: geo_calc
+  requirement: &2161453140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *2161453140
+- !ruby/object:Gem::Dependency
+  name: geo_units
+  requirement: &2161452560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2161452560
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2161451960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2161451960
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2161451360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.6
+  type: :development
+  prerelease: false
+  version_requirements: *2161451360
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &2161450760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+  type: :development
+  prerelease: false
+  version_requirements: *2161450760
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &2161450160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2161450160
+description: Allows for easy parsing of Strings, Hashes and Arrays into a GeoPoint
+  with lat/long
+email: kmandrup@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.textile
+files:
+- .document
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.textile
+- Rakefile
+- VERSION
+- geo_point.gemspec
+- lib/geo_point.rb
+- lib/geo_point/calc.rb
+- lib/geo_point/class_methods.rb
+- lib/geo_point/core_extension.rb
+- lib/geo_point/shared.rb
+- spec/geo_point/class_methods_spec.rb
+- spec/geo_point/initializer_spec.rb
+- spec/geo_point/lat_lon.rb
+- spec/geo_point_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/kristianmandrup/geo_point
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 373389270659259712
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: A GeoPoint encapsulates latitude, longitude and various geo calculations
+  relative to itself
+test_files: []