< Back

Mapwize Widget

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 the parameters, 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 Venues page, then scroll down at the right side, and copy the Venue ID from there. You can also get it by making an URL on the Url generator page, and selecting Other options -> Only this venue? -> yes, then copy this URL into the URL input field in our editor.

To get your API key, navigate to Home then to the 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 screens. 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 endpoint, 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 its 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 value 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. This can be set on the Mapwize widget.

React to events from the map

When a user selects a place on a map its name will be emitted in an event.
In the right side menu in our editor go to 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.