asari 0.9.3 → 0.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7ee219d6feb2cf54eeaddd1fd259618b2e877884
+  data.tar.gz: 2554d88f618b327ca3f1a7fc1dcf0e73b4c1bfa1
+SHA512:
+  metadata.gz: 644ee6278143ee097db1f5a85b994de8c076e264eb1a135c355c93631efe80d69b0147699266f88ea5d785c67af24970ba52edcb71ddac7b65fdb08f89f56149
+  data.tar.gz: d9f6b562b44862d6d66fbee0e911cc0ab81ea8e0278b0641eeddfe0885cd03d49c8804254375723388e72cd06b4f59209ff0467d192a1a35a20538c745aab96c

data/lib/asari.rb

@@ -2,6 +2,7 @@ require "asari/version"
 
 require "asari/collection"
 require "asari/exceptions"
+require "asari/geography"
 
 require "httparty"
 

data/lib/asari/geography.rb

@@ -0,0 +1,112 @@
+class Asari
+  # Public: This module contains helper methods that serialize and deserialize
+  # latitudes and longitudes to store on Cloudsearch. For more information, see:
+  #
+  # http://docs.aws.amazon.com/cloudsearch/latest/developerguide/geosearch.html
+  #
+  module Geography
+    EARTH_RADIUS = 6367444
+    METERS_PER_DEGREE_OF_LATITUDE = 111133
+
+    class << self
+
+      # Public: Converts coordinates to unsigned integers that store up to three
+      # place values.
+      #
+      #     options - the options hash requires:
+      #       lat: a Float
+      #       lng: a Float
+      #
+      # Examples:
+      #
+      #     Asari::GeographyConversion.degrees_to_int(45.52, 122.6819)
+      #     #=> {:lat=>25062714160, :lng=>1112993466}
+      #
+      # Returns: a Hash containing :lat and :lng keys with Integer values
+      #
+      def degrees_to_int(options)
+        latitude = latitude_to_int(options[:lat])
+        longitude = longitude_to_int(options[:lng], options[:lat])
+        { lat: latitude, lng: longitude }
+      end
+
+      # Public: Converts unsigned integers created with `degrees_to_int` back to
+      # the standard Geographic Coordinate System.
+      #
+      #     options - the options hash requires:
+      #       lat: an Integer
+      #       lng: an Integer
+      #
+      # Examples:
+      #
+      #     Asari::GeographyConversion.int_to_degrees(lat: 25062714160, lng: 1112993466)
+      #     #=> {:lat=>45.52, :lng=>-122.682}
+      #
+      # Returns: a Hash containing :lat and :lng keys with Float values
+      #
+      def int_to_degrees(options)
+        latitude = latitude_to_degrees(options[:lat])
+        longitude = longitude_to_degrees(options[:lng], latitude)
+        { lat: latitude, lng: longitude }
+      end
+
+      # Public: Calculates a range of integers to search within from a point
+      # and a distance in meters. This is used to search a certain distance from
+      # a point in Cloudsearch.
+      #
+      #     options - the options hash requires:
+      #       meters: an Integer
+      #       lat: a Float
+      #       lng: a Float
+      #
+      # Examples:
+      #
+      #     Asari::GeographyConversion.coordinate_box(lat: 25062714160, lng: 1112993466, miles: 5)
+      #     #=> {:lat=>25062714160, :lng=>1112993466}
+      #
+      # Returns: a Hash containing :lat and :lng keys with Range values
+      #
+      def coordinate_box(options)
+        latitude = options[:lat]
+        longitude = options[:lng]
+
+        earth_radius_at_latitude = EARTH_RADIUS * Math.cos(latitude * ( Math::PI / 180 ))
+
+        change_in_latitude = ( options[:meters].to_f / EARTH_RADIUS ) * ( 180 / Math::PI )
+        change_in_longitude = ( options[:meters].to_f / earth_radius_at_latitude ) * ( 180 / Math::PI )
+
+        bottom = latitude_to_int(latitude - change_in_latitude)
+        top = latitude_to_int(latitude + change_in_latitude)
+
+        left = longitude_to_int(longitude - change_in_longitude, latitude)
+        right = longitude_to_int(longitude + change_in_longitude, latitude)
+
+        { lat: (bottom.round..top.round), lng: (left.round..right.round) }
+      end
+
+
+      private
+      def latitude_to_int(degrees)
+        ((degrees + 180) * METERS_PER_DEGREE_OF_LATITUDE * 1000).round
+      end
+
+      def latitude_to_degrees(int)
+        ((int / METERS_PER_DEGREE_OF_LATITUDE / 1000.0) - 180).round(3)
+      end
+
+      def longitude_to_int(degrees, latitude)
+        meters = meters_per_degree_of_longitude(latitude)
+        ((degrees + 180) * meters * 1000).round
+      end
+
+      def longitude_to_degrees(int, latitude_in_degrees)
+        meters = meters_per_degree_of_longitude(latitude_in_degrees)
+        ((int / meters / 1000.0) - 180).round(3)
+      end
+
+      def meters_per_degree_of_longitude(latitude)
+        METERS_PER_DEGREE_OF_LATITUDE * Math.cos(latitude)
+      end
+    end
+  end
+end

