apollo/README.md

Apollo

A GeoRSS aggregator and augmented reality server for Layar

© 2012 Adrian Short and Charlotte Gilhooly at Headline Data

This software was commissioned by Talk About Local as part of the HypARlocal project.

HypARlocal is funded by NESTA and the Nominet Trust.

What it does

• Periodically pulls from a list of subscribed GeoRSS feeds into a local database
• Serves requests from Layar in JSON format for posts (points of interest) within a radius of a specified point.

Requirements

• Rails 3
• MongoDB
• MongoMapper
• Feedzilla

Installation

Before installing/deploying:

$ export APOLLO_HOSTNAME=example.org

On Heroku:

$ heroku config:add APOLLO_HOSTNAME=example.org

Replace example.org with your own hostname. When running locally this will probably be localhost:3000.

Set up a cron job or other scheduler to run

$ rake get_all_feeds

once per hour or to taste.

Now create yourself a user account from the console:

$ rails c
> User.create :email => "me@example.org", :password => "verysecret", :password_confirmation => "verysecret"