Skip to Content
Author's profile photo Tom Flanagan

[SAP HANA Academy] – Spatial: Installing the Spatial MapClient

This tutorial video from the SAP HANA Academy’s Jamie Wiseman demonstrates how to install a Spatial Map Client application. This provides an interface to use HERE maps. This is an updated feature released with SAP HANA SPS09. Check out Jamie’s video below:

Screen Shot 2015-01-08 at 2.02.50 PM.png

(0:18 – 1:18) Reference Guide

For information on the licensing and usage of HERE maps in this demo please visit and read section 4.3.1 on page 149 of the SAP HANA Spatial reference guide on the Spatial Map Client.

Note that the syntax used in this demonstration is available on here on GitHub.

(1:18 – 2:05) Downloading the Map Client from the Service Marketplace

The map client is available as a delivery unit in the SAP Service Marketplace. You will need an account in the SAP Service Marketplace in order to obtain this delivery unit.

To find the delivery unit, first log into the SAP Service Marketplace and then click on Products in the top banner. Then click on Software download and in the middle of the following screen select Installations and Upgrades. Next click the search for software link.

In the search term text box enter spatial before clicking the search button at the bottom. Next click on HANA SPATIAL MAP CLIENT 1.0 to download the client.

(2:05 – 3:08) Installing the Delivery Unit

In SAP HANA Studio click the File menu and choose Import. In the Import window expand the SAP HANA Content folder and select Delivery Unit before clicking next.  Choose the appropriate system and advance to the next step. For Jamie’s demonstration he has downloaded the Delivery Unit to a Window machine so he choose the Client option on the Select File screen before clicking browse.  After browsing to the location of and selecting the extracted files, click the Open button. Once the Import Wizard has verified the files click on Finish and then further confirm it’s successful delivery in the job log.

Screen Shot 2015-01-08 at 2.32.12 PM.png

The demo’s installation can be found by expanding the content folder, followed by the subsequent SAP, HANA, and Spatial packages to reveal the mapClient package.

(3:08 – 3:42) Verifying Successful Installation via Web Browser

Enter http://hana:8000/spa/hana/spatail/mapClient/demo in a web browser to navigate to the main index HTML page. A sample URL is available on GitHub.

Screen Shot 2015-01-08 at 2.11.35 PM.png

If you are able to see your mapClient then your installation has been successful.

(3:42 – 5:10) Setting the Proper Privileges

However, if you aren’t able to successfully display the map image in your web browser then you may be facing a proxy issue between your SAP HANA system and the HERE maps server. There is a specific file in the application that deals with this connection.

The first step is to ensure that your development user has the rights to access and then change the mapClient demo application. Back in SAP HANA Studio open the security folder and select your user name to view the Security dialogue. Select the packages privileges tab and click on the green add button. In the search text box enter mapClient. Note the search box is case sensitive. Select the sap.hana.spatial.mapClient package and click Ok to add it.

In the Privileges section click the box next to REPO_READ and also select the three options under Privileges for Imported Packages – REPO_EDIT_IMPORTED_OBJECTS, REPO_ACTIVATE_IMPORTED_OBJECTS, and REPO_MAINTAIN_IMPORTED_OBJECTS. Then click on the green deploy button or press F8.

Screen Shot 2015-01-08 at 2.19.02 PM.png

View the SAP HANA Administration Guide for very detailed information on assigning security and rights to your users.

(5:10 – 6:27) Fixing the Proxy Issues

The remainder of this lesson is conducted using the SAP Web IDE workbench. If you unfamiliar with how to navigate to the Web IDE using the sample location below and that can also be found on GitHub.

http://<your hana system>:80<your instance number>/sap/hana/ide/editor

To be able to log onto the Web IDE you must have assigned your development user the appropriate right to access the workbench. The script below can be used by a system’s administrator in a SQL console to grant the user this right.

CALL GRANT_ACTIVATED_ROLE(‘sap.hana.xs.ide.roles::Developer’,<your dev user>’);

In the Web IDE navigate down to the proxy settings by expanding the Content folder followed by the subsequent sap, hana, spatial, and mapClient packages before selecting the nokia.xshttpdest file. Since you have already assigned your development user the appropriate rights to change this file you should now be able to fix the proxy issues.

Check out the SAP HANA Academy’s series of over 75 videos on What’s New with SAP HANA SPS09 as well as the playlist detailing the new Spatial features for SPS09.

SAP HANA Academy over 800 free tutorial videos on using SAP HANA.

Follow @saphanaacademy

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Former Member
      Former Member

      I installed the client but I cant get it to display the proxy settings in the file are true but I dont have a proxy.  Can I edit the proxy file to false to make this work?

      I have change management activated in the system but I cant see anyway to chnage the nokia file that has the proxy settings.  Any advice on what I may be missing?


      Author's profile photo Jamie Wiseman
      Jamie Wiseman

      hi Joseph,

      you should be able to use a false setting for useProxy. you can open the file up in your Web Dev Workbench with a user that has the appropriate role assigned. this is covered later on in the video.

      the shortcut to the http destination file is

      <your hana system>/sap/hana/ide/editor/index.html?startURI=sap/hana/spatial/mapClient/nokia.xshttpdest

      in the near future we'll be publishing some videos on adding the geo content to an HCP starter system (not the developer edition but the starter edition) as well as installing and the contentViewer application.

      if your question is however more focused on the change management piece (i.e. how to manage changes to an xs application DU), then you may wish to check out this great blog post by Boris Zarske. SAP HANA Lifecycle Management



      Author's profile photo Former Member
      Former Member

      Hi Jamie

      Thanks for your response I have it working.  My problem was I tried using HANA studio to make the proxy change.  This I could  not do in HANA studio but it the Web IDE it worked fine.  But his brings up the questions what if I wanted to modify something in say another name space like SAP.  In netweaver i would have to get a modification key however i implemented change management in our HANA system and had no luck in performing a modification.

      Why does it work in the Web IDE but not in HANA studio?

      Author's profile photo Jamie Wiseman
      Jamie Wiseman

      hi Joseph, some questions for you...

      1) can you describe the work flow that you do in studio?

      2) and let us know if you get any particular error...i.e. what happens when you undertake that work flow?

      3) can you give us your environment details...what rev of hana are you using and is it on premise, hana cloud platform, etc?