mattisg/locate

A MooTools interface over W3C's Geolocation API, allowing for MooTools-style events listening and masking cross-browser API differences.

Locate

With Locate you can easily access a visitors geolocation if his browser supports this feature. The basic geolocation API is a bit complicated (check W3C Geolocation API Specification for more info) in my oppinion. I hope I can make it easier to handle with all the data by using this little MooTools class. There are so many possibilities by using location based information in your webapp.

Now you can build your own Google Buzz clone with MooTools power. Let me know on how you used it in your webapplication.

How to use

Include the Locate.js in your project.

Use Code like this:

#JS
var location = new Locate({
	onLocate: function(position){
		alert('latitude: ' + position.latitude, '; longitude: ' + position.longitude + '; accuracy: ' + position.accuracy);
	}
});

See below for more details about position fields.

Want to frequently get the position (watch your visitor move)?

#JS
var location = new Locate({
	loiType: 'watch',
	onLocate: function(position){
		// Do stuff with the position data
	}
});

Don't want to locate directly on initializing the Class? No problem!

#JS
var location = new Locate({
	loi: false
});

// start locating later in your code using this line
// you can also use location.watcher();
location.locate();

Want to get the distance from the current position to another? No problem, the function distanceTo() returns the distance in km:

#JS
var location = new Locate({
	loiType: 'watch',
	onLocate: function(position){
		$("distance").set('html', this.distanceTo(37.3316591, -122.0301778));
	}
});

Position data

The position data given with the event 'locate' looks like this:

• position.latitude
• position.longitude
• position.altitude
  • null if not supported, meters above the WGS84 ellipsoid
• position.accuracy
  • specified in meters
• position.altitudeAccuracy
  • specified in meters
• position.heading
  • null if not supported, specified in degrees counting clockwise to true north
• position.cardinalDirection
  • not part of the official W3C specifications!
  • can be null
  • returns the heading direction as string (cardinal direction): "N", "NE", "E" etc.
• position.speed
  • null if not supported, specified in meters per second

If you use Locate.Extras, you can also use

• position.address
  • returns your current address based on GMaps
  • If you want to use this feature, use this.address() within the onLocate function
  • You have to use the watcher method atm, working on a fix

ToDo

• make position.address work without watcher method
• find an alternative to GMaps