Adding Convert Method

.gitignore

@@ -0,0 +1,19 @@
+lib-cov
+*.seed
+*.log
+*.csv
+*.dat
+*.out
+*.pid
+*.gz
+
+pids
+logs
+results
+
+node_modules
+npm-debug.log
+.DS_Store
+ENV_VARS
+
+public/fb_images/*

README.md

@@ -97,6 +97,16 @@ To set the configuration you call `gm.config(key, value)` or `gm.config({key: va
 
 `google-private-key`- used for setting business specific parameters
 
+# Utilities
+
+Retrieving a JSON blob from google maps can sometimes be a bit messy if you're trying to convert data on the fly. You can use the convert method to change the blob into a goeocode, city, zip, county, state, or country.
+
+    gm.geocode('64111', function(err,data){
+        gm.utils.convert(data, 'state', function(result){
+            util.puts(JSON.stringify(data));
+        });
+    });
+
 -------------
 
 All the googlemaps functions follow this scheme:

lib/googlemaps.js

@@ -11,6 +11,8 @@ exports.setProxy = function(uri) {
   config('proxy', uri);
 };
 
+exports.utils = {}
+
 var _config = {
   'google-client-id': null,
   'stagger-time': 200,
@@ -350,6 +352,67 @@ exports.checkAndConvertPoint = function(input) {
   throw(new Error("Unrecognized input: checkAndConvertPoint accepts Arrays of Numbers and Strings"));
 };
 
+exports.utils.convert = function(data, location, callback) {
+
+  address_blob = data.results[0].address_components
+  full_address = {
+    city      : 'Could not find city',
+    county    : 'Could not find county',
+    state     : 'Could not find state',
+    country   : 'Could not find country',
+    zip       : 'Could not find zip',
+    geo       : 'Could not find geo'
+  }
+
+  if(data.results[0].geometry.location){
+    full_address.geo = data.results[0].geometry.location
+  }
+
+  var component, _i, _len;
+
+  for (_i = 0, _len = address_blob.length; _i < _len; _i++) {
+    component = address_blob[_i];
+    if (component.types[0] === 'locality') {
+      full_address.city = component.long_name;
+    } else if (component.types[0] === 'administrative_area_level_1') {
+      full_address.state = component.long_name;
+    } else if (component.types[0] === 'administrative_area_level_2') {
+      full_address.county = component.long_name;
+    } else if (component.types[0] === 'country') {
+      full_address.country = component.long_name;
+    } else if (component.types[0] === 'postal_code') {
+      full_address.zip = component.long_name;
+    }
+  }
+
+  switch (location) {
+    case 'city'   :
+      callback(full_address.city);
+      break;
+    case 'county' :
+      callback(full_address.county);
+      break;
+    case 'zip'    :
+      callback(full_address.zip);
+      break;
+    case 'state'  :
+      callback(full_address.state);
+      break;
+    case 'country':
+      callback(full_address.country);
+      break;
+    case 'geo'    :
+      callback(full_address.geo);
+      break;
+    case 'all'    :
+      callback(full_address);
+      break;
+    default       :
+      callback(full_address);
+      break;
+  }
+}
+
 //  Wraps the callback function to convert the output to a javascript object
 var returnObjectFromJSON = function(callback) {
   if (typeof callback === 'function') {

test/conversion-test.js

@@ -0,0 +1,41 @@
+var vows = require('vows'),
+  assert = require('assert'),
+  gm = require('../lib/googlemaps');
+
+vows.describe('geocode').addBatch({
+  'Geocode Conversion (Kansas City)': {
+    topic: function(){
+      gm.geocode('64111', this.callback, 'false');
+    },
+    'can convert zip to state': function(err, result){
+      gm.utils.convert(result, 'state', function(data){
+        assert.equal(data , 'Missouri');
+      })
+    },
+    'can convert zip to country': function(err, result){
+      gm.utils.convert(result, 'country', function(data){
+        assert.equal(data , 'United States');
+      })
+    },
+    'can convert zip to geo': function(err, result){
+      gm.utils.convert(result, 'geo', function(data){
+        assert.equal(data.lat , '39.0587452');
+        assert.equal(data.lng , '-94.5985613');
+      })
+    }
+  }
+}).export(module);
+
+
+vows.describe('geocode').addBatch({
+  'ReverseGeocode Conversion (Kansas City)': {
+    topic: function(){
+      gm.reverseGeocode('39.0587452,-94.5985613', this.callback, 'false');
+    },
+    'can convert geo to state': function(err, result){
+      gm.utils.convert(result, 'state', function(data){
+        assert.equal(data , 'Missouri');
+      })
+    }
+  }
+}).export(module);

test/geocode-test.js

@@ -34,6 +34,8 @@ vows.describe('geocode').addBatch({
 }).export(module);
 
 
+
+
 /*  Geocode query results
 {
    "status":"OK",