Make it possible to track tweets based on location(s)

[JonasDoebertin]

This adds a wrapper around Phirehose::setLocations($boundingBoxes) called PublicStream::whenFrom($boundingBoxes, $callback).

This allows you to track Tweets by location filtered by one or more bounding boxes.

Track all tweets from San Francisco or New York:

PublicStream::create($accessToken, $accessTokenSecret, $consumerKey, $consumerSecret)
    ->whenFrom([
        [-122.75, 36.8, -121.75, 37.8], // San Francisco
        [-74, 40, -73, 41],             // New York
    ], function(array $tweet) {
        echo "{$tweet['user']['screen_name']} just tweeted {$tweet['text']} from SF or NYC";
    })->startListening();

Track all tweets with a location (from all over the world):

PublicStream::create($accessToken, $accessTokenSecret, $consumerKey, $consumerSecret)
    ->whenFrom([
        [-180, -90, 180, 90] // Whole world
    ], function(array $tweet) {
        echo "{$tweet['user']['screen_name']} just tweeted {$tweet['text']} with a location attached";
    })->startListening();

[freekmurze]

Nice, could you also add an example to the readme?

[JonasDoebertin]

Sure! Coming up later...

[JonasDoebertin]

I have added the above examples to the readme. Sorry for being so late.

[freekmurze]

No need to be sorry, there are no deadlines for contributors. Thanks for investing your time in this package.

[freekmurze]

Thanks!