Google Places API - A PHP wrapper
, (*1)
, (*2)
This is a PHP wrapper for Google Places API Web Service., (*3)
Installation
Composer
The recommended installation method is through Composer. Add to your composer.json file:
``` json
{
"require": {
"peoplegogo/google-places": "~1.0"
}
}, (*4)
or with the following command from your browser:
composer require peoplegogo/google-places, (*5)
Check [in Packagist](https://packagist.org/packages/peoplegogo/google-places).
### Manually
Steps:
- Copy src/GooglePlaces.php to your codebase, perhaps to the vendor directory.
- Add the GooglePlaces class to your autoloader or require the file directly.
## Getting Started
First you have to create an instance of GooglePlaces:
``` php
$google_places = new GooglePlaces();
You can pass the API key (used to authenticate in front of Google service) during the creation of the instance or you can set it up later.
``` php
$google_places = new GooglePlaces($apiKey);, (*6)
or
``` php
$google_places = new GooglePlaces();
$google_places->setApiKey($apiKey);
By default, the format is set to json but you can change it that way:
``` php
$google_places = new GooglePlaces($apiKey, $format);, (*7)
or
``` php
$google_places->setFormat($format);
You can also set up the language if you want.
``` php
$google_places->setLanguage($language_code);, (*8)
In this way it won't be necessary to set up the language within every request.
You can also prepare the input parameters:
``` php
$params = [
'input' => 'Vict',
'types' => '(cities)',
'language' => 'pt_BR'
];
Once all parameters are set, the final step is to send the request to the Google Places Api:
php
$results = $google_places->getAutocomplete($params);
, (*9)
The result is an array. The GooglePlaces class decodes the response received from Google, so it is not necessary for you to do that., (*10)
For more information for the methods and the features of the library you can check "src" or "tests" folders., (*11)
Contributing
How can you contribute:, (*12)
- 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.