Set URLs for OSM-mirror and reverse geocoding server

1 Requirements

Due to protection of data privacy it is not allowed (in NRW) to send user data to external services (e.g. Adress, IP-Adress,...). Currently ILIAS uses two hard coded servers that provide tiles for the maps (tile.openstreetmap.org) and geolocation services (open.mapquestapi.com).

To use OpenLayers Maps in a data privacy compliant way, the possibility to change these services should pe provided. The Maps Administration screen (Administration > Third Party Software > Maps) should be extended by two input fields for the URLs to be used for tiles and geo location when the type of maps is set to Open Layers Maps. The fields should default to the currently used URLs.

2 Additional Information

• Idea / concept: Jochen Erkens (j.erkens@fh-aachen.de)
• Interest in funding: FH Aachen
• Maintainer: (will be set by Jour Fixe / maintainer)
• Implementation of the feature is done by (will be set by Jour Fixe / maintainer)
• Testcases by: (please add your name if you want to create the testcases for this feature)

3 Discussion

RK 2015-04-16 - This sounds reasonable and feasible, so i support it.

JourFixe, ILIAS [jourfixe], 11 May 2015: We appreciate this feature and schedule it for 5.1.

4 Implementation

2015-06-18: Feature implemented and integrated in edge-Branch.

5 Testcases

5.1 No Regression

Steps: 

1. Go to Administration > Third Party Software > Maps.
2. Enable Maps.
3. Chose "Open Layers Maps" as Type.
4. Click Save.
5. Insert an adress that is known to be valid in the Address-Field and click "Lookup Address".

1. The map shows the location inserted in the Address-Field.

5.2 Set Custom Tile Server

Steps: 

1. Go to Administration > Third Party Software > Maps
2. Enable Maps.
3. Chose "Open Layers Maps" as Type.
4. Click Save.
5. Enable "Use Custom Server".
6. Set the "Server for Tiles" to "tile.opencyclemap.org".
7. Click Save.
8. Insert an adress that is known to be valid in the Address-Field and click "Lookup Address".

1. The map shows the location inserted in the Address-Field with a cycle map as provided by opencyclemap.org.

5.3 Set Default Tile Server

Steps: 

1. Same steps as in Testcase "Set Custom Tile Server" except for 8., then:
2. Disable "Use custom server".
3. Click Save.
4. Insert an adress that is known to be valid in the Address-Field and click "Lookup Address".

1. The map shows the location inserted in the Address-Field with a map as provided by openstreetmaps.org.

5.4 Set Custom Reverse Geolocation Server

This test could be enhanced if there was a known alternative for the reverse geolocation server open.mapquestapi.com.

Steps:

1. Same steps as in Testcase "No Regression", except for 5., than:
2. Enable "Use custom server".
3. Set "Server for Reverse Geolocation" to some random string.
4. Click Save
5. Insert an address that is known to be valid in the Address-Field and click "Lockup Address".

1. The map does not show the location inserted in the Address Field.

5.5 Set Default Reverse Geolocation Server

Steps: 

1. Same steps as in Testcase "Set Custom Reverse Geolocation Server" except for 8., then:
2. Disable "Use custom server".
3. Click Save.
4. Insert an adress that is known to be valid in the Address-Field and click "Lookup Address".

1. The map shows the location inserted in the Address-Field.