Datalab

Linking to Mash-o-matic Generated Mash-ups

SPARCE Home ] Up ] Overview ] [ Linking ] Tools ]

 

Dept. of Computer Science
Portland State University

 

We assume you are familiar with terms such as mash-ups, markers, and landmarks.

We first provide examples of linking to the Portland State University campus-map mash-up and then describe the general form of a link to any Mash-o-matic generated mash-up.

You can link to the Portland State University campus-map mash-up and direct it to display the information window for a marker associated with a particular landmark. A link must be a URL in one of the following forms:

http://sparce.cs.pdx.edu/cmap/index.html?acronym=<ac>
http://sparce.cs.pdx.edu/cmap/index.html?acronym=<ac>?img=<imageURL>

The token <ac> stands for the target landmark's acronym. The campus-map mash-up lists the landmarks and their acronyms. The second form of the link directs the mash-up to display an image instead of the landmark's information window. When used, the token <imageURL> must be the URL of an image file on the web. The image referenced could be of any size, but we recommend it not exceed 300 pixels x 300 pixels. Here are some example links:

http://sparce.cs.pdx.edu/cmap/index.html?acronym=URBN  
http://sparce.cs.pdx.edu/cmap/index.html?acronym=PSC?img=VEViking.jpg 

The first link loads the mash-up and displays the information window at the marker for the landmark with acronym ‘URBN’ (Urban Center). The second link loads the mash-up and displays a picture of Victor E. Viking (the university mascot) over the marker corresponding to the Peter Stott Center.

The general form of a link to any Mash-o-matic generated mash-up

Links to a Mash-o-matic generated mash-up can be generalized as follows:

<baseURL>?<landmarkAttr>=<value>?img=<imageLocation>

The token <baseURL> is the URL of the mash-up application. For example, the URL of the Portland State University campus-map mash-up is http://sparce.cs.pdx.edu/cmap/index.html. The token <landmarkAttr> is the name of an attribute of the underlying XML Landmark element. For example, for the PSU campus map, the attribute name can be one of the following: type, name, acronym, and block, but the exact set of attributes can be different (based on customizations made). The mash-up finds the first landmark that has the value supplied for the attribute specified, and displays the information window for its marker. If more than one marker results, it displays the information window for the first marker.

The second part of the query in the URL (the second question mark and later) is optional. When used, <imageLocation> must be the URL of an image file on the web.
 

Page modified: 14 Jun 2006 10:29 AM