Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Geo is a very basic, but simple and in-progress, geo library for Node.js using Google's Geocode API (V3) for Geocoding and GeoHash for GeoSpatial support.
JavaScript
branch: master

This branch is 12 commits behind feliperazeek:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
lib
LICENSE
README.md
app.js
package.json

README.md

Geo for Node.js

by Felipe Oliveira (http://twitter.com/_felipera)

Geo is a very basic, but simple, geo library for Node.js using Google's Geocode API (V3) for Geocoding and GeoHash for GeoSpatial support.

Installation

    npm install geo

Usage - Geocode

    var geo = require('geo');

    var address = '885 6th Ave #15D New York, NY 10001';
    var sensor = false;
    geo.geocoder(geo.google, address, sensor, function(formattedAddress, latitude, longitude) {
        console.log("Formatted Address: " + formattedAddress);
        console.log("Latitude: " + latitude);
        console.log("Longitude: " + longitude);
    });

    // Reverse Geocoding also works
    var latlong = { 'latitude': 52.5112, 'longitude': 13.45155};
    geo.geocoder(geo.google, latlong, sensor, function(formattedAddress, latitude, longitude) {
        console.log("Formatted Address: " + formattedAddress);
        console.log("Latitude: " + latitude);
        console.log("Longitude: " + longitude);
    });

Usage - GeoHash

    // First define a model instance
    var model = {'address': '885 6th #15D, New York, NY 10001', 'baths': '1', 'beds': '1'};

    // Define callback that gets the location (from a single field, multiple fields, whatever) from the model instance (model can be anything, DB class, JSON, array)
    var locationGetterCallback = function(model) { return model['address']; };

    // Define callback that will augment the model instance with geo information such as latitude, longitude and geohash
    var geoSetterCallback = function(model, latitude, longitude, hash, callback) { 
        console.log('Geo Hash: ' + hash); 
        model['latitude'] = latitude; 
        model['longitude'] = longitude; 
        model['geohash'] = hash; 
        callback( model ); 
    };

    // Now let's see what happens with the model
    geo.geomodel(model, locationGetterCallback, geoSetterCallback, function(model) {
        console.log("Model: " + model['address'] + ', Geo: ' + model['geohash']);
    }); 

More Information on GeoHash

  1. See it in action at http://openlocation.org/geohash/geohash-js/.

  2. Go understand how it works at http://en.wikipedia.org/wiki/Geohash and http://hitching.net/2009/11/10/scalable-fast-accurate-geo-apps-using-google-app-engine-geohash-faultline-correction/.

Something went wrong with that request. Please try again.