geomodel 0.2.0

更改

版本 0.2.0 (2009-08-31)

• 使用单个StringListProperty而不是每个单元格的一个StringProperty。有关如何迁移现有GeoModel实体索引的说明，请参阅http://code.google.com/p/geomodel/wiki/PreRevision8Migration

• 更多单元测试。

版本 0.1.0 (2009-07-15)

• PyPI初始发布。

创建和保存GeoModel派生实体

要使用GeoModel类，只需声明一个新的模型类，继承自geomodel.GeoModel类，如下所示

>>> import google.appengine.ext.db
>>> import geo.geomodel
>>> class MyEntity(geo.geomodel.GeoModel):
...     foo = google.appengine.ext.db.StringProperty()
...     bar = google.appengine.ext.db.IntegerProperty()

目前，仅支持单点实体。新类型的MyEntity实体将具有location属性，其类型为db.GeoPt，可以根据需要设置。在将实体put()到数据存储之前，请确保调用update_location以同步实体的底层geocell索引属性

>>> some_entity = MyEntity(location=google.appengine.ext.db.GeoPt(37, -122),
...                        foo='Hello',
...                        bar=5)
>>> some_entity.location = google.appengine.ext.db.GeoPt(38, -122)
>>> some_entity.update_location()
>>> some_entity.put()
datastore_types.Key.from_path(u'MyEntity', 1, _app=u'test')

查询您的实体

GeoModel库目前支持两种基本地理空间查询类型

• 边界框查询

• 邻近性（最近n个）查询

要执行边界框查询，请使用 bounding_box_fetch 类的如下方法：

>>> import geo.geotypes
>>> results = MyEntity.bounding_box_fetch(
...               MyEntity.all().filter('bar >', 4),  # Rich query!
...               geo.geotypes.Box(39, -121, 37, -123),
...               max_results=10)
>>> results[0].foo
u'Hello'

请注意不要请求太多结果，否则会导致数据存储或请求超时！

要执行邻近查询，请使用 proximity_fetch 类的如下方法：

>>> result = MyEntity.proximity_fetch(
...               MyEntity.all().filter('bar <', 10),  # Rich query!
...               geo.geotypes.Point(39, -121),  # Or db.GeoPt
...               max_results=10,
...               max_distance=160934)  # Within 100 miles.
>>> result[0].foo
u'Hello'

注意，对于多个属性上的丰富查询，您需要在 index.yaml 文件中设置正确的索引。在开发服务器上测试您的应用程序应该会填充该文件所需索引。此外，GeoModel 目前在每个实体（每个地理单元分辨率一个）上需要许多内部属性，这可能导致 index.yaml 文件看起来很混乱。这将是未来版本中希望改变的事情。