geo on SWiK

navigator.geolocation: Using the W3C Geolocation API today

Thu, 28 Aug 2008 18:01:08 -0700

Last week I wrote a simple WhereAreYou? application that used the Google Ajax APIs ClientLocation API to access your location via your IP address.

At the same time, we announced support for the Gears Geolocation API that can calculate your address using a GPS device, WiFi info, cell tower ids, and IP address lookups.

Add to all of that, the W3C Geolocation API that Andrei Popescu of the Gears team is editing. You will notice that it looks similar to the Gears API, with subtle differences. The ClientLocation API is quite different.

To make life easier, I decided to put together a shim called GeoMeta that give you the W3C Geolocation API, and happens to use the other APIs under the hood.

If you have the Geolocation API native in your browser (no one does yet, future proof!) that will be used. If you have Gears, that API will be used, and finally, with nothing the ClientLocation API will be used behind the scenes.

To you the API will look similar:

// navigator.geolocation.getCurrentPosition(successCallback, errorCallback, options)
navigator.geolocation.getCurrentPosition(function(position) {
      var location = [position.address.city, position.address.region, position.address.country].join(', ');
      createMap(position.latitude, position.longitude, location);
}, function() {
      document.getElementById('cantfindyou').innerHTML = "Crap, I don't know. Good hiding!";
});

At least, that is what I would like. Unfortunately, there are a few little differences that leak through.

The W3C API only seems to give you a lat / long, so you have to do the geocoding to get address info
The Gears API gives you an additional gearsAddress object attached to the resulting position object. This can contain a lot of information on the resulting area (street address to city to ...) however for certain providers the API returns that as null, the same as the W3C standard
That gearsAddress object has slightly different information from the address data that the ClientLocation API returns. NOTE: I would love to see this just called 'address' to help the shim.

To give you control when you need it, you can ask the navigator.geolocation object what type it is. navigator.geolocation.type will be null if it is native, but 'Gears' or 'ClientLocation' if a shim kicks in. You can also check navigator.geolocation.shim to see if it is augmented code.

Implementation

There is some fun implementation code in there if you poke around. For example, for the ClientLocation API, when you make a call, it will be added to a queue if the Google Loader hasn't fully loaded yet, and it will kick off that call when finished. Dealing with dynamically creating <script src> as a loading mechanism sure is fun!

I like the idea of jumping straight to the W3C standard and updating the shim as the APIs change. That way, when browsers catch up, the code will still work using the native APIs and you don't have to change a thing.

I also hope that we get general reverse geocoding in place, which would enable me to even take the native "standard" and strap on useful address info to the bare bones lat/long.

Dear Aunt TUAW: iPhone 3G and GPS - The Unofficial Apple Weblog (TUAW)

Tue, 19 Aug 2008 13:29:33 -0700

"This exact thing happened to me at Siggraph last week, only my iPhone thought it was in Japan. Then I realized that there was probably some piece of gear at the art show that came from Japan. Sure enough, got far enough away from the art show and suddenly I'm back in LA."

Graphserver - The Open-Source Multi-Modal Trip Planner

Mon, 18 Aug 2008 02:06:07 -0700

[from rozza] GeoNames

Sun, 17 Aug 2008 13:04:49 -0700

Flickr taps into open source for better maps. Yahoo Maps to follow? | Webware : Cool Web apps for everyone - CNET

Sun, 17 Aug 2008 03:05:44 -0700

GeoJSON -- JSON Geometry and Feature Description

Sat, 16 Aug 2008 17:13:08 -0700

QGIS Community

Sat, 16 Aug 2008 17:10:02 -0700

Flickr taps into open source for better maps. Yahoo Maps to follow? | Webware : Cool Web apps for everyone - CNET

Sat, 16 Aug 2008 16:08:31 -0700

GeoNames webservice and data download

Sat, 16 Aug 2008 14:11:01 -0700

GeoDjango - Django Code - Trac

Sat, 16 Aug 2008 13:09:59 -0700

W3C Semantic Web Interest Group: Basic Geo (WGS84 lat/long) Vocabulary

Fri, 15 Aug 2008 05:05:19 -0700

uDig : Home

Thu, 14 Aug 2008 13:12:41 -0700

Flickr taps into open source for better maps. Yahoo Maps to follow? | Webware : Cool Web apps for everyone - CNET

Thu, 14 Aug 2008 07:05:39 -0700

PosiMotion - Here You Go... G-Park Information

Thu, 14 Aug 2008 02:05:30 -0700

OpenStreetMap

Thu, 14 Aug 2008 01:05:05 -0700

Search Geo-Data With Finder. Sneak Peak At GeoCommons (Map) Maker. // TechCrunch

Thu, 14 Aug 2008 01:05:04 -0700

API - XML - WunderWiki - Wunderground Weather

Thu, 14 Aug 2008 00:05:25 -0700

Free weather information api for your web site and projects.

Submit Your Geo Content to Google - KML - Google Code

Wed, 13 Aug 2008 15:05:24 -0700

[from thierrylach] Dundas Map for .NET kicks up geographic visualization

Wed, 13 Aug 2008 09:04:26 -0700

iphone-google-maps-component - Google Code

Wed, 13 Aug 2008 05:05:20 -0700

A Google Maps Component for Cocoa Touch

GeoJSON -- JSON Geometry and Feature Description

Sat, 09 Aug 2008 13:12:10 -0700

KML Tutorial - KML - Google Code

Sat, 09 Aug 2008 09:10:49 -0700

Mapstraction and Geokit | Ninja's on a Penny Farthing

Thu, 07 Aug 2008 13:22:29 -0700

MapServer 5.x Tutorial

Wed, 23 Jul 2008 06:52:21 -0700

OSGeo.org | Your Open Source Compass

Tue, 22 Jul 2008 13:51:47 -0700

AoP for Geospatial Data, via Weber " Into The Pudding

Tue, 22 Jul 2008 06:51:57 -0700

GeoDjango

Tue, 22 Jul 2008 06:51:55 -0700

The GIS branch intends to be a world-class geographic web framework. Our goal is to make it as easy as possible to build GIS web applications and harness the power of spatially enabled data.

GeoNames

Tue, 22 Jul 2008 00:52:12 -0700

Free to use geo mapping database

Flagfox :: Firefox Add-ons

Mon, 21 Jul 2008 18:51:36 -0700

Python Package Index : geojson 1.0b1

Mon, 21 Jul 2008 17:55:28 -0700