Project

lieu

0.0
No commit activity in last 3 years
No release in over 3 years
Simple Ruby wrapper for the Google places API.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.0

Runtime

~> 1.8.0
~> 1.8.0
~> 0.8.8
~> 2.0.5
 Project Readme

Lieu

The word lieu originally comes from the Latin locus, meaning place, and its meaning has stayed true to its origins ever since.

Simple Ruby wrapper for the Google Places API.

Current version: Gem Version

Build status:        Build Status

Code metrics:      Code Climate Coverage Status

Ruby support:

  • 1.9.2
  • 1.9.3
  • 2.0.0

Installation

Install via Rubygems

gem install lieu

or add to your Gemfile

gem 'lieu'

Configuration

API methods are available as module methods

Lieu.configure do |c|
  c.api_endpoint = 'http://newendpoint/'
  c.api_key = 'YOUR_API_KEY'
  c.sensor = true
end

or as client instance methods

Lieu::Client.new(
	api_endpoint: 'http://newendpoint/',
	api_key: 'YOUR_API_KEY',
	sensor: true
)

The sensor parameter can be set globally (default to false) or can be provided for every request by passing the optional parameter sensor: true.

Authentication

Lieu only supports authentication via an API key.

You can request one following these steps.

Usage

place = Lieu.details('CmRYAAAA...')
puts place.name
# => "Google Sydney"

places = Lieu.text_search('Google Sydney')
places.first.formatted_address
# => "529 Kent Street, Sydney NSW, Australia"

# etc…

Features

Lieu supports all the Google Places API methods:

Complete Lieu public API's documentation here.

Similar libraries

Versioning

Lieu follows the principles of semantic versioning.

  1. Patch level releases contain only bug fixes.
  2. Minor releases contain backward-compatible new features.
  3. Major new releases contain backwards-incompatible changes to the public API.

Contributing

Pull Requests are welcome !

Please refer to the Contributing guide for more details on how to run the test suite and to contribute.

Copyright

Copyright © 2013 Aylic Petit

Released under the terms of the MIT licence. See the LICENSE file for more details.