Difference between revisions of "Activities/Map"

From Sugar Labs
Jump to navigation Jump to search
m (moved Walter is a wanker 7/Map to Activities/Map over redirect: revert)
Line 2: Line 2:
 
[[Category:Activities|Map]]</noinclude>
 
[[Category:Activities|Map]]</noinclude>
  
The Map activity allows children to explore Google Maps and add their own content. Children can place images, videos, and audio recordings onto maps of their communities.  Use the XO's mesh network and the Internet to collaborate on maps, or save the map you're working on to the [[Journal]].
+
The Map activity helps children to explore and create their own maps:
  
Download the activity here: http://maptonomy.appspot.com/Map-6.xo
+
* Search for your school, the Statue of Liberty, or find Mongolia - see roadmaps and satellite photos.
 +
* Write about what you see : add a description or embed a Wikipedia article
 +
* You can take photos, video, or audio in Record and place them onto the map
 +
* Use the XO's mesh network to collaborate, or save the map to the [[Journal]]
 +
* Measure distance and area
 +
* Participate in the online "OurMaps" wiki
 +
* Advanced users add HTML and import KML (Google Earth), GeoRSS (Ushahidi), or OSM (OpenStreetMap) files
 +
 
 +
Download the activity here: http://maptonomy.appspot.com/Map-8.xo
  
 
This activity needs your help to get out of Beta.  '''Please edit this or the discussion page if you have a question.'''
 
This activity needs your help to get out of Beta.  '''Please edit this or the discussion page if you have a question.'''
  
