User:SignpostMarv Martin/sandbox/mapapi
Adding a group of lines to the map
This example is used with the slrr.js file, and although the function names suggest otherwise, this code is not limited to indicating rail lines
<javascript>mapapi['callbacks']['addGridCallback']('com.secondlife.agni', function(gridConfig){ // grid configs are addressed by namespaces (org.osgrid for OSGrid, com.blizzard.wow for World of Warcraft etc.) var options = function(weight){ return {'strokeWeight':weight,'strokeColor':'#ffffff','clickable':false} // generally you'll not want the line to be clickable, to let people teleport to a point along a line. }, addRailNetwork = function(name, alt, things){ gridConfig['addMultiObjOverlay'](new mapapi['MultiObjOverlay']({ // multi-object overlays are shortcut objects in mapapi.js, intended for batch-handling of multiple overlay objects. 'name' : name, 'alt' : alt, 'things' : things })); }, ZoomWidthPolyline = mapapi['factory']['ZoomWidthPolyline']; // this factory method from mapapi.js is assigned to a var to assist in readability & minification. addRailNetwork('Rail::Hobo', 'Hobo Railway', [ // the sl-viewer-1 UI plugin will create a menu item named "Rail" with a sub-item named "Hobo" and a description of "Hobo Railway" ZoomWidthPolyline([ [1005.144714, 1014.679810], [1005.481262, 1014.678711], [1005.522461, 1014.678955], [1005.571716, 1014.691895], [1005.594543, 1014.702393], [1005.617188, 1014.715820] ], options(3) ), ZoomWidthPolyline([ [1005.444824, 1013.211609], [1005.445679, 1014.442261], [1005.447571, 1014.465454], [1005.451843, 1014.488403], [1005.457092, 1014.509399], [1005.465393, 1014.531311], [1005.474792, 1014.552124], [1005.486267, 1014.572388], [1005.498352, 1014.589661], [1005.517883, 1014.612671], [1005.682861, 1014.778259], [1005.708008, 1014.802673], [1005.720276, 1014.815491], [1005.758667, 1014.860474] ], options(3) ) ]); }); </javascript>
Adding landmarks
This example is from welcome-areas.js and is intended for use with toggling the display of a group of related landmarks via a UI plugin. <javascript>(function(){
var cb1 = function(plugin){
if(plugin['functions'] && plugin['functions']['addMenuToLogWidget']){
var markerImage = new window['google']['maps']['MarkerImage'](
'http://static.marvulous.co.uk/img/mapapi/marker-sm.png', // URL to your landmark image.
new window['google']['maps']['Size'](53, 48), // width and height of your landmark icon
new window['google']['maps']['Point'](0, 0), // unless you're using sprite sheets, leave this as-is.
new window['google']['maps']['Point'](26, 48) // the x & y pixels in the icon to use as the anchor. In this case, it is the bottom middle of the icon.
);
plugin['functions']['addMenuToLogWidget']('Places', 'Welcome Areas',[ // this will add a menu named "Welcome Areas" to the "Places" log widget. In the sl-viewer-1 UI plugin, this is the Places tab in the sidebar.
{
'name' : 'Ahern', // Although it's not likely to happen for mainland regions, private islands may be moved around the grid, making their global co-ordinates change;
'x' : 28, // Since mapapi.js will fetch the global position of the named region, then add the landmark at the specified co-ordinates.
'y' : 28,
'z' : 40,
'text' : 'Ahern Welcome Area',
'description' : 'The first welcome area in Second Life.', // html in descriptions are not supported. line endings however, will be converted to
tags in order to preserve structure.
'icon' : markerImage // since all of these landmarks will use the same icon, a variable is referenced instead of instantiating google.maps.MarkerImage here.
},
{
'name' : 'Plum',
'x' : 73,
'y' : 250,
'z' : 47,
'text' : 'Plum Welcome Area',
'description' : 'Currently restful, but a fond living memory of what the classic Welcome Area looked like back in the day.',
'image' : { // this landmark should have an image displayed on the map UI when clicked.
'src' : 'http://secondlife.com/app/image/fbe02542-1aac-cf02-9356-6cd52b7301b1/1' // the src attribute of the image. URLs may be whitelisted by the UI plugin at some point.
},
'icon' : markerImage
},
{
'name' : 'Violet',
'x' : 164,
'y' : 102,
'z' : 26,
'text' : 'Violet Welcome Area and Infohub',
'description' : 'A beautiful Japanese garden, a place to start your Second Life, find info, and meet other residents.',
'image' : {
'src' : 'http://secondlife.com/app/image/25d90335-eadf-20dd-1268-ae45948dbeef/1'
},
'icon' : markerImage
},
{
'name' : 'Waterhead',
'x' : 36,
'y' : 76,
'z' : 25,
'text' : 'Waterhead Welcome Area',
'description' : 'Tranquil beauty in the heart of arboreal lushness. Wander around the woods or relax by the water\'s edge.',
'image' : {
'src' : 'http://secondlife.com/app/image/c72a3c22-48fe-2f7a-66ae-52a79f257c3f/1'
},
'icon' : markerImage
}
]);
}
return true;
}, cb2 = function(){
mapapi['callbacks']['addCallback']('plugin loaded', cb1); // if you're wondering what the nonsense is with cb1 and cb2, it's a workaround for load ordering issues.
}
mapapi['callbacks']['addGridCallback']('com.secondlife.agni', cb2);
})();</javascript>