Richard Keen’s blog

Last June a number of Multimap developers had a fantastic time at the BBC Yahoo! HackDay event, our own Andy Hume and ex-Multimapper Richard Rutter even won the award for “Most useful” hack.

This year we’re really excited to be one of the sponsors of the 2008 event, Mashed. We’ve taken the opportunity to refresh our free Open API offering in time for the event with some really cool additions. These include access to our REST APIs for geocoding, directions and POI search (including geo-tagged Wikipedia articles), high-resolution aerial and Bird’s Eye imagery from our friends at Microsoft Virtual Earth and lots more.

In the spirit of the event we’ve also been burning the midnight oil and, fingers crossed, will have a few last-minute goodies which we’ll link to from http://multimap.com/mashed08.

One such late addition is a transformation API for British National Grid Reference co-ordinates. We’ve noticed some of our Open API developers have geodata with grid references or eastings and northings which they’d like to convert to latitudes and longitudes to use with our JavaScript API. Although there are client-side conversion algorithms available we are able to provide a higher accuracy conversion server-side, taking into account the National Grid Transformation OSTN97 linear shifts.

Converting from British National Grid via the REST API

Our REST API supports single or multiple eastings (x) and northings (y) pairs or grid references and JSON, XML and KML output formats. The following examples convert two co-ordinate pairs and a grid reference:

JSON output: http://developer.multimap.com/API/convert/1.2/[apikey]?output=json&system=osng&x1=523000&y1=212324&x2=323000&y2=212324&grid3=NN166712

XML output: http://developer.multimap.com/API/convert/1.2/[apikey]?output=xml&system=osng&x1=523000&y1=212324&x2=323000&y2=212324&grid3=NN166712

KML output: http://developer.multimap.com/API/convert/1.2/[apikey]?output=kml&system=osng&x1=523000&y1=212324&x2=323000&y2=212324&grid3=NN166712

Converting from British National Grid via the JavaScript API

The JavaScript Open API provides a convenient wrapper to the REST API for client-side use. The MMConverter object will take an array of MMPoint objects, and via a callback mechanism returns an array of MMLocation objects, for example:

var locations = new Array();

locations.push(new MMPoint(523000,212324));  // OSTN97 OS National Grid co-ords
locations.push(new MMPoint(323000,212324));
locations.push(new MMPoint(423000,212324));

var funcRef = convertResultsLoaded;
var converter = new MMConverter( funcRef );
converter.convert(locations, ‘gb’);

function convertResultsLoaded() {
    console.log(converter.result_set);
}

Please feel free to come and find me or my colleagues at Mashed (look out for people wearing the fetching black Multimap t-shirts) if you have any questions about the Multimap or Virtual Earth APIs or location data and services in general.

Happy hacking!

I’m extremely pleased to report that Multimap has opened up its Javascript API to the general development community, to encourage innovation and experimentation on top of our best-of-breed draggable mapping, geocoding and routing services. We’re very proud of the breadth and depth of functionality available in the API, some highlights of which include:

• Automatic de-cluttering and aggregation of markers
• A full suite of customisable interface widgets, including a dynamic ‘where am I?’ location hierarchy, and customisable right-click context menus
• Global high-quality geocoding
• Multi-point and multi-modal (e.g., drive to here, then walk to here) routing with highway avoidance option

You can sign-up for a Multimap Open API key over here, or if you want to play with some demos, head over to the interactive documentation.

The Multimap API is fully supported through the Mapstraction abstraction library, so if you want to avoid coding directly to our API that option is available to you. Of course if you’ve developed against another API using Mapstraction, you’ve now got a new, feature-rich option available to you.

One feature of the Open API product that I’m particularly excited about is seamless integration of the grassroots Free the Postcode UK postcode database through our geocoding service, to supplement the partial postcode geocoding available through our TeleAtlas data.

I look forward to linking to some cool mash-ups and sites built on the Multimap Open API!

I’m really looking forward to attending the first Yahoo! Hack Day to be held in London, along with a few of my Multimap colleagues. It would be nice to do something non-mapping related for a change, but if you’re going along and are interested in hacking on the Multimap API’s mapping, geocoding, routing or spatial/non-spatial searching features, please drop me an e-mail on richard [dot] keen [at] gmail [dot] com or find me at the event. Can’t wait to see what people build!