Citygrid

This is a Ruby wrapper for the CityGrid API.

Installation

As a gem:

sudo gem install citygrid

As a plugin (in your Rails directory:

script/plugin install git://github.com/phuphighter/citygrid.git

Get a Citygrid API key

Sign up for a CityGrid API key: http://developer.citysearch.com/member/register

Usage

Instantiate a client

>> citygrid = Citygrid::Client.new(:api_key => 'your_api_key')

or configure once

>> Citygrid.configure do |config|
>>   config.api_key = 'your_api_key'
>> end
>> citygrid = Citygrid::Client.new

Examples

>> spot = citygrid.search_locations(:what => "roots coffee", :where => "76180", :rpp => 1)
>> spot.results.location.name
=> "Roots Coffeehouse"

>> profile = citygrid.profile(:listing_id => '613027480', :client_ip => 'any_client_ip')
>> profile.locations.location.categories
=> <#Hashie::Mash category=<#Hashie::Mash name="Coffeehouses" nameid="1726" parent="Restaurants" parentid="1722">>

You can search for locations and events, get reviews, and get business profiles.

Contact me if you have any suggestions and feel free to fork it!

Copyright (c) 2009 Johnny Khai Nguyen, released under the MIT license