blog.mapme.at

The export method currently exposes a user’s location by delivering a HTML page containing a full-screen map showing one or more user’s location, either the current location or their location history depending on the arguments passed in. It is intended to be used in an iframe to allow simple embedding on third-party websites. The method can be accessed at:

http://mapme.at/api/export.html

You must pass one or more usernames whose location you want to export or the call will not work. You can also pass the same arguments as you would pass to the where method which you would use to read a user’s current location. Some example arguments would be:

http://mapme.at/api/export.html?usernames=thebox&mode=since&since=3%20months%20ago

http://mapme.at/api/export.html?usernames=royaliris,snowdrop,royaldaffodil&mode=since&since=6%20hours%20ago

http://mapme.at/api/export.html?usernames=royaliris&mode=day&day=20090216

The first of those gives the following output:

If no username is given then an error will be returned. The accuracy of the location returned will depend on the whether the user viewing the iframe is logged into mapme.at. If the user is not logged in then the location will be shown at “Public” accuracy, if the user is logged in then this may be different depending on whether the user is a contact of the user whose location is being exported.

The following parameters are also unique to the export page:

static=yes

The map will be static, not able to move or zoom, no controls will show.

controls=no

No map controls will be shown but the map will still be dynamic.

iphone=yes

This sets some iPhone specific properties to allow the export page to be used as a full-screen iPhone web-app.