mongoid--2d索引简介（index）

古城微笑少年丶 2022-08-21 11:56 143阅读 0赞

# mongoid中的2d索引简介 #

mongoid是mongoldb的ruby版本driver。  
最近使用mongoid时发现文档不太详细，使用2d索引时查询源码才找到一些方法的用法，分享一下。

2d索引是对于经度和纬度建立索引，mongodb内部做了一些处理，可以方便的进行查询。

mongoldb对于2d索引的介绍：  
[https://docs.mongodb.org/manual/core/2d/][https_docs.mongodb.org_manual_core_2d]

mongoid的官方文档：  
[https://docs.mongodb.org/ecosystem/tutorial/mongoid-indexes/][https_docs.mongodb.org_ecosystem_tutorial_mongoid-indexes]

2d索引的建立方式：

class Person
      include Mongoid::Document
      field :location, type: Array
    
      index({ location: "2d" }, { min: -200, max: 200 })
    end

**注意对于要建立2d索引的字段，需要定义为Array类型。**

# 问题 #

建立2d索引后，需要进行相关查询，比如查询距离坐标［0, 0］在10km之内的所有数据，这时发现mongoid的官方文档中并没有介绍。

而mongoldb的文档中介绍了 geoNear等方法，于是，在ruby项目中用mongoid的class的所有方法中查找到含 geo 关键字的方法，发现有个 geo\_near 方法，然后下载了mongoid的源码，找到了其定义和用法如下。然后发现用起来其实很简单～～

# geo\_near方法 #

代码位置：  
lib/mongoid/contextual/mongo.rb

# Execute a $geoNear command against the database.
      #
      # @example Find documents close to 10, 10.
      #   context.geo_near([ 10, 10 ])
      #
      # @example Find with spherical distance.
      #   context.geo_near([ 10, 10 ]).spherical
      #
      # @example Find with a max distance.
      #   context.geo_near([ 10, 10 ]).max_distance(0.5)
      #
      # @example Provide a distance multiplier.
      #   context.geo_near([ 10, 10 ]).distance_multiplier(1133)
      #
      # @param [ Array<Float> ] coordinates The coordinates.
      #
      # @return [ GeoNear ] The GeoNear command.
      #
      # @since 3.1.0
      def geo_near(coordinates)
        GeoNear.new(collection, criteria, coordinates)
      end

[https_docs.mongodb.org_manual_core_2d]: https://docs.mongodb.org/manual/core/2d/
[https_docs.mongodb.org_ecosystem_tutorial_mongoid-indexes]: https://docs.mongodb.org/ecosystem/tutorial/mongoid-indexes/