Welcome to Purple Support

Maps Setup Guide

  • Updated

To make changes to Maps, log in to the web admin site.

Purple will provide your login username and password via email.

We also have implementation guides available for Asset Tracking and Wayfinding

Adding content

Add a location

After logging in, the Maps homepage will load. To navigate to the Maps homepage from other pages, click the three lines in the top left of the screen and select ‘Maps’.

From the Maps homepage, select the ‘Add location’ button: 1 add location.png

Next, enter:

  • The location’s address
  • A location name
  • Description for easy reference
  • A location ID, if using blue-dot functionality
    • The location ID should correspond to the IndoorAtlas location ID. This will be handled by the Purple Solutions team in the first instance

After entering the address, the map area will automatically update to reflect the input. You can drag and resize the shape so it better fits your location:

2 map.png

Best practice
Bounds should encompass all buildings and include a slight buffer zone, incorporating nearby main roads. Making them too large will result in the user having to scroll an excessive amount, while making them too small will result in locations being impossible to build.

Once complete, click ‘Finish’.

Bounds can be edited after creation from the Maps > Locations page by clicking the three dots at the right hand side of the location you want to alter. Select ‘Edit location’ then redraw the bounds by dragging the shape to the desired fit.

Add a building

Select the location by clicking its name from the Maps homepage.

This will take you to a page where you can:

  • Edit existing areas, by selecting the three dots on the right hand side then clicking ‘Edit building'
  • Add a new building, by clicking 'Add building' 
  • Delete areas, by selecting the three right-hand side dots then ‘Delete’
  • Add new images, by selecting the Image library

The external grounds are automatically created from the bounds that you have set and include the areas outside of your buildings.

You can switch between list view and map view by clicking the icons above the locations: 2a maps.png

To add a building, select ‘Add building’.

Plot building walls by selecting every corner of the building, then inputting a name and description:

3.png

4.png

To help with drawing the building, it may be beneficial to switch to ‘Satellite view’:

5.png > 6.png

To view satellite mode, simply click the layer button in the bottom left of the screen:

7.png

Once drawn, click ‘Finish’.

Add a floor plan

The image library is available from the same page as the floor plan, within Maps > Locations. See more information on the image library here.

Click into the name of the building you created:

8.png

Select the ‘Add floor plan’ button.

The next step is to upload an SVG image file:

9.png

Either drag your file into the box or select ‘Browse…’ to upload. This will show a small preview image.

Click ‘Next’ and enter a suitable Name, Description, Floor Level, and Altitude. The Altitude and  Floor ID only need added if using Indoor Atlas to support Wayfinding and Asset Tracking elements. If Indoor Atlas is being used:

  • The Altitude refers to the height of each floor in relation to the ground floor and only needs to be approximate
  • The Floor ID should correspond to the Indoor Atlas Location ID

Select ‘Next’. The following step concerns floor plan placement. Align the outer edges of the image with your building outline by dragging and rotating your newly imported SVG image. Latitude, longitude, rotation, opacity and scale can be entered from the sidebar to help achieve accurate positioning:

10.png

You can adjust the size of the image by dragging the four corners. Change the placement by clicking on the image and dragging it, and adjust rotation by clicking the arrow at the top of the image.

Select ‘Finish’ to create the floor plan. The following message will show upon successful insertion:

11.png

 

Editing and adding floor plan elements

Once the floor plan image has been uploaded, additional elements can be inserted:

12.png

Changes made will not auto-save so remember to select ‘Save’ periodically.

Any elements can be deleted by clicking the three dots ‘…’ next to the element’s title in the righthand sidebar that appears upon selection:

13.png

Change map position

Select the hand icon from the toolbar, then click and drag the map until you get your desired view.

Add a destination

Select the pin icon from the toolbar, then click the map where you would like the destination marker to appear. A side panel will appear:

 - In the 'About’ tab you can: edit the name and description, include a website that the destination will link to, select whether to show the market and label, and define whether the marker always shows or only when zoomed in.

Clicking the blue comment box – 16.png– brings up the image selection option. Read more about the image library here.

When ‘Show marker’ or ‘Show label’ are selected, they will appear no matter how far the user is zoomed in or out. This functionality can be helpful to highlight exits and entrances, as well as important markers such as main reception desks.

 

- The ‘Category’ tab includes a dropdown menu to select the category that best describes the destination.

Selecting ‘Manage categories’ allows you to add or edit categories, including the insertion of related keywords for search terms which helps users find the destination.

Best practice
It’s important to add keywords to enable end users to more easily find relevant information. Best practice is to add multiple search terms for every category.

Suggested terms show to help you include relevant keywords. You need to initially select the Category, then search terms are proposed. Clicking the search term will add it as a related keyword. You can also add a custom search term by using the relevant box:

17.png

Search terms shown are not automatically added until you click them, e.g. ‘Dessert’ below:

