adamb / google-maps-geocoder
A PHP wrapper for the Google Maps Geocoding API v3.
Requires
- php: >=5.2.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-15 03:06:49 UTC
README
A PHP wrapper for the Google Maps Geocoding API v3.
Developed by Justin Stayton while at Monk Development.
Requirements
- PHP >= 5.2.0
Installation
Composer
The recommended installation method is through
Composer, a dependency manager for PHP. Just add
adamb/google-maps-geocoder
to your project's composer.json
file:
{ "require": { "adamb/google-maps-geocoder": "*" } }
More details can be found over at Packagist.
Manually
- Copy
src/GoogleMapsGeocoder.php
to your codebase, perhaps to thevendor
directory. - Add the
GoogleMapsGeocoder
class to your autoloader orrequire
the file directly.
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 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).
Contributing
- Fork it.
- Create your feature branch (
git checkout -b my-new-feature
). - Commit your changes (
git commit -am 'Added some feature'
). - Push to the branch (
git push origin my-new-feature
). - Create a new Pull Request.