Collect and filter location information from social network services.
There is an optional web UI for GeoDigger here, with some filtering features.
GeoDigger has only been tested on Linux. It may or may not work on Windows or Mac OSX systems.
- Python 2.7
- MongoDB Server >= 2.4.6
- Tweepy >= 2.1
- PyCrypto >= 2.6.1
- PyMongo >= 2.6.3
To install the GeoDigger script and libraries, use:
python setup.py install
Make sure you have a MongoDB server installed and running. Running GeoDigger on the same machine as the database server is easiest, and is recommended.
Obtain all the developer access secrets for the social networks you want to use. (Currently, only Twitter is supported.)
Create a configuration file. See examples/conf/geodigger.conf for an example.
Run the GeoDigger script, passing in the paths to your configuration and log files. GeoDigger will try to create the log file if it does not already exist.
geodigger --conf MY_CONFIG_FILE --log MY_LOG_FILE
usage: geodigger [-h] [--log LOGFILE] [--config CONFIGFILE] [--source SOURCE] [--list [LIST]] Collect and filter location information from social network services. optional arguments: -h, --help show this help message and exit --log LOGFILE file to store logs, default=geodigger.log --config CONFIGFILE geodigger configuration file, default=geodigger.conf --source SOURCE the social network from which to collect data --list [LIST] list available sources report bugs to: https://github.com/rshipp/geodigger/issues
To submit bug reports, use GeoDigger's GitHub issues page.
If you want to add functionality, such as support for a new social network, see the extending section of the GeoDigger documentation. Pull requests are welcome.