Version 0.2 of the Gargoyle POI
Server (GPS) is now ready.
The latest source code tarball is here: Gargoyle POI Server v0.2
. (Warning, almost no documentation and only basic comments)
But, what is it?
A POI is a Point of Interest
. That is, it is an atomic element of geospatial information. The Gargoyle POI Server is the backend server to the Gargoyle Personal Agent (previously introduced under the name Gargoyle alone).
GPS is written in Python using web.py
as the frontend, and CouchDB
for data storage. Web.py was chosen because it is small, fast, and output format agnostic. CouchDB provides schema-flexible storage and potential scalability. It will also support robust access from many Gargoyle Personal Agents (GPAs) as well multiple Gargoyle Extraction Agent Service (GEAS) instances.
At the moment, the system can output the POIs either in KML
or in rudimentary HTML. The interface chosen is a simple RESTful
interface. At the moment, only
will be implemented soon.
Here is the syntax for using the server once running (to start a server at port 8080 just run
To view the POIs for
in the square created by
If you want it in KML use this:
To add a POI to
with an expiration date on May 1st:
The third number is the Altitude. Optional elements are in italics, and include the altitude, the description, and the expiration date (default is 3 days). The
can really be anything. Ideally, it's just a long-ish hash that can't be easily gussed. This simplifies access, and offers a measure of privacy. For now, if you want your POIs secret, you can encrypt their contents in whatever way you wish. Access control is planned, and will be implemented in a future version.
soon: GeoRSS output for easy Google Maps mashups.
For planned development, look at the upcoming Roadmap post.