Rana share server

From OpenStreetMap Wiki
Jump to navigation Jump to search

an implementation of the Pyroute share server idea.

Website

http://dev.openstreetmap.org/~ojw/pos/

Source code

http://svn.openstreetmap.org/sites/other/ranaShareServer/

That includes a database schema, and a document talking about the database concepts

Concepts

To create a user account on the server, specify a PIN that will be your password, and it will return a user ID.

To create a group, specify the name, and two PINs:

  • read PIN - anyone who knows this will be able to view the position of people in the group
  • write PIN - anyone who knows this will be able to publish their position info on the group

To make a group public, set read PIN to 0

To upload your position, send your own ID/PIN, the group number to publish to, and the group's write PIN. You must publish "to a group" (create one if necessary)

To set your nickname within a group, send your own ID/PIN, the group number this nickname applies to, and the group's write PIN. So you can publish to several groups using several identities, using the same user account.

To download a group, send the group number and the group's read PIN. It will return a list of User,Lat,Lon. If someone didn't set a nickname they will be 'anon'.

API

Uhh, read the website source code is easiest probably...

or use the website and examine the GET queries it generates for each action

Rana module

There is a rana module to interact with this server.

http://svn.openstreetmap.org/applications/mobile/rana/modules/mod_shareServer.py

Future work

See http://svn.openstreetmap.org/sites/other/ranaShareServer/roadmap.txt