18.png

 

- ‘Opening hours’ allows operating times to be selected, including the option to display the opening hours. To accurately display times, select ‘Open and Display Hours’ from the dropdown menu then click the pencil icon beside ‘Hours’. This allows opening days and times to be selected.

Opening hours are created in the local timezone. Common use cases include setting opening times for any food or beverage establishments, as well as for bathrooms.

 

- The ‘Routing’ tab enables a route to be created to help users navigate to the destination with a Wayfinding subscription. After creating a route, the default is for the destination to be linked to the closest node.

The ‘Automatically find the closest node’ option can be turned off, in which case it gives you the option to select an associated node to direct users to the location.

Add Square, off-shape and circular icons

To add these elements , select the appropriate shape required, click the map at the position you wish to place the shape, and drag to fit.

To quickly hide or close off an area, create a shape then overlay it on the map area. This can be particularly useful for temporary closure of structures such as corridors, as the shapes are easy to remove as well as insert. The shape can be recolored so as to blend in with other backgrounds to more easily denote closures.

Colors, opacity and border thickness are changed by selecting the circular buttons at the bottom of the map. The option to duplicate and delete shapes are also present in the same menu bar:

20.png

Setting up routes

Select the routing icon 21.png . You will then be prompted to draw your new route on the map:

22.png

Each node and edge will appear on the left-hand side of the screen. The node is the white dot where turns can be made, while the edge is the straight line where people can walk.

Best practice
When implementing the routes, it’s best to aim for each edge to be in the center of corridors. The routes will show to end users and look better when centered as much as possible.

It’s not possible to have a standalone node by itself. If you delete a node, it also deletes the edges that are joined to it.

Edges are by default multi-directional so can be traversed both ways. Nodes and edges will automatically join to one another when close enough, for ease of use.

Edge properties

Click on an edge to bring up the ‘Edge properties’ on the right-hand side of the screen. The directions are automatically populated with a northern bearing. E.g. the below edge populates with “Walk east” for direction A to B, and “Walk west” for direction B to A:

23.png

The description can be modified in the ‘Edge properties’ sidebar.

Corridors can be marked as Active or Inactive. If the corridor is completely closed, you have to mark the corridor as inactive for both ‘Direction A to B’ and ‘Direction B to A’:

24.png

It’s possible to have one direction open and the other closed.

In the same ‘Edge properties’ sidebar, the ‘Weight’ defines the prioritization of a route. This means main routes with wider corridors or points of interest can be highlighted over alternative paths. 1 has the highest route priority, with 10 the lowest.

Routes are marked as wheelchair accessible by default. To alter this, scroll down in ‘Edge properties’ and turn the ‘Wheelchair accessible’ toggle off:

25.png

Node properties

Selecting a node will bring up the ‘Node properties’ sidebar. The name of the node can be altered, along with the option to upload an icon and set the label to show with the node name on the map for users:

26.png

The marker can be set to always show no matter how zoomed in or out the user is, or it can be set to only show when zoomed in.

Click ‘Portal options’ to designate the node as a portal. This could mean it is an escalator, elevator, entrance/exit, skybridge, or stairs. Selecting ‘Add connection’ will allow you to link it with portals on other floors to help users navigate between buildings or floors. When changing between floors or buildings, a loading screen will show. Portals are designed to be connected like-for-like, e.g. a ground floor reception elevator to the first floor elevator, so the user has a seamless experience.

Best practice
Create a naming convention when managing nodes to assist with connecting multiple together. Including the node’s name, location and level is best practice (e.g. ground floor lobby elevator, first floor reception escalator).

To rename nodes, click on the desired node within the map or from the 'Content' left-hand side bar, and fill in the new name in the right-hand side 'Node properties' section. 

Insert an image or icon

Select the image icon from the toolbar (12.png) on the floor plan maps page, then click on the map where you would like the image to appear.

A default image will appear, as well as a sidebar on the right of the screen. Scroll down this sidebar to select a different icon from the image library. An array of icons are available, including elements such as doorways, WiFi, parking, and exit points.

Give the image a name, and select the scale, latitude and longitude, width, height, rotation and opacity. Many of these image properties can also be changed by dragging and resizing the image on the map.  Size and rotation can be altered by selecting the four corners of the image and using the arrow above the image.

The image can be automatically scaled and rotated as a user zooms and pans around the map by toggling ‘Scale and rotate with zoom’. Having this turned on means that the image stays a consistent size and angle regardless of how much the user is zoomed in or out.

Click here for instructions on how to upload your own image.  

Select ‘Save’ once complete.

Plotting corners of the geozone

Geozones are only relevant for Asset Tracking notifications.

To insert a geozone, click the location point icon 28.png, then drag the shape to include the desired location. This enables multiple geozones to be present in one location.

