Mac OS Version -‐-‐ h$ps://developer.apple.com/downloads/ -‐-‐ Install Homebrew (h>p://brew.sh/) -‐-‐ Run on terminal: ruby -‐e "$(curl -‐fsSL h>ps://raw.github.com/mxcl/homebrew/go)" -‐-‐ Follow h>p://madebyhoundstooth.com/blog/install-‐node-‐with-‐homebrew-‐on-‐os-‐x/ -‐-‐ brew install node NPM will be installed at the same Mme as node! Install NodeJS + NPM
-‐-‐ Download and follow instrucMons Install NodeJS + NPM h>p://nodejs.org/download/ Open Node.js from Start Menu -‐ Programs -‐ Node.js -‐ Node.js Command Prompt Or search for “Node.js Command Prompt” on your system (Windows 8, 8.1)
will need: 1 x Twi>er Account 1 x Developer Key from h=ps://dev.twi=er.com/ Sprinkle with some paMence and Mme and in Mme you’ll be collecMng data from Twi>er. InstrucMons coming up soon a^er a small explanaMon.
"to_user":"TwitterAPI", "from_user":"jkoum", "metadata": { "result_type":"popular", "recent_retweets": 100 }, "id":1478555574, "from_user_id":1833773, "iso_language_code":"nl", ....} } Returns tweets that: • match specified query • located in Lat/Lon box • Historical Tweets • User Profile Information • Return Public Timeline Service is rate limited JSON or Atom Making Requests to Twi=er
-‐-‐ oAuth (More Complex) Most modern day web services use oAuth (including Twi>er and Google Services) Keeps informaMon safe from the wrong people but also allows providers to ban people if they are using too many resources or making.
Click your profile picture (top right corner) and click My Applica8ons Click Create New Applica8on Fill in your details for the app You’ll be presented with your Consumer Key and Consumer Secret Save these keys for the next step Collec8ng Social Media Data (Twi=er) Crea8ng your Twi=er Applica8on Keys
install the following modules used by the collector. Check that you have npm installed by running “npm -‐v” (it should report 1.3.*) Run the following to install npm install oauth colors
that you can run the script from and navigate to that folder in your system terminal. You can edit the locaMon of the collector by changing these values in the file: To run the collector type: node twi=er_collect.js “SearchTag”, “LaMtude”, “Longitude”, “Radius” -‐ NB: “” will return all tweets in that area
is working you should see the following screen Go to the link in a browser, login to twi>er and type the pin number in. Press return and tweets will start collecMng in a file called “tweets.csv” in the same folder.
your map by clicking on “Un8tled Map” Click “Import” and upload your CSV file Click Base Map to change the map style Crea8ng your first Visualisa8on with the Data Collected
the file has uploaded, choose the correct LaMtude and Longitude columns and then click ConMnue. Click the ID field (le^ over) as the marker Mtle and press finish. The updated output file will, hopefully, auto detect the lat/lng fields.
Click on New Map Drag your CSV file onto the Map to upload your data file Click Base Map to change the map style Crea8ng your first Visualisa8on with the Data Collected
the file has uploaded, your data should be automaMcally be Geocoded and displayed on the map. Now you can edit the metadata, view the data contained within the tweets and play with the visualisaMons.