You may be interested in the beta [http://wiki.laptop.org/go/User:Ndoiron/OfflineMap Offline Maps] project.
+
You may be interested in the [http://wiki.laptop.org/go/User:Ndoiron/OfflineMap Offline Maps] project.
  
 
= Tutorial =
 
= Tutorial =
Line 15: Line 23:
  
 
== Getting Started ==
 
== Getting Started ==
Navigate the map using the compass arrows on the sides of the mapYou can zoom in and out using the '''+''' and '''-''' buttons, or double-clicking.  Enter a location into the '''Find''' bar to jump to a new part of the world. Like other activities, you can invite other XOs in your network to view the map.
+
Move the map using the compass arrows on the sides.  Zoom in and out using '''+''' and '''-''' buttons, or double-clicking.  Enter a location into the '''Find''' bar to jump to a new location.
<br />
+
 
<br />
 
 
[[Image:Map-Screenshot.jpg‎]]
 
[[Image:Map-Screenshot.jpg‎]]
<br />
+
 
<br />
+
 
 
== Adding Text ==
 
== Adding Text ==
You can add a text marker by clicking the '''i''' button in the '''Edit''' section.
+
You can add a text marker by clicking the '''i''' marker in the '''Edit''' section.
 
[[Image:Map-InfoIcon.jpg]]
 
[[Image:Map-InfoIcon.jpg]]
  
 
A text marker is shared with other XOs in your network.  You can edit your own or others' text markers by clicking the marker and clicking the '''Edit''' button.
 
A text marker is shared with other XOs in your network.  You can edit your own or others' text markers by clicking the marker and clicking the '''Edit''' button.
  
You can add images from the internet using the code '''img::'''www.example.org/picture.jpg
+
== Adding Media ==
 +
To add media from your journal onto the map, click on the '''Add Media''' button.
  
You can add articles from Simple English Wikipedia using the code '''wiki::'''Article Name
+
[[Image:Map-AddMedia.jpg‎]]
  
You can add articles from other languages' Wikipedias by adding its language code.  For example, Spanish (ES.wikipedia.org) is '''wikiES::''' and French (FR.wikipedia.org) is '''wikiFR::'''
+
Select a photo, video, or audio file from the Record activity.
  
Other codes are '''google::''' to embed a Google search, and '''vid::''' for OGG videos only.
+
[[Image:Map-SelectMedia.jpg‎]]
  
[[Image:InfoMarkers.jpg]]
+
Your mouse will become a crosshair (+). Click the map to place the marker.
  
== Adding Media ==
 
To add media from your journal onto the map, click on the '''Add Media''' button.
 
<br />
 
[[Image:Map-AddMedia.jpg‎]]
 
<br />
 
<br />
 
Select a picture, video, or audio recording you made in the Record activity.
 
<br />
 
<br />
 
[[Image:Map-SelectMedia.jpg‎]]
 
<br />
 
<br />
 
Your mouse will become a crosshair. Click the map to place the marker.
 
<br />
 
<br />
 
 
[[Image:Map-MediaIsOn.jpg‎]]
 
[[Image:Map-MediaIsOn.jpg‎]]
<br />
+
 
<br />
+
== Adding Wikipedia and More ==
 +
You can add images from the internet using the code '''pic::'''www.example.org/picture.jpg
 +
 
 +
You can add articles using a code such as '''wiki::'''Japan
 +
 
 +
For other languages: Spanish (ES.wikipedia.org) is '''wikiES::'''Barcelona and French is '''wikiFR::'''Paris
 +
 
 +
Other codes are '''google::'''OLPC to embed a Google search, and '''vid::'''www.example.org/video.ogg for OGG videos.
 +
 
 +
[[Image:InfoMarkers.jpg]]
  
 
== Saving Maps ==
 
== 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 and zoom level as when the map was saved.
 
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 and zoom level as when the map was saved.
<br />
+
 
<br />
 
 
[[Image:Map-SavedMap.jpg‎]]
 
[[Image:Map-SavedMap.jpg‎]]
<br />
+
 
<br />
+
 
You can copy an image of this map state to the clipboard if you want to use it in other activities, such as Write or Paint.
 
<br />
 
You can also describe this map as seen in the next screenshot:
 
<br />
 
<br />
 
[[Image:Map-DescribeSaveMap.jpg‎]]
 
<br />
 
<br />
 
 
== Measuring Distance and Area ==
 
== Measuring Distance and Area ==
 
The new Measure feature can measure polyline distance or rectangle area.  This is useful for geometry, surveying, or learning units.
 
The new Measure feature can measure polyline distance or rectangle area.  This is useful for geometry, surveying, or learning units.
  
 
Click the Ruler icon in the '''Edit''' tab.
 
Click the Ruler icon in the '''Edit''' tab.
<br />
+
 
<br />
 
 
[[Image:Map-MeasureOn.jpg‎]]
 
[[Image:Map-MeasureOn.jpg‎]]
<br />
+
 
<br />
+
 
 
Select Distance and click two points to begin measuring.  When you are finished, click '''Done'''.
 
Select Distance and click two points to begin measuring.  When you are finished, click '''Done'''.
<br/>
+
 
<br/>
 
 
[[Image:Map-MeasureDistance.jpg‎]]
 
[[Image:Map-MeasureDistance.jpg‎]]
<br/>
+
 
<br/>
+
 
 
To measure Area, click opposite corners (for example, the northeast and southwest corners of Colorado)
 
To measure Area, click opposite corners (for example, the northeast and southwest corners of Colorado)
<br/>
 
<br/>
 
[[Image:Map-MeasureArea.jpg‎]]
 
  
== Online Content ==
+
==Maps4xo Library==
===The Maps4xo Library===
+
Click the Browse icon in the '''Edit''' Menu to view the library. This example uses the real-life use of GPS to track and protect turtles:
Click the Browse icon in the '''Edit''' Menu to view the library. Maps4xo shows new and nearby map content, as well as links to maps full of '''Wikipedia''' articles and '''Panoramio''' photos.
+
 
<br />
 
<br />
 
[[Image:Map-MapLibrary.jpg‎]]
 
<br />
 
<br />
 
The map content is intended to serve as an introduction to GIS/mapping technology uses and concepts.  This example is adapted from the real-life use of GPS to track and protect turtles.
 
<br />
 
<br />
 
 
[[Image:Map-TurtleMap.jpg‎]]
 
[[Image:Map-TurtleMap.jpg‎]]
<br />
 
<br />
 
  
===The OurMaps Wiki===
+
 
 +
==OurMaps Wiki==
 
OurMaps is a wiki for storing or sharing map markers online.
 
OurMaps is a wiki for storing or sharing map markers online.
  
 
When many markers are in one place, they are combined into a red "cluster" marker:
 
When many markers are in one place, they are combined into a red "cluster" marker:
<br />
+
 
<br />
 
 
[[Image:Map-WikiCluster.jpg‎]]
 
[[Image:Map-WikiCluster.jpg‎]]
<br />
+
 
<br />
 
 
A marker can have an image or Wikipedia article embedded inside.  This marker uses Simple Wikipedia's mobile site.
 
A marker can have an image or Wikipedia article embedded inside.  This marker uses Simple Wikipedia's mobile site.
<br />
+
 
<br />
 
 
[[Image:Map-EmbedWiki.jpg‎]]
 
[[Image:Map-EmbedWiki.jpg‎]]
<br />
+
 
<br />
 
 
It is easy to create a marker and add to the map.  A school can create a private group to collect markers that only they can see.  A public group shares its markers with XO users around the world.
 
It is easy to create a marker and add to the map.  A school can create a private group to collect markers that only they can see.  A public group shares its markers with XO users around the world.
<br />
+
 
<br />
 
 
[[Image:Map-AddToWiki.jpg‎]]
 
[[Image:Map-AddToWiki.jpg‎]]
<br />
 
<br />
 
 
====Codes for Wikipedia, Pictures, Etc====
 
In addition to '''wiki::''' , you can add a language code to make '''wikiES::''' for Spanish or '''wikiFR::''' for French.
 
 
The code '''img::''' or '''pic::''' will post an image and '''google::''' will embed a Google search.  If you have an OGV video, you can use the code '''vid::''' - note that this will load slowly on most connections.
 
 
= How to Install =
 
Download this '''.xo''' file using the Browse activity: (http://maptonomy.appspot.com/Map-6.xo download)
 
  
 
= Development =
 
= Development =
Line 141: Line 105:
 
Having the activity work on Sugar-on-a-Stick or emulators is an ongoing problem: http://www.youtube.com/watch?v=6QvMtQIqdfQ
 
Having the activity work on Sugar-on-a-Stick or emulators is an ongoing problem: http://www.youtube.com/watch?v=6QvMtQIqdfQ
  
You can download the source code in this zip file: http://maptonomy.appspot.com/Map-6.zip
+
You can download the source code in this zip file: http://maptonomy.appspot.com/Map-8.zip
  
 
All of the Map activity's code is under an MIT License.
 
All of the Map activity's code is under an MIT License.
Line 149: Line 113:
 
==Future Plans==
 
==Future Plans==
 
* Detecting Sugar on a Stick systems and provide them with higher-res maps.
 
* Detecting Sugar on a Stick systems and provide them with higher-res maps.
* "MapPack" bundles (xol) for each local area (separate ones for Uruguay, Haiti, Mongolia, etc...
 
** Extends activity's search with local-language placenames and previously unmapped local points of interest
 
** New content such as state boundaries, points of interest, and historical places
 
** Can include sample maps and lessons
 
** Kit explaining how to make localized MapPacks
 
 
* More travel, history, environmental, and engineering example maps
 
* More travel, history, environmental, and engineering example maps

Revision as of 21:05, 29 March 2010

The Map activity helps children to explore and create their own maps:

  • Search for your school, the Statue of Liberty, or find Mongolia - see roadmaps and satellite photos.
  • Write about what you see : add a description or embed a Wikipedia article
  • You can take photos, video, or audio in Record and place them onto the map
  • Use the XO's mesh network to collaborate, or save the map to the Journal
  • Measure distance and area
  • Participate in the online "OurMaps" wiki
  • Advanced users add HTML and import KML (Google Earth), GeoRSS (Ushahidi), or OSM (OpenStreetMap) files

Download the activity here: http://maptonomy.appspot.com/Map-8.xo

This activity needs your help to get out of Beta. Please edit this or the discussion page if you have a question.

You may be interested in the Offline Maps project.

Tutorial

(Página en Español)

Getting Started

Move the map using the compass arrows on the sides. Zoom in and out using + and - buttons, or double-clicking. Enter a location into the Find bar to jump to a new location.

Map-Screenshot.jpg


Adding Text

You can add a text marker by clicking the i marker in the Edit section. Map-InfoIcon.jpg

A text marker is shared with other XOs in your network. You can edit your own or others' text markers by clicking the marker and clicking the Edit button.

Adding Media

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

Map-AddMedia.jpg

Select a photo, video, or audio file from the Record activity.

Map-SelectMedia.jpg

Your mouse will become a crosshair (+). Click the map to place the marker.

Map-MediaIsOn.jpg

Adding Wikipedia and More

You can add images from the internet using the code pic::www.example.org/picture.jpg

You can add articles using a code such as wiki::Japan

For other languages: Spanish (ES.wikipedia.org) is wikiES::Barcelona and French is wikiFR::Paris

Other codes are google::OLPC to embed a Google search, and vid::www.example.org/video.ogg for OGG videos.

InfoMarkers.jpg

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 and zoom level as when the map was saved.

Map-SavedMap.jpg


Measuring Distance and Area

The new Measure feature can measure polyline distance or rectangle area. This is useful for geometry, surveying, or learning units.

Click the Ruler icon in the Edit tab.

Map-MeasureOn.jpg


Select Distance and click two points to begin measuring. When you are finished, click Done.

Map-MeasureDistance.jpg


To measure Area, click opposite corners (for example, the northeast and southwest corners of Colorado)

Maps4xo Library

Click the Browse icon in the Edit Menu to view the library. This example uses the real-life use of GPS to track and protect turtles:

Map-TurtleMap.jpg


OurMaps Wiki

OurMaps is a wiki for storing or sharing map markers online.

When many markers are in one place, they are combined into a red "cluster" marker:

Map-WikiCluster.jpg

A marker can have an image or Wikipedia article embedded inside. This marker uses Simple Wikipedia's mobile site.

Map-EmbedWiki.jpg

It is easy to create a marker and add to the map. A school can create a private group to collect markers that only they can see. A public group shares its markers with XO users around the world.

Map-AddToWiki.jpg

Development

The Map activity was written in PyGTK. It relies on JavaScript files to interact with Google's Static Maps API and geocoder.

Having the activity work on Sugar-on-a-Stick or emulators is an ongoing problem: http://www.youtube.com/watch?v=6QvMtQIqdfQ

You can download the source code in this zip file: http://maptonomy.appspot.com/Map-8.zip

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

You may be interested in the beta Offline Maps project.

Future Plans

  • Detecting Sugar on a Stick systems and provide them with higher-res maps.
  • More travel, history, environmental, and engineering example maps