Geozone color can be altered by selecting the circle icon that appears at the bottom of the map. There is also the option to duplicate the geozone, or delete it:

29.png

Reorder Floors

After navigating to Maps > Location > Building or Area, you can view and reorder floors.

Select ‘Floor order’ then drag each floor to the order in which you want them to display to users:

30.png

The order shows to end users so it’s important these are arranged in a logical fashion.

Creating a map layer

With the appropriate paid for plan, you can edit which group of users will see certain elements to help increase relevancy.

For example, if only staff have WiFi access in a certain area, this can be marked using a symbol that shows only to employees.

To implement this functionality, after inserting the floor plan a sidebar will show with Map Layers.

To add a new Map Layer, click the ‘+’ button near the top of the sidebar:

31.png

You can then select permission groups:

32.png

 

Once complete, click ‘Create’.  Anything added to this map layer will only show for the chosen groups that have been given permission. For example, the below setting which has only Administrative staff seeing icons highlighting Wi-Fi capabilities:

33.png

Click ‘Save’ in the top right of the screen before navigating away from the page.

 

Uploading an image

From the maps homepage, click the desired location.

This will take you to the ‘Buildings & areas’ tab. You need to select ‘Image library’:

34.png

From here, click ‘Upload image’. The image needs to be in SVG format to be accepted. A message will appear, confirming the successful upload.

You can now insert your image on the floor plan page, following the instructions here.

 

Editing/Deleting a location

From the Maps homepage, select the three dots on the right of the screen to open a dropdown menu.

From here, you can select to edit the location – including updating the address, name and description – or delete the entry. Confirming the deletion will mean all information contained within will be permanently lost.

35.png

Join WiFi Prompt

A ‘WiFi Integration’ tab is available after logging in and selecting a location. This provides the option to enter a WiFi name and optional link:

This tab allows the admin user to enter:

  • The WiFi name which displays to the end user
  • A link which redirects users when selected

The prompt can also be deleted from this tab. Once deleted it will no longer display to end users.

With this functionality enabled, a message will display which encourages users to connect to an available WiFi network:

A hyperlink can be implemented that when the prompt is selected can, for example, link users to download a user profile which will provide future seamless connection.

The prompt displays at the bottom of the screen for mobile devices, and at the top-left underneath the search bar for web.

Translations

After selecting a location in the Admin site, the language button is in the top-right of the screen. Upon selection, a pop up displays which shows available languages for the location:

From the settings tab on the admin side of the platform, the Languages tab can be selected and additional languages added:

Selecting ‘Add a language’ provides a list of all available languages. After adding a language, it becomes available to select for each location.

Languages can also be deleted from this tab by selecting the three dots next to the language you want to remove.

Descriptions and names of nodes and edges are translated, as are directions. The names of customers, location names and addresses aren’t automatically translated. A toggle available in the admin side allows points of interest to be omitted from automatic translation.

The default language will be based on the user’s browser language. If unable to gather this information the platform defaults to the primary language set on the admin side.

Translations are supported in web browsers and kiosks.

Settings

After logging in, click the cogwheel in the top-right hand corner from any page: 36.png

Terms and conditions

The first tab is for ‘Terms and conditions’. Up to three can be configured.

The text box options include insertion of links and images. After inserting the desired content, the button in the bottom left enables the content to be enabled or disabled. Once ‘Enabled’ is selected, select ‘Save’ and the live content will update.

API Keys

The ‘API keys’ tab allows the generation of a key for Asset Tracking or Wayfinding. Click ‘Generate key’ and select the desired product, fill the name and expiry date, then select ‘Generate’.

Make sure to download or copy the generated API key as it will not be possible to view again after selecting ‘Close’.

Selecting the three dots at the right-hand side of the screen allows you to edit the details of the API key or expire the key. If ‘Expire key’ is selected, this cannot be undone.

Theme

The color theme can be altered on the left-hand side of the screen, with the primary color determining the top navigation bar color, and the secondary color responsible for determining the color of fonts and icons. Click ‘Save’ once updated. The destination point colors won’t change.

To upload a logo either click ‘Browse…’ within the relevant box, or drag the file into the primary or secondary logo box. The file needs to be SVG format.

The primary logo will display in the top left of the screen unless ‘Hide primary logo’ is selected, while the secondary logo appears in certain pop-up boxes such as when sharing a link. Select ‘Save’ once complete.

Selecting ‘Restore defaults’ will restore the defaults for the colors and logos. You have to then select ‘Save’ if you wish the defaults to be restored. This cannot be reversed.

Configuration

Within the configuration tab, the unit of measurement of imperial or metric can be selected.

The website URL is the URL that shows on the site.

The SSO Client ID shows the associated ID for the login page.

The Indoor Atlas Key and Indoor Atlas Secret key are generated when Indoor Atlas is being used for Wayfinding purposes.

Share online:
Was this article helpful?
0 out of 0 found this helpful