jstayton/google-maps-geocoder

A PHP wrapper for the Google Maps Geocoding API v3.

Tuesday, November 10, 2015
by jstayton
Repository
5 Watchers
108 Stars
212,331 Installations

PHP
5 Dependents
0 Suggesters
54 Forks
7 Open issues
9 Versions
9 % Grown

The README.md

NOTICE: This project is deprecated and no longer maintained. If you'd like to continue supporting a forked version, please reach out on Twitter (@kidjustino) to have it listed here., _(*1)

GoogleMapsGeocoder

, _(*2)

A PHP wrapper for the Google Maps Geocoding API v3., _(*3)

Developed by Justin Stayton while at Monk Development., _(*4)

Requirements

PHP >= 5.2.0

Installation

Composer

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:, _(*5)

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

More details can be found over at Packagist., _(*6)

Manually

Copy src/GoogleMapsGeocoder.php to your codebase, perhaps to the vendor directory.
Add the GoogleMapsGeocoder class to your autoloader or require the file directly.

Getting Started

We'll use the address of Monk Development for this example:, _(*7)

$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:, _(*8)

$Geocoder = new GoogleMapsGeocoder($address);

Or the address can be set after the object is created:, _(*9)

$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., _(*10)

Once all parameters are set, the final step is to send the request to the Google Maps Geocoding API:, _(*11)

$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)., _(*12)

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 @kidjustino., _(*13)