peoplegogo/google-places

A PHP wrapper for the Google Places API.

1.0.3 2016-04-03 12:57 UTC

This package is not auto-updated.

Last update: 2024-03-16 16:30:41 UTC


README

Latest Stable Version License Build Status

Logo of Google Places API Web Service

This is a PHP wrapper for Google Places API Web Service.

Installation

Composer

The recommended installation method is through Composer. Add to your composer.json file:

{
    "require": {
        "peoplegogo/google-places": "~1.0"
    }
}

or with the following command from your browser:

composer require peoplegogo/google-places

Check in Packagist.

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:

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

$google_places = new GooglePlaces($apiKey);

or

$google_places = new GooglePlaces();
$google_places->setApiKey($apiKey);

By default, the format is set to json but you can change it that way:

$google_places = new GooglePlaces($apiKey, $format);

or

$google_places->setFormat($format);

You can also set up the language if you want.

$google_places->setLanguage($language_code);

In this way it won't be necessary to set up the language within every request.

You can also prepare the input parameters:

$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:

$results = $google_places->getAutocomplete($params);

The result is an array. The GooglePlaces class decodes the response received from Google, so it is not necessary for you to do that.

For more information for the methods and the features of the library you can check "src" or "tests" folders.

Contributing

How can you contribute:

  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.