his article helps system administrators to understand the appearance and process of using various features of the Places tool, from the front end. The tool settings are done by the administrator in EHQ (back end), and the settings are reflected at the front end. Participants use the front end section to insert pins in the consultation area along with pin details such as comments, photos, responses to survey questions and so on. They can also view overlays in the map that are set by system administrators. Places tool enables system administrators to request participants and other users for information that can be tagged to a pin on a map.
Places is an open environment tool, meaning that people can interact with other people's pins, photos and comments too.

NOTE: To understand the process of adding this tool in an administrator’s project’s page and use its various features, read the article on Places.  

The following steps describe how to preview and access various features of the Places tool at the front end.

  1. Select the Projects link from the left menu of EHQ and click on your specific project from the drop-down menu. 

2. This displays the project page. Here, click on Preview button for Places tool. 

The following Places page is displayed.

 This is how the page would appear for a participant to view and access.

  • The branding icon or display of the site logo on the top left of the map page helps retain client branding.
  • On click of the add pin option, the available pins that can be used by the participant on the map are displayed.

The below illustration shows the mapping from the back end administrator view of the Pin categories mapped to the front end participant view:

On click of the option to filter pins, a participant can select the pins to be displayed on the map, this is useful when there is a lot of participation.

A participant might want to filter out inessential pins, or pins they are not interested in and retain only the required ones. For example, to filter out all the pins, the participant must remove the blue tick, as indicated in the figure below. On doing this, only ‘Picnic area’ pin(s) are displayed in the consultation area. 

If multiple participants have inserted pins in the set consultation area, a participant can select the Show Only My Pins checkbox to display only that participant’s pins.

  • A participant can view all the activity that has happened on the tool by clicking on the activity feed.

Clicking on the 'View' link will show further details of the pin added and brings that pin to the center of the map.

  • Participants can search for a place on the map by entering keywords of the location they are looking for, in the Search box. They can search for a location only within the area of consultation. 
  • Participants can magnify and reduce the magnification of an area by clicking on the Zoom in and Zoom out buttons provided on the map.

Understanding Front End of the Places ToolThis section aims to explain the various features of Places available at the front end. Participants use this page to express their opinions and respond to survey questions. 

The following steps explain how participants can use the front end.

1. To add a pin, participant must drag and drop the pin inside the set boundary. 

The following screen is displayed. Participants can click the X in case they want to delete the pin and not proceed.

NOTE: The address will be displayed on the pin, only if the system administrator selects the Show address on pins option in the Participation settings section.

2. In the Add Pin box, participants must do the following:
  - Add an appropriate comment in the Add your Comment text box, if not optional.
  - Click the Add Photo link to add an appropriate photograph. A dialog box is displayed. Navigate to the location where the photograph is located and click on it. The photo is displayed in the Add Pin Details box, as illustrated in the figure below.
Note: The Add Photo button is displayed, only if the system administrator selects the Allow photo upload option in the Places page.

 - If a survey has been created, then the participants will have to respond to the survey questions.
 - Then click Submit. After clicking Submit, the following screen is displayed. Click the Back arrow button to add more pins in the consultation area.

Note: Participants CANNOT delete a pin after it is submitted. However, they can edit it by clicking the three dots, as shown below, participants can choose to Edit the pin. The position of a pin can be changed by dragging it to the required position. After making the necessary changes, the participants will have to submit again to save the changes.

4. When a participant clicks on a pin, it 'grows bigger' to differentiate it from other pins on the map and the details of the pin are displayed. 

5. Pins have a unique id, called a 'Marker Id' to enable unique identification of a pin. This also means that each pin has a unique URL. To get the URL just click on the pin (which will bring it to focus on the map) and then copy the browser displayed URL to share this unique pin. In the example below the URL is - https://demonstration.engagementhq.com/places/maps/Park#marker-7572 When a user clicks on the URL, the map will open with marker id pin 7572 in focus.

6. A participant can also alert or report a pin to an administrator by using the Report functionality.

What's next : Read our article on How to rearrange the order of tools on your project page.

Did this answer your question?