Map (activity)


Jump to: navigation, search

Activity-map.svg    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]



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.

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.

Adding Media

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

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. Image: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. Image: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 Image:Activity_map_button_left.png and Image: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 Image:Activity_map_button_info.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. Image:Activity_map_screenshot_density.png

Searching for Tagged Journal Media

If you tag your photos and videos in the journal as shown below:

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

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.

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:

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: Image:activity-map.svg
Genre: General Search and Discovery
Activity group:
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: User:Jedierikb
Repository URL:
Available languages:
Available languages (codes): en, es, mn
Pootle URL:
Related projects:
URL from which to download the latest .xo bundle
Last tested version number: 12
The releases with which this version of the activity has been tested. 7.1.0 (650), 7.1.1 (653), 7.1.2 (656), 8.1.0 (703), 8.1.1 (708), 8.2.0 (767), 8.2.1
Development status: 5. Production-stable
Ready for testing (development has progressed to the point where testers should try it out):
smoke tested :
test plan available :
test plan executed :
developer response to testing :
Personal tools
  • Log in
  • Login with OpenID
About OLPC
About the laptop
About the tablet
OLPC wiki