Skip to content

Plug-in for QGIS3 to visualise tweets stream on the map canvas using Tweepy and the official Twitter API

License

Notifications You must be signed in to change notification settings

ale-cristofori/Qweetgis

Repository files navigation

Qweetgis

Introduction

Qweetgis is a QGIS 3 plugin that allows the connection to the Twitter API, stream Tweets (their text) and display them on the QGIS map canvas, if they contain geographic coordinates (EPSG:4326), in real time. Qweetgis uses the Twitter streaming API, combining it with asynchronous code execution. This means that the tweets are received continuously in real time and are immediately displayed on the map without locking/freezing the QGIS user interface thread.

Qweetgis is desinged on the base of a QGIS 2 plug-in Geotweet, a project initiated by Riccardo Klinger -Geolicious-

Getting Started Steps - Initial Configuration

Qweetgis uses the Python library Tweepy. The package has to be installed as a third party package in the Python environment used by QGIS, and has to be installed separately before running Qweetgis. To install third party Python packages please follow the instructions below:

For Windows (with OSGEO4W) Option 1 Option 2

If none of the above works then I suggest you download the Tweepy module (in format tar.gz) from here extract the directory containing the module tweepy-3.7.0, in the OSGEO4W directory execute the command p3_env to set Python3 as the global interpreter, navigate to the module direcory and execute python3 setup.py install. This should install Tweepy in your OSGEO4W python. I tested this method and it worked on a Win10 machine.

For Windows (standalone QGIS install) Option 3 -> this worked for me on Windows

For Linux (Debian): QGIS Python is the system one, just do

pip3 install tweepy

Running a desktop Twitter app is not easy for authentication. The connection to the API requires the consumer keys which are unique to each Twitter application and have to be secretly stored, thus making it very difficult for a desktop application to developer ones. On top of it, using a Twitter app requires OAuth authentication which is granted by the user to the application with two tokens generated from Twitter. Though I tried to set up a seamless plug-in authentication for the reasons above you can use Qweetgis only with your own Twitter API developer keys and generated OAuth tokens. To obtain the Twitter developer keys you will have to sign-up for a developer account and create a Twitter App.

Here is how to do it

What Qweetgis can do

From the Twitter Streaming API Qweetgis:

  1. Downloads Tweets and displays them on the QGIS map canvas, retrieving tweet attributes such as status_id, user_name, localization, extended_text, time, place
  2. Filters Tweets Stream by keywords (more then one keyword are searched together in the tweet extended_text attribute field.
  3. Filters Twitter Tweets Stream by location. A search area (Bounding Box) can be defined either with the map canvas extent or using the extent of one layer between those loaded in the QGIS project.
  4. Limits the number of tweets to display/download, the limit can be absolute or continuous. In the first case the Stream listener will close the connection when the limit is reached. In the second case when the limit is reached the listener will continue to stream tweets, removing the tweets from the bottom of the list and adding the new ones as they continue, keeping the same number of tweets specified by the limit.

EXAMPLES

dynamic limited streaming

Geo based streaming

Heatmap visualisation

Keyword Search example

About

Plug-in for QGIS3 to visualise tweets stream on the map canvas using Tweepy and the official Twitter API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published