All Versions
Latest Version
Avg Release Cycle
155 days
Latest Release
687 days ago

Changelog History
Page 2

  • v3.0.0-alpha1 Changes

    December 18, 2014


    I am proud to announce that we are ready to ship the next major version of Geocoder: 3.0.0. This is a pre-release which will help us ensure everything works smoothly. We are currently working hard on making Geocoder related projects compatible with this new version, hence the need for a pre-release version.

    Basically, we changed almost everything in this library but its simplicity and its robustness have been kept. Since 2012, Geocoder provides a powerful API to perform geocoding actions in PHP. However, things in PHP evolved a lot, and we decided to refactor the lib to be more flexible , and even more powerful.

    ๐Ÿ”ง For instance, providers are now highly configurable and Geocoder leverages a third-party library implementing PSR-7.

    โšก๏ธ Update: the main idea behind this was to introduce a dependency to PSR-7 interfaces, and to avoid the NIH syndrom. The http-adapter library is a great one, and Geocoder is not about dealing with HTTP, it is about geocoding stuff.

    Geocoder 3.0.0 contains less code than previously, 49 classes, 5 interfaces and less than 5300 lines of code for the code (tests are not included here). As a matter of fact, Geocoder 2.x has 56 classes and 6500 lines of code. Removing code was a challenge as we did not want to remove features from this library. We rather re-organized Geocoder to fit its initial goal: providing a simple yet powerful way to geocode street and IP addresses, with the ability to switch from one provider to another with ease. Geocoder Extra contains alternative providers that are not worldwide and therefore less used. Again, we did not remove anything.

    ๐Ÿ†• New features have been added, such as the TimedGeocoder implementation and a better model layer. You will find all details in the CHANGELOG below.

    ๐Ÿ“š The documentation, which has been rewritten, also contains a description of Geocoder's versioning strategy, and we are proud to have a Contributor Code of Conduct, because the lack of diversity in Open Source is not acceptable.

    Help us making Geocoder 3.0.0 really stable by giving this very first pre-release a try!

    Last but not the least, THANK YOU to all contributors!!! ๐Ÿ’› ๐Ÿ’™ โค๏ธ ๐Ÿ’š ๐Ÿšข โญ๏ธ ๐ŸŒŸ๐Ÿ’™ ๐ŸŒ  ๐Ÿ’

    Let's celebrate now!

    Full Changelog

    • โž• Added: using() method now throws an exception if provider not found
    • โž• Added: new Result classes (Address, Bounds, Region, Country, County, Coordinates)
    • โž• Added: new named exceptions
    • โž• Added: better exception messages
    • โž• Added: new HTTP layer thanks to egeloen/http-adapter library
    • โž• Added: TimedGeocoder implementation (works with StopWatch Symfony component)
    • โž• Added: AbstractHttpProvider (extending AbstractProvider)
    • โž• Added: provide a way to use IpInfoDB country precision
    • โž• Added: cached responses for BingMaps provider (tests)
    • โž• Added: cached reponse for GoogleMaps provider (tests)
    • โž• Added: ProviderAggregator (replacing the former Geocoder class)
    • โž• Added: ability to change providers locale at runtime
    • ๐Ÿ“š Documentation: almost entirely rewritten
    • ๐Ÿ“š Documentation: a note on versioning has been added
    • ๐Ÿ“š Documentation: a Contributor Code of Conduct has been added for the entire
      Geocoder project
    • ๐Ÿ›  Fixed: phpdoc, wording
    • ๐Ÿ›  Fixed: providers are now highly configurable, even at runtime
    • ๐Ÿ›  Fixed: FreeGeoIp property because of an API change
    • ๐Ÿšš Moved: IGN OpenLS provider to geocoder-extra (#339)
    • ๐Ÿšš Moved: OIORest provider to geocoder-extra (#336)
    • ๐Ÿšš Moved: provider to geocoder-extra (#338)
    • ๐Ÿšš Moved: provider to geocoder-extra (#337)
    • ๐Ÿšš Moved: DataScienceToolkit provider to geocoder-extra (#340)
    • ๐Ÿšš Moved: Baidu provider to geocoder-extra (#341)
    • ๐Ÿšš Moved: IpGeoBase provider to geocoder-extra (#342)
    • ๐Ÿ“‡ Renamed: properties such as:
      • city => locality
      • cityDistrict => subLocality
      • zipcode => postalCode
    • ๐Ÿ”จ Refactored: dumpers (remove Interface suffix, define a new method signature)
    • ๐Ÿ”จ Refactored: class names!
    • ๐Ÿ”จ Refactored: all providers now implement the Geocoder interface
    • ๐Ÿ”จ Refactored: exception messages are a bit more verbose
    • โœ‚ Removed: Provider, Dumper, Interface, and Exception suffixes
    • โœ‚ Removed: autoload.php file
    • โœ‚ Removed: OpenStreetMapsProvider class (#335)
    • โœ‚ Removed: HTTP adapters layer
    • โœ‚ Removed: the Geocoder class does not exist anymore and has been replaced by
      the ProviderAggregator class
  • v2.8.2 Changes

    January 07, 2015
    • ๐Ÿ›  Fixed: encoding issue for maxmind provider
  • v2.8.1 Changes

    December 08, 2014
    • ๐Ÿ›  Fixed: freegeoip zip_code property because of an API change
  • v2.8.0 Changes

    October 03, 2014
    • โž• Added: Allow for greater flexibility in setting curl parameters by passing in an array.
    • โœ‚ Removed: GeoIP2 Omni support
    • โœ‚ Removed: Cloudmade provider. They discontinued their service Apr/2014
  • v2.7.0 Changes

    September 14, 2014
    • ๐Ÿ†• Added: new provider: OpenCageProvider
    • ๐Ÿ›  Fixed: MapQuestProvider when no relevant data are fetched
    • ๐Ÿ›  Fixed: Ensure mb formatString is congruent to standard ucwords() functionality
  • v2.6.0 Changes

    September 02, 2014
    • โž• Added: region and regionCode to GeoIP2Provider
    • โž• Added: throw InvalidCredentialsException with GoogleMapsBusinessProvider
    • โž• Added: support in MapQuestProvider for licensed endpoints (#318)
    • โž• Added: it is now possible to set the user agent in CurlHttpAdapter
    • ๐Ÿ›  Fixed: google maps provider test
    • ๐Ÿ›  Fixed: GeoPlugin returns 206 for anonymous proxies
    • โœ‚ Removed: Google's sensor parameter
    • โšก๏ธ Updated: Travis-CI config, doc, tests
  • v2.5.0 Changes

    May 16, 2014
    • โž• Added: ability to set timeouts for CurlHttpAdapter
    • โž• Added: support for a Google Maps API key
    • โž• Added: premium support to GeocoderCaProvider + tests
    • โž• Added: test against hhvm-nightly on Travis-CI
    • ๐Ÿ“š Updated: documentation
  • v2.4.2 Changes

    January 05, 2014
    • ๐Ÿ›  Fixed: GeoIPs provider expects a single location response due to recent API changes (#283).
  • v2.4.1 Changes

    December 16, 2013
    • ๐Ÿ›  Fixed: MapQuestProvider now works with API keys
    • ๐Ÿ›  Fixed: ProviderInterface (bad argument name)
  • v2.4.0 Changes

    December 12, 2013
    • โž• Added: MapQuest ApiKey required for open services
    • โœ‚ Removed: unused class constants
    • โœ‚ Removed: deprecated class that is not used anymore since 2.0.0