You are here:
< Back

With the mapwize widget you can embed indoor maps created at mapwize.io and create interactive buttons that navigate the map to show directions to pre-defined places, filter places by type and more.

Display venue
At the widget inputs under parameters tab you must fill both Venue ID and API key to show your venue.

To get your venue ID open https://studio.mapwize.io/ and navigate to the Venue page, then scroll down at the right side, and copy the Venue ID fomr there. You can also get it by making an URL on the Url generator page, and selecting Other options -> Only this venue? -> yes, then copying this URL into the URL input field in our editor.

To get your API key navigate to Home then to Api keys page from the left side menu

Create directions
Directions are paths defined between two places on the map.
Places on the map are defined by Place IDs which you can get by navigating to the Places menu in https://studio.mapwize.io/ selecting a place, then scrolling down on the right side menu you can see it displayed in the Id field.
For the starting position of the direction you have to define a Place ID either in the User position field of the widget, or set it separately on each of your screen. For the latter, right click on a screen on the Home page, select Manage screen / Set / Bind data row and enter the id in the field, and also enable the ‘Allow screen start position’ checkbox on the widget.
For the end position place an Image or a Text widget, at the inputs select the Other tab, and at the bottom set the Click type to Mapwize action, then for Action select Direction end point, then in the Action value field enter your designated place’s ID.

Show a place
You can zoom in on a place the same way you make the direction above, just remove the starting position from the Mapwize widget

Hide search bar
You can hide/show the search bar on button press inside the content.
Place an Image or a Text widget, at the inputs select the Other tab, and at the bottom set the Click type to Mapwize action, then for Action select Search bar visibility, then in the Action value field enter either the word “hide” or the word “show”, without the quotation marks.

Show places by type
You can show multiple places at once filtered by place types.
Place an Image or a Text widget, at the inputs select the Other tab, and at the bottom set the Click type to Mapwize action, then for Action select Filter places, then click on the Select button and choose your designated place types.

Keyword search
You can define a search phrase on a button, which when pressed will enter the phrase into the search bar of the Mapwize widget and list results in a dropdown.
Place an Image or a Text widget, at the inputs select the Other tab, and at the bottom set the Click type to Mapwize action, then for Action select Search for keyword, then in the Action value field enter your search phrase.

Reset
You can remove placed markers and directions, and reset the map to it’s starting position, bearing (rotation inside the map) and pitch (tilt) to default.
Place an Image or a Text widget, at the inputs select the Other tab, and at the bottom set the Click type to Mapwize action, then for Action select Reset, and leave the Action velue empty.

You can also define a time in seconds which after the map will reset by selecting a non-zero value on the Reset position slider.

React to events from the map
When a user selects a place on a map it’s name will be emitted in an event.
In the right side menu in our editor go the Content tab, and open the Edit sensor events modal, Add an action, and in the Sensor event column enter the name of the place, then bind any action.