Geographic annotation for Plone
Project description
collective.geo.geographer
Introduction
collective.geo.geographer provides geo annotation for Plone.
This package is based on Sean Gillies’s idea (zgeo.geographer) and integrates its functionalities in collective.geo project.
Requirements
simplejson
geopy
Plone >= 4
How it work
Any object that implements zope.annotation.interfaces.IAttributeAnnotatable and collective.geo.geographer.interfaces.IGeoreferenceable can be adapted and geo-referenced. The former marker is standard for Zope content objects, and the latter can be easily configured via ZCML.
Let’s test with an example placemark, which provides both of the marker interfaces mentioned above.
>>> from zope.interface import implements >>> from zope.annotation.interfaces import IAttributeAnnotatable >>> from collective.geo.geographer.interfaces import IGeoreferenceable>>> class Placemark(object): ... implements(IGeoreferenceable, IAttributeAnnotatable)>>> placemark = Placemark()
Adapt it to IGeoreferenced
>>> from collective.geo.geographer.interfaces import IGeoreferenced >>> geo = IGeoreferenced(placemark)
Its properties should all be None
>>> geo.type is None True >>> geo.coordinates is None True >>> geo.crs is None True
Now set the location geometry to type “Point” and coordinates 105.08 degrees West, 40.59 degrees North using setGeoInterface()
>>> geo.setGeoInterface('Point', (-105.08, 40.59))
A georeferenced object has “type” and “coordinates” attributes which should give us back what we put in.
>>> geo.type 'Point' >>> geo.coordinates (-105.08, 40.590000000000003) >>> geo.crs is None True
An event should have been sent
>>> from zope.component.eventtesting import getEvents >>> from collective.geo.geographer.event import IObjectGeoreferencedEvent >>> events = getEvents(IObjectGeoreferencedEvent) >>> events[-1].object is placemark True
Plone integration
Make a topic in our folder
>>> self.setRoles(('Manager',))>>> folder = self.folder >>> oid = self.folder.invokeFactory('Topic', 'topic') >>> topic = self.folder[oid] >>> c = topic.addCriterion('getGeometry', 'ATBooleanCriterion')
Add geo-referenced content
>>> oid = self.folder.invokeFactory('Document', 'doc') >>> doc = self.folder[oid]
- If content type doesn’t implements IGeoreferenceable interfaces we need to provide it
>>> from zope.interface import alsoProvides >>> alsoProvides(doc, IGeoreferenceable)
- now we can set the coordinates
>>> from collective.geo.geographer.interfaces import IWriteGeoreferenced >>> geo = IWriteGeoreferenced(doc) >>> geo.setGeoInterface('Point', (-100, 40))
Check the topic
>>> brain = [b for b in topic.queryCatalog() if b.id == 'doc'][0] >>> brain.zgeo_geometry['type'] 'Point' >>> brain.zgeo_geometry['coordinates'] (-100, 40)
- A simple view notify us if a context is geo referenceable
>>> doc.restrictedTraverse('@@geoview').isGeoreferenceable() True
>>> topic.restrictedTraverse('@@geoview').isGeoreferenceable() False
Contributors
Sean Gillies
Giorgio Borelli
Changelog
0.1.2 (2010-12-28)
Moved IGeoView from c.geo.contentlocations
0.1.1 (2010-11-13)
moved geocoderview to portal root
0.1 (2010-10-31)
removed zgeo.geographer dependency
zgeo.plone.geographer code refactoring
moved from zgeo.plone.geographer
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.geo.geographer-0.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b91c9d563a045a3c932e89390429e25a497bf9f73116d8765f1c8c3e4f8947b |
|
MD5 | 0422127fa388f328681b467386f8943b |
|
BLAKE2b-256 | f41238fa4f1a251df5272125ce3dac6cc4a8497a9dfe19ac0b781ea827e81799 |