geocoder-php/Geocoder — pull request #386 by willdurand (2014-12-21 22:06:32+00:00)
Title: Introduce AddressCollection class

I think that this could be interesting since we always return a set of
results rather than only one result. Having a class rather than relying
on the `array` primitive type since a bit more robust, and makes the API
more fluent:

// Before:
$addresses = $geocoder->geocode('foobar');
$address = empty($addresses) ? null : reset($addresses);

// After:
$address = $geocoder->geocode('foobar')->first();

WDYT?