2017 © Pedro Peláez
 

library php-googleplaces

PHP Wrapper for the Google Places API

image

joshtronic/php-googleplaces

PHP Wrapper for the Google Places API

  • Monday, May 29, 2017
  • by joshtronic
  • Repository
  • 11 Watchers
  • 60 Stars
  • 27,171 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 35 Forks
  • 4 Open issues
  • 4 Versions
  • 6 % Grown

The README.md

php-googleplaces

Build Status Coverage Status Downloads Gittip, (*1)

PHP Wrapper for the Google Places API., (*2)

Origins

Simply put, when I Googled “php google places” I was presented with Google-Places---PHP-. I attempted to use it, and it was fine as I was able to make it work, but there seemed to be a huge assumption that you already knew a lot of the quirks of the Google Places API., (*3)

I did not fit into this assumption and set out to built my own wrapper with a heavy focus on sanity checking inputs, utilizing the magical parts of PHP (reads: you interact directly with the object as you would the API) and avoiding setter methods as they were put here by the devil., (*4)

I opted not to fork because I was going to change too much and I highly doubt my pull requests would have even been accepted., (*5)

Installation

The preferred installation is via composer. First add the following to your composer.json, (*6)

"require": {
    "joshtronic/php-googleplaces": "dev-master"
}

Then run composer update, (*7)

Usage

Getting started

$google_places = new joshtronic\GooglePlaces('_YOUR_API_KEY_');

Search nearby, ranked by prominence

$google_places->location = array(-33.86820, 151.1945860);
$google_places->radius   = 800;
$results                 = $google_places->nearbySearch();

Search nearby, ranked by distance

$google_places->location = array(-33.86820, 151.1945860);
$google_places->rankby   = 'distance';
$google_places->types    = 'restaurant'; // Requires keyword, name or types
$results                 = $google_places->nearbySearch();

Second page of search nearby results

$google_places->pagetoken = $results['next_page_token'];
$page2_results            = $google_places->nearbySearch();
$google_places->location = array(-33.86820, 151.1945860);
$google_places->radius   = 800;
$google_places->types    = 'restaurant'; // Requires keyword, name or types
$results                 = $google_places->radarSearch();

Place details

$google_places->reference = '#reference#'; // Reference from search results
$details                  = $google_places->details();

The Future

The project that I created this library for is now defunct so I’m not actively using it or hacking on it. That being said, if there’s something you want to see included or you find a bug, just open an issue or grow a pair and fork, hack and send a pull request ;), (*8)

The Versions

29/05 2017

dev-development

dev-development https://github.com/joshtronic/php-googleplaces

PHP Wrapper for the Google Places API

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

api google places

20/09 2014

dev-master

9999999-dev https://github.com/joshtronic/php-googleplaces

PHP Wrapper for the Google Places API

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

api google places

20/09 2014

1.0.0

1.0.0.0 https://github.com/joshtronic/php-googleplaces

PHP Wrapper for the Google Places API

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

api google places

20/09 2014

dev-unit-tests

dev-unit-tests https://github.com/joshtronic/php-googleplaces

PHP Wrapper for the Google Places API

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

api google places