Skip to content

parrish/mongo_geo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mongo_geo

mongo_geo is a plugin for MongoMapper that exposes the GeoSpatial indexing features in MongoDb.

Usage

On the model

class TestAsset
  include MongoMapper::Document
  plugin GeoSpatial
  
  # Pass create_index: true to ensure the Geo2D index is created
  # On an embedded document, you can create the index with
  # ensure_index 'embedded_doc.coords' => Mongo::GEO2D
  geo_key :coords, Array, create_index: true
end

Plucky style queries:

TestAsset.where(:coords.near => [50, 50]).limit(10).to_a
TestAsset.where(:coords.within => { '$center' => [[50, 50], 10] }).to_a         # '$center' => [center, radius]
TestAsset.where(:coords.within => { '$box' => [ [45, 45], [55, 55] ] }).to_a    # [lower_left, top_right]

N.B. bounds queries are syntactically ugly at the moment and are likely to change soon

geoNear and convenience methods

nearby = TestAsset.near([50, 50], num: 15, query: { ... })
nearby.average_distance                     # average distance of all results from the target point
nearby.first.distance                       # distance of this result from the target
TestAsset.first.distance_from([50, 50])     # distance from any point
TestAsset.first.neighborhood(:limit => 10)  # closest objects to this one

Queries can be specified with the ruby driver style finders

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

About

A MongoMapper plugin that adds geospatial functionality.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages