Google API Explorer

Today we’ve been using the Google Custom Search API Explorer to generate some sample search results for images, videos, presentations and Flash movies.

Screenshot of the Google API Explorer web page

Screenshot of the Google API Explorer web page

This is a very effective tool and allows us to filter our searches by many parameters, inclusing file format and site or domains. Images are handled differently to the others and generates a different JSON data structure, which is more detailed than the non-image search results.

We will now parse data from these sample JSON files to test how further meta- and paradata can be retrieved from relevant fileshare sites via their respective APIs. For example, taking the contextLink element from the raw Google result given in the JSON code below, we are able to use the Flickr API and gather much richer data for this image resource.

{
"kind": "customsearch#result",
"title": "Bessemer converter (iron into steel), Allegheny Ludlum Steel[e ...",
"htmlTitle": "Bessemer converter (iron into <b>steel</b>), Allegheny Ludlum <b>Steel</b>[e <b>...</b>",
"link": "http://farm3.staticflickr.com/2044/2178430515_d88779d275_z.jpg?zz=1",
"displayLink": "www.flickr.com",
"snippet": "Allegheny Ludlum Steel[e]",
"htmlSnippet": "Allegheny Ludlum <b>Steel</b>[e]",
"mime": "image/jpeg",
"image": {
"contextLink": "http://www.flickr.com/photos/library_of_congress/2178430515/",
"height": 640,
"width": 514,
"byteSize": 86844,
"thumbnailLink": "https://encrypted-tbn0.google.com/images?q=tbn:ANd9GcSAagY291GS5YPUBXpiCybbtHPIrz72Px_33MKwvZRg1ijeIymmqL3p15oo",
"thumbnailHeight": 137,
"thumbnailWidth": 110
}

Have a look to see how this example appears in our Flickr API test page.

Initial wireframe designs for UI

Having now held a couple of sessions with the student group, we have come up with the first set of wireframe designs for the ENGrich user interface. Only 3 basic pages are currently envisaged: a start page, a results listing (or grid) and a results detail page, which will have slideout portions to allow paradata input and sign-in.

The start page follows that of Google in its simplicity; just a text field for search terms, a button plus the option to limit the search to a single resource type.

Start pageWe’re considering displaying the search results either as a listing, whereby each thumbnail will be accompanied by some limited meta and usage data, or as a grid. We’ll put both designs to the user group and decide whether to adopt one or both of them.

Results as a listing, with some data against each thumbnail

Results as a listing

Results as a grid

Results as a grid

The exact choice of icons displayed beneath each thumbnail is subject to ongoing debate. The left-hand column can be used to refine the results based on certain learning object metadata elements.

Resource detail plus metadata input pageThe full details page will potentially gather together metadata and usage data from different sources. The interface will also allow for users to classify resources (probably to a JACS 3 standard) and add some other metadata, depending on the resource type. Fo those who have already used the resource, a slideout (expanding portion of the page) will allow the addition of some data describing how and when the resource was used.

Adding usage dataEND