Export Twitter searches to GeoJSON
Project description
Export geotagged tweets to GeoJSON.
Install
Open your terminal and run:
pip install twittergeo
Usage
To use the tool, you’ll need a application registered with Twitter. Instructions from Twitter: https://apps.twitter.com.
Now that you have an application, you’ll need the consumer key and the consumer secret. Enter them on the command line:
$ KEY=<paste in the key>
$ SECRET=<paste in the secret>
And here’s the command to download a GeoJSON of geotagged tweets:
$ twittergeo --user example_username --consumer-secret $SECRET --consumer-key $KEY -o example_username.geojson
Setting up a config file
Pasting in your consumer key and secret every time is boring. Save a config file like so:
apps:
twittergeo:
consumer_key: ...
consumer_secret: ...
Call the file bots.yaml and save it in your home directory, and twittergeo will find it automatically. Or use a custom file:
$ twittergeo --search "some words" --config bots.yaml -o some_words.geojson
To download a search:
$ twittergeo --search "some words" --consumer-secret $SECRET --consumer-key $KEY > some_words.geojson
Smaller files
Use the --lite option to get smaller files. The only properties saved will be the tweet’s text and ID, and the user’s screen_name and userid.
$ twittergeo --search "some words" --lite > some_words.geojson
Get more tweets
By default, Twitter returns only 15 tweets, which is pretty weak. Use the --count parameter to request more. Note that Twittergeo will return count tweets, but ignore non-geotagged tweets, so your files will likely be much shorter. The Twitter API doesn’t have a way request only geotagged tweets.
$ twittergeo --search "some words" --count 100 > some_words.geojson
Geocode parameter
When using the search option, you can request tweets close to a particular point. The format to use is latitude,longitude,radius, where radius is either in miles (mi) or kilometers (km).
$ twittergeo --search "some words" --geocode 37.781157,-122.398720,1mi -o some_words_a.geojson
$ twittergeo --search "some words" --geocode 37.781157,-74.2644,10km -o some_words_b.geojson
Options
usage: twittergeo [-h] [-c path] [--consumer-key key] [--consumer-secret secret] [-u user | -f search] [--lite] [--count COUNT] [--geocode GEOCODE] [-o OUTPUT] Pull Twitter searches into GeoJSON optional arguments: -h, --help show this help message and exit -c path, --config path path to config file to parse (json or yaml) --consumer-key key Twitter consumer key --consumer-secret secret Twitter consumer secret -u user, --user user User timeline to search -f search, --search search Search string --lite Output minimal information about tweets --count COUNT Maximum number of tweets to return --geocode GEOCODE optional geocode parameter when searching -o OUTPUT, --output OUTPUT output file (default is stdout)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for twittergeo-0.1.0-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7f5c7ec8946535c3698953beff9443e26e53f905b32751ce09b8cc7f013b012f |
|
MD5 | 3d816422fcf0d12a8332af1b3a69b25e |
|
BLAKE2b-256 | a379a48bcb532a8a00ac861db0e325b6b1c32944c9bc0e13feeaf43a24153dc2 |