Knowledge Base > Page Editor > Actions > Map Control

Show Location action will allow the user to check the specified location. To know more about the action please follow the steps given below:

Step 1: Open a Free Layout Page.

a.Drag and drop a Map Control UI Part and a RoundButton UI Part on the Page.

b.Browse to the "Functions" section on "Properties Palette window" of RoundButton for applying actions.

c.Click on the corresponding Edit(0) button of the Function on which user wants to apply the Action. To know more about the Functions click here.

mobilous_appexe_npe_myproject_Actions_mapcontrol_showlocation_pageeditor

Step 2: Click on "Add" button on the Actions window to add an action.To know more about actions click here.

mobilous_appexe_npe_myproject_Actions

Step 3: Select the Action Category as “Map Control”.

mobilous_appexe_npe_myproject_Actions_category1

Step 4: Click on the "Map Control" and then click on “Show Location” action.

mobilous_appexe_npe_myproject_Actions_mapcontrol_showlocation

Click here to know about "Doc" Button.

Step 5: Enter Action parameters:-

Parameter	Description
Page Name	Select Page Name where Target UI Part is present e.g "page1".
Target UI part	Select the Name/Identifier of Map UI Part given e.g "GoogleMap".
Location Name	Name of the Location to be shown in the map.

mobilous_appexe_npe_myproject_Actions_mapcontrol_showlocation_setparameters

Step 6: Click on "OK" button if the user doesn't want to add more actions.

mobilous_appexe_npe_myproject_Actions_mapcontrol_showlocation_apply

Note: Define condition if required, by clicking on "+" Condition Button on the left. Click here to know more.

For Map Control user need to Add Google Map API

Map Variables

If Show Location Action is applied using Map Control without adding Google Map API , then Error is triggered. User can display this Error using the Map Variables.

1. User can apply "Alert" action on "Error" event of Show Location Action.

2. Enter "__ERR_CODE__" in the Alert Title parameter.

3. Enter "__ERR__MSG__" in the Alert Message parameter.

Map Variables
S. No.	Variable Name	Description
1	_ERR_CODE_	ERROR CODE is the Name of the Error which is triggered during Map Action.
2	_ERR_MSG_	ERR_MSG is the Error Message of the Error which is triggered during Map Action.

If Google Maps API key is NULL or INVALID

1)In Preview (If key=NULL)

If User continued with out specifying the API key and previewed the app then a default alert for key will popup.

2) In Android and iOS (If Key=NULL)

In case of Android and iOS if the key is blank then "On alert" of Map actions will be triggered.

3) In MW, Android and iOS (If Key= Invalid)

In case Key is invalid or expired then all RTs will trigger "On Alert" event and the particular error message returned by the API will be stored in "__ERR_MSG__" Global variable

4) Preview/ MW cannot read API generated messages in case of API key NULL or expired. So "__ERR_MSG__" implementation is technical limitation.

5) The platforms behave differently as stated above when global error message (ERR_CODE) is used