Directly access BuddyBeacon page

There are three advanced ways that you can directly access BuddyBeacon page.
The simple ways to use the ViewRanger Buddy Beacon to share your location with your friends can be found here. 

Via URL
This call lets you link directly to your BuddyBeacon on the ViewRanger

BuddyBeacon page http://www.viewranger.com/portal/new_ptbuddybeacon.php?uid=YOURUSERNAME&pin=YOURPIN

Eg: http://www.viewranger.com/portal/new_ptbuddybeacon.php?uid=craig5800&pin=1234


Embedding Your BuddyBeacon in a Web Page
To embed the BuddyBeacon map in your own web site, use the following call in an IFRAME object: http://www.viewranger.com/portal/new_ptbuddybeacon.php?uid=YOURUSERNAME&nfpin=YOURPIN

If you want to change the width of the map image, add the &fbwidth= parameter.  Default is 620.

ViewRanger API
This API lets you access the raw BuddyBeacon data and create your own maps, apps, and mash-ups. This API is in beta. It may be altered or removed at any time. ViewRanger reserve the right to limit usage or require authentication in the future.

Api calls are accessed via: http://api.viewranger.com/V1/public/

BUDDYBEACON

vrGetBuddyBeacon.php

Example
http://api.viewranger.com/V1/public/vrGetBuddyBeacon.php?buddylist=craig58001234,mike,1234&action=SINCE&time=2010-01-01

Parameters: Buddylist - a comma separated list of UserID, PIN, pairs. (so in the above example, userids are craig5800 and mike. Both users have PINs of 1234.

Action - can be LAST or SINCE. LAST returns last known BuddyBeacon datapoint. SINCE returns all points since the specified datetime (see time param). If Action parameter is not specified, defaults to LAST.

Time - optional parameter, but must be specified if SINCE is used in action. Specified as DATETIME param - so '2010-01-01 19:00' would give all points since then. Date time is timestamp on ViewRanger server (so generally GMT).

Returns:
XML document
<BUDDYLIST>
   <BUDDY>
   <REF>userid</REF>
   <DATAPOINT>
     <LAT>coord</LAT>
     <LONG>coord</LONG>
     <LASTSEEN>datetime</LASTSEEN>
     <ALT>altitude in meters</ALT>   [only provided if altitude recorded at that Beacon]
     <SPD>speed in km/h</SPD>   [only if speed recorded at that Beacon]
     <HDG>heading in degrees</HDG>   [only provided if heading reading recorded at that Beacon]
</DATAPOINT> <DATAPOINT> </DATAPOINT> </BUDDY> </BUDDYLIST>

Let us know how you get on - and what you create with it!