A PHP wrapper for the Google Maps Geocoding API v3.

v2.1.0 2013-12-29 21:31 UTC

This package is auto-updated.

Last update: 2024-03-29 03:20:26 UTC


Build Status Latest Stable Version Total Downloads

A PHP wrapper for the Google Maps Geocoding API v3.

Developed by Justin Stayton while at Monk Development.


  • PHP >= 5.3.0



The recommended installation method is through Composer, a dependency manager for PHP. Just add jstayton/google-maps-geocoder to your project's composer.json file:

    "require": {
        "jstayton/google-maps-geocoder": "*"

More details can be found over at Packagist.

Getting Started

We'll use the address of Monk Development for this example:

$address = "2707 Congress St., San Diego, CA 92110";

There are two ways to set the address of a Geocoder object. Either the address can be passed to the constructor:

use GoogleMaps\Geocoder\Geocoder;

$Geocoder = new Geocoder($address);

Or the address can be set after the object is created:

use GoogleMaps\Geocoder\Geocoder;

$Geocoder = new Geocoder();

By default, the format is set to json and the sensor is set to false. These values can be changed either through the constructor or after the object is created. See the documentation for the complete list of API parameters that can be changed.

Once all parameters are set, the final step is to send the request to the Google Maps Geocoding API:

$response = $Geocoder->geocode();

The geocode method converts the response into a JSON associative array (default) or SimpleXMLElement object depending on the specified format. See the geocode documentation for making the request over HTTPS or preventing conversion (instead returning the raw plain text response).


Please open an issue to request a feature or submit a bug report. Or even if you just want to provide some feedback, I'd love to hear. I'm also available on Twitter as @jstayton.


  1. Fork it.
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am 'Added some feature').
  4. Push to the branch (git push origin my-new-feature).
  5. Create a new Pull Request.