Map (activity)

Jump to: navigation, search

?Sugar icon}}    This activity is now hosted at the Sugar Activity Library.

The information here is likely to be out-of-date. Consult the new pages for "Map (activity)" first:

.xo Bundle[ Map-12.xo Map (activity).xo]
OlpcProject.png jedierikb


The Map activity allows children to create geo-tagged media mashups. Children can place images, videos, and audio recordings onto maps of their communities.


Getting Started

When you launch the Map activity, sugar will attempt to reach a remote map server. If you don't have a good internet connection, you might not be able to get past this screen.
Activity map screenshot connecting.png

When you've connected to the map server, you will be able to browse maps of the world. The current implementation uses Google Maps. Other map servers could also be implemented.

You can navigate the map using the compass arrows on the sides of the map. You can zoom in and out using the + and - buttons. Enter a location into the Address bar to jump to a new part of the world.
Activity map screenshot address.png

Adding Media

To add media from your journal onto the map, click on the Add Media button.
Activity map screenshot addmedia.png

This will open a file chooser dialog. You can only select images and and video files to add to the map, so you might want to filter the list. Activity map screenshot filepicker.png

Your mouse will become a crosshair, and where you click next will be selected as the location of your photo or video. Activity map screenshot placemedia.png

Media will be represented on the map by the colors of the xo which recorded the media.

Browsing Media

If there are multiple media within one region of the map, you can click the Activity map button left.png and Activity map button right.png buttons in the map region to cycle through them. If you want to see the pop-up with a higher-quality image or watch the video, click Activity map button info.png.

Activity map screenshot nav.png

Visualizing Density

As you add more media to your map, you can click on the Density button to get an overview of where media is clustered. Activity map screenshot density.png

Searching for Tagged Journal Media

If you tag your photos and videos in the journal as shown below:
Activity map screenshot journaltagging.png

If you've tagged your photos and videos in the journal, then you can filter on those tags in the Map activity!
Activity map screenshot tags.png

Saving Maps

You can save a map by clicking the star button. Saved maps are added to the tray at the bottom of the activity. If you click a map button, the map will be returned to the location, zoom level, and tags when the map was saved.
Activity map screenshot savedsearch.png

You can copy an image of this map state to the clipboard if you want to use it in other activities, like write or paint.

You can also describe this map as seen in the next screenshot:
Activity map screenshot describe.png

How to Install

Download this .xo file using the Browse activity: Map-12.xo


The Map activity was written in PyGTK. It relies on javascript files (including prototype.js) to interface with Google maps, although any map rendering engine could be substituted.

All of the Map activity's code is under an MIT License.

Activity Summary

Icon: Sugar icon::Image:activity-map.svg
Genre: Activity genre::General Search and Discovery
Activity group: ,|x|Activity group::x}}
Short description: Short description::The Map activity allows children to create geo-tagged media mashups. Children can place images, videos, and audio recordings onto maps of their communities.
Maintainers: ,|x|Contact person::x}}
Repository URL:
Available languages: ,|x|Available languages::x}}
Available languages (codes): ,|x|Language code::x}}
Pootle URL:
Related projects: Related projects,|x|Related projects::x}}
Contributors: ,|x|Team member::x}}
URL from which to download the latest .xo bundle Activity bundle::
Last tested version number: Activity version::12
The releases with which this version of the activity has been tested. ,|x|Software release::x}}
Development status: Devel status::5. Production-stable
Ready for testing (development has progressed to the point where testers should try it out): ,|x|Ready for testing::x}}
smoke tested :
test plan available :
test plan executed :
developer response to testing :