GoogleMapsGeocoder

A PHP 5 object-oriented interface to the Google Maps Geocoding API v3.

Developed by Justin Stayton while at Monk Development.

• Documentation
• Release Notes

Requirements

• PHP 5.2.0 or newer.

Getting Started

To start, make sure to add the class to your autoloader or require it directly:

require "GoogleMapsGeocoder.php";

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 GoogleMapsGeocoder object. Either the address can be passed to the constructor:

$Geocoder = new GoogleMapsGeocoder($address);

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

$Geocoder = new GoogleMapsGeocoder();
$Geocoder->setAddress($address);

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).

Feedback

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.