Google Places

This gem provides a Ruby wrapper around the Google Places API, using HTTParty. At this moment the gem does not support OAuth authentication and will only work with an API key.

Obtaining an API key

To be able to use this gem, you'll need a Google Places API key. To request an API key, point your browser to and follow the instructions there. You'll find your API key on the *API Access* tab under *Simple API Access*.

Installing the gem

To use this gem, install it with gem install google_places or add it to your Gemfile:

gem 'google_places'

And install it with bundle install


The spot

Each of the API methods below returns a GooglePlaces::Spot or a collection of those. Each of these objects has these attributes:

Retrieving a list of spots

First register a new Client:

@client =

Then retrieve a list of spots:

@client.spots(-33.8670522, 151.1957362)

Search by a specific type:

@client.spots(-33.8670522, 151.1957362, :types => 'restaurant')

Search by multiple types:

@client.spots(-33.8670522, 151.1957362, :types => ['restaurant','food'])

Search by multiple types but exclude one type:

@client.spots(-33.8670522, 151.1957362, :types => ['restaurant','food'], :exclude => 'cafe')

Search by multiple types but exclude multiple types:

@client.spots(-33.8670522, 151.1957362, :types => ['restaurant','food'], :exclude => ['cafe', 'establishment'])

Search by name:

@client.spots(-33.8670522, 151.1957362, :name => 'italian')

Search by name and type:

@client.spots(-33.8670522, 151.1957362, :name => 'italian', :types => 'restaurant')

Retrieving a single spot

First register a new Client:

@client =

Then retrieve the spot:'CmRYAAA...upoTH3g')


You're very welcome to add functionality to this gem. To do so, follow these steps:

  1. Fork the project on Github

  2. Clone your own fork on your development machine

  3. Install the dependencies with bundle install

  4. Copy spec/api_key.sample.rb to spec/api_key.rb

  5. Insert your own Google Places API key in spec/api_key.rb

  6. Run the specs with rspec spec

  7. Hackety hack

  8. ???


Feel free to send me a pull request but please make sure your changes are sufficiently covered by RSpec.

Important Note

Concerning the reference field, the Google Places API documentation states:

"You can store this token and use it at any time in future to refresh cached data about this Place,
but the same token is not guaranteed to be returned for any given Place across different searches."

Please be aware that the reference field in spot details may differ from the reference used to retrieve that spot.