data/lib/asari/version.rb

@@ -1,3 +1,3 @@
 class Asari
-  VERSION = "0.9.3"
+  VERSION = "0.10.0"
 end

data/spec/geography_spec.rb

@@ -0,0 +1,31 @@
+require_relative "../spec_helper"
+
+describe Asari::Geography do
+
+  let(:convert) { Asari::Geography }
+
+  describe "#degrees_to_int" do
+    it "converts standard lat and lng to integers" do
+      result = convert.degrees_to_int(lat: 45.52, lng: 122.682)
+      expect(result).to eq({ lat: 25062714160, lng: 1112993834 })
+    end
+  end
+
+  describe "#int_to_degrees" do
+    it "converts back successfully" do
+      integers = convert.degrees_to_int(lat: -45.52, lng: 122.682)
+      result = convert.int_to_degrees(integers)
+      expect(result).to eq({ lat: -45.52, lng: 122.682 })
+    end
+  end
+
+  describe "#coordinate_box" do
+    it "creates a range from a coordinate and a distance in miles" do
+      result = convert.coordinate_box(lat: 45.52, lng: 122.682, meters: 5000)
+      expect(result).to eq({
+        lat: 25057714154..25067714166,
+        lng: 1112757718..1113229951
+      })
+    end
+  end
+end

metadata

@@ -1,46 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: asari
 version: !ruby/object:Gem::Version
-  version: 0.9.3
-  prerelease: 
+  version: 0.10.0
 platform: ruby
 authors:
 - Tommy Morgan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-11 00:00:00.000000000 Z
+date: 2013-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Asari s a Ruby interface for AWS CloudSearch
@@ -59,37 +54,38 @@ files:
 - lib/asari/active_record.rb
 - lib/asari/collection.rb
 - lib/asari/exceptions.rb
+- lib/asari/geography.rb
 - lib/asari/version.rb
 - spec/active_record_spec.rb
 - spec/asari_spec.rb
 - spec/collection_spec.rb
 - spec/conditionals_spec.rb
 - spec/documents_spec.rb
+- spec/geography_spec.rb
 - spec/search_spec.rb
 - spec_helper.rb
 homepage: http://github.com/duwanis/asari
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: asari
-rubygems_version: 1.8.25
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Asari is a Ruby interface for AWS CloudSearch.
 test_files:
 - spec/active_record_spec.rb
@@ -97,4 +93,6 @@ test_files:
 - spec/collection_spec.rb
 - spec/conditionals_spec.rb
 - spec/documents_spec.rb
+- spec/geography_spec.rb
 - spec/search_spec.rb
+has_rdoc: