Map module: Difference between revisions

Latest revision as of 13:12, 8 May 2011

This is a map activity module. It allows the creation of geographic maps to be used in courses. It can be used for student locations and/or other course content.

Description

This module generates geographic maps within Moodle courses. Markers can created mark user locations and/or other course content.

Compatibility

This module requires php5. It also requires the cURLlibrary. It has been tested with Moodle 1.8 and 1.9.

Map Providers

The module currently can create maps using two map providers. The map provider can either be chosen in the module settings page or for each map.

Google Maps

In order to use Google Maps a Google Map API Key will need to be set in the module settings page. If you don't have a Google Map Key then you can get one here. In order to use Google Maps Browsers must be supported by Google Maps API. A list is here. It is the module user's responsibility to make sure they are using Google Maps in compliance with the Google Maps API Terms of Service.

OpenStreetMaps

OpenStreetMaps offers free geographic including street maps. OpenStreetMaps may be able to be used in situations where the Google Maps API Terms of Service restricts using Google Maps. When using OpenStreetMaps this module uses OpenLayers Javascript API to create the on screen map. It also uses the Geonames project for obtain location coordinates.

Locations

User Locations

These locations correspond to where the users live. If the students are not required to consent to being shown on this map then the module will attempt to determine their location from their profile information. The user's picture and description will be shown from their profile.

Other/Extra Locations

These locations are for any other course content.

Settings

Module Level Settings

Map Provider

This setting set which map provider each map should use.

Each Map creator will chooses the map's provider
Google
OpenStreetMaps/OpenLayers

Map Level Settings

Show Student Locations on Map?

This setting determines whether students personal locations will show up on this map.

Require students consent to appearing on this map?

If student locations will be shown on this map then this setting determines whether students will need to explicitly set their location. If this is set to "No" then teachers and administrators will be able to update all user locations from their profile location.

Allow Students to add extra map locations?

This setting determines if students will be able to add locations to this map that are not their own personal locations. Teachers and administrators can always add extra locations to maps.

Show address field for extra locations?

This setting determines if an address field will be shown for the extra locations. If the address field is not shown then locations will only be able to be shown to the city level. Personal locations never have the address field for privacy reasons.

Links

Sample Moodle course using this module
Plug-in database entry for Map module
Using Moodle Map module discussion forum
Ted Bowman creator of this module.
Source code of updated version with OpenLayers.js API 1.4 support. (tar.gz Package)

@@ Line 1: / Line 1: @@
 [[Category:Contributed code]]
-This is a map activity module. It uses Google maps to make in course maps. It can be used for student locations and/or other course content.
+This is a map activity module. It allows the creation of geographic maps to be used in courses. It can be used for student locations and/or other course content.
-After installing this module the Google Map API Key will need to be set in the module settings page.  If you don't have a Google Map Key then you can get on [http://code.google.com/apis/maps/signup.html here].
+==Description==
-==Description==
+This module generates geographic maps within Moodle courses. Markers can created mark user locations and/or other course content.
+==Compatibility==
+This module requires php5. It also requires the [http://us.php.net/curl cURL]library. It has been tested with Moodle 1.8 and 1.9.
-This module generates geographic maps from Google Maps within Moodle course.
+==Map Providers==
+The module currently can create maps using two map providers.  The map provider can either be chosen in the module settings page or for each map.
+===Google Maps===
+In order to use Google Maps a Google Map API Key will need to be set in the module settings page.  If you don't have a Google Map Key then you can get one [http://code.google.com/apis/maps/signup.html here]. In order to use Google Maps Browsers must be supported by Google Maps API. A list is [http://code.google.com/apis/maps/faq.html#browsersupport here]. It is the module user's responsibility to make sure they are using Google Maps in compliance with the [http://code.google.com/apis/maps/terms.html Google Maps API Terms of Service].
+===OpenStreetMaps===
+[http://wiki.openstreetmap.org/index.php/Main_Page OpenStreetMaps] offers free geographic including street maps.  OpenStreetMaps may be able to be used in situations where the [http://code.google.com/apis/maps/terms.html Google Maps API Terms of Service] restricts using Google Maps.  When using OpenStreetMaps this module uses [http://openlayers.org/ OpenLayers] Javascript API to create the on screen map. It also uses the [http://www.geonames.org/about.html Geonames] project for obtain location coordinates.
 ==Locations==
 ===User Locations===
-These locations correspond to where the users live.  If the students are not required to constent to being shown on this map then the module will attempt to determine their location from their profile information.  The user's picture and description will be shown from their profile.
+These locations correspond to where the users live.  If the students are not required to consent to being shown on this map then the module will attempt to determine their location from their profile information.  The user's picture and description will be shown from their profile.
 ===Other/Extra Locations===
@@ Line 19: / Line 27: @@
 ==Settings==
-===Show Student Locations on Map?===
+===Module Level Settings===
+====Map Provider====
+:This setting set which map provider each map should use.
+#Each Map creator will chooses the map's provider
+#Google
+#OpenStreetMaps/OpenLayers
+===Map Level Settings===
+====Show Student Locations on Map?====
 This setting determines whether students personal locations will show up on this map.
-===Require students consent to appearing on this map?===
+====Require students consent to appearing on this map?====
 If student locations will be shown on this map then this setting determines whether students will need to explicitly set their location.  If this is set to "No" then teachers and administrators will be able to update all user locations from their profile location.
-===Allow Stundents to add extra map locations?===
+====Allow Students to add extra map locations?====
 This setting determines if students will be able to add locations to this map that are not their own personal locations.  Teachers and administrators can always add extra locations to maps.
-===Show address field for extra locations?===
+====Show address field for extra locations?====
 This setting determines if an address field will be shown for the extra locations.  If the address field is not shown then locations will only be able to be shown to the city level.  Personal locations never have the address field for privacy reasons.
+==Links==
+* [http://moodle.tedbow.com/course/view.php?id=2&username=guest Sample Moodle course using this module]
+* [http://moodle.org/mod/data/view.php?d=13&rid=1745 Plug-in database entry for Map module]
+* Using Moodle [http://moodle.org/mod/forum/view.php?id=7217 Map module discussion forum]
+* [http://www.tedbow.com Ted Bowman] creator of this module.
+* Source code of [https://github.com/nadavkav/RTL-BIDI-Hebrew-Moodle-Plugins/tree/master/mod/map updated version] with OpenLayers.js API 1.4 support. ([https://github.com/nadavkav/RTL-BIDI-Hebrew-Moodle-Plugins/blob/master/mod/map.tar.gz tar.gz Package])

Documentation