module Geocoder::Store::ActiveRecord::ClassMethods

def near_scope_options(latitude, longitude, radius = 20, options = {})


default is 0.0
ignored if database is sqlite.
* +:min_radius+ - the value to use as the minimum radius.
* +:bearing_column+ - used to set the column name of the calculated bearing.
* +:distance_column+ - used to set the column name of the calculated distance.
* +:exclude+ - an object to exclude (used by the +nearbys+ method)
set to false or nil to omit the ORDER BY clause
* +:order+ - column(s) for ORDER BY SQL clause; default is distance;
* +:select_bearing+ - like +:select_distance+ but for bearing.
SELECT SQL fragment (e.g. AS distance)
* +:select_distance+ - whether to include the distance alias in the
* +:select+ - string with the SELECT SQL fragment (e.g. “id, name”)
Geocoder.configure[:distances] to configure default calculation method.
set to false for no bearing calculation. Use
between the given point and each found nearby point;
the method to be used for calculating the bearing (direction)
* +:bearing+ - :linear or :spherical.
Use Geocoder.configure[:units] to configure default units.
is added to each found nearby object.
for interpreting radius as well as the +distance+ attribute which
* +:units+ - :mi or :km; to be used.

Options hash may include:
records within a radius (in kilometers) of the given point.
Get options hash suitable for passing to ActiveRecord.find to get
# 
def near_scope_options(latitude, longitude, radius = 20, options = {})
  if options[:units]
    options[:units] = options[:units].to_sym
  end
  options[:units] ||= (geocoder_options[:units] || Geocoder.config.units)
  select_distance = options.fetch(:select_distance, true)
  options[:order] = "" if !select_distance && !options.include?(:order)
  select_bearing = options.fetch(:select_bearing, true)
  bearing = bearing_sql(latitude, longitude, options)
  distance = distance_sql(latitude, longitude, options)
  distance_column = options.fetch(:distance_column, 'distance')
  bearing_column = options.fetch(:bearing_column, 'bearing')
  b = Geocoder::Calculations.bounding_box([latitude, longitude], radius, options)
  args = b + [
    full_column_name(geocoder_options[:latitude]),
    full_column_name(geocoder_options[:longitude])
  ]
  bounding_box_conditions = Geocoder::Sql.within_bounding_box(*args)
  if using_sqlite?
    conditions = bounding_box_conditions
  else
    min_radius = options.fetch(:min_radius, 0).to_f
    conditions = [bounding_box_conditions + " AND (#{distance}) BETWEEN ? AND ?", min_radius, radius]
  end
  {
    :select => select_clause(options[:select],
                             select_distance ? distance : nil,
                             select_bearing ? bearing : nil,
                             distance_column,
                             bearing_column),
    :conditions => add_exclude_condition(conditions, options[:exclude]),
    :order => options.include?(:order) ? options[:order] : "#{distance_column} ASC"
  }
end