Maptionnaire User Guide

Maptionnaire User Guide Vol. 3.0

© Mapita
© Maptionnaire
Kanavaranta 7D, 00160 Helsinki, Finland
maptionnaire.com
sales@mapita.fi
Click the headings to skip ahead in the guide

Quickstart for creating your questionnaire ...................................................................................... 1

1. Introduction to Maptionnaire ................................................................................................................. 3
1.1. Structure of Maptionnaire .......................................................................................................... 3
Editor Main View ............................................................................................................................. 3
Questionnaire Editor..................................................................................................................... 4
Data Analysis Tool.......................................................................................................................... 5
1.2. Structure of a questionnaire ..................................................................................................... 6
Front page .......................................................................................................................................... 6
Question pages................................................................................................................................ 6
Popup pages ..................................................................................................................................... 7
End page .............................................................................................................................................. 7
2. Designing your question pages ............................................................................................................. 8
2.1. Managing the question pages ................................................................................................ 8
Creating new pages ........................................................................................................................ 8
Copying pages ................................................................................................................................... 8
Removing pages ...................................................................................................................8
Changing page settings................................................................................................................ 9
2.2. Questionnaire elements on question pages.............................................................. 10
Adding and removing elements ........................................................................................... 10
Copying elements ......................................................................................................................... 10
2.3. Element options on question pages ................................................................................ 11
Drawbutton ....................................................................................................................................... 11
Multiple choice question........................................................................................................... 12
Multiple choice grid ..................................................................................................................... 14
Hand-drawn layers............................................................................................................ 15
Range .................................................................................................................................................... 16
Image .................................................................................................................................................... 17
Open question................................................................................................................................. 17
Headings and text paragraphs .............................................................................................. 17
Shapefile and raster overlays.................................................................................................. 18
2.4. Additional settings for questionnaire elements ..................................................... 19
Detach answers from other data .......................................................................................... 19
Obligatory questions ................................................................................................................... 19
3. Language settings ........................................................................................................................................... 20
Default language.............................................................................................................................. 20
Manage translations ...................................................................................................................... 20
Create a new translation.............................................................................................................. 21
Outsourcing translations ............................................................................................................. 21
Enforcing the language setting ............................................................................................... 22
Respondents’ language options ............................................................................................. 22
4. Spatial settings ................................................................................................................................................... 23
4.1. Setting up a default base map ............................................................................................. 23
Locate your base map and choose its scale .................................................................... 24
Choose your base map................................................................................................................. 24
4.2. Setting up your own base map............................................................................................ 27
Manage personal maps................................................................................................................ 27
Uploading a map through WMS (Web Map Service) ................................................. 27
Uploading a map template created in MapBox or Leaflet ...................................... 28
Uploading images as maps ....................................................................................................... 29
Uploading a georeferenced raster image (Geo TIFF) ................................................. 29
 Uploading vector data (Shapefile) ......................................................................................... 30
4.3. Coordinate systems....................................................................................................................... 31
Coordinate systems for default base maps ...................................................................... 31
Coordinate systems for in- and output data ................................................................... 31
5. General settings of your questionnaire ....................................................................................... 32
5.1. Structuring the answering session .................................................................................... 32
Set branching rules........................................................................................................................ 33
Set a minimum zoom level for map responses ............................................................ 34
Allow interrupted answering sessions................................................................................ 34
Hide respondent’s previous drawings................................................................................ 34
Allow sharing in social media .................................................................................................. 35
Show other’s responses on the base map ....................................................................... 35
Allow commenting on other’s map responses ............................................................. 36
Redirect after leaving the questionnaire........................................................................... 36
Responsiveness of Maptionnaire questionnaires ........................................................ 36
5.2. Styling your questionnaire ...................................................................................................... 37
Change the layout .......................................................................................................................... 37
Add your own picture on the front page ......................................................................... 37
Show page numbering ................................................................................................................ 38
Change the color scheme and font size............................................................................ 38
Hide the front page....................................................................................................................... 38
6. Publishing your questionnaire ............................................................................................................ 39
Distribute your questionnaire ................................................................................................ 39
Define the answering period .................................................................................................. 39
Set up a password ......................................................................................................................... 40
Saving your questionnaire and the questionnaire answers.................................. 40
7. Data Analysis Tool ........................................................................................................................................... 41
7.1. Browse and filter data ................................................................................................................. 42
Show map responses .................................................................................................................. 42
Filter map responses based on their popup questions........................................... 42
Browse popup responses.......................................................................................................... 43
Filter map responses based on answers to other questions................................ 43
Show only map responses commented by others..................................................... 44
Analyze pictures uploaded by the respondents .......................................................... 44
7.2. Visualize your data......................................................................................................................... 45
Style separate elements ............................................................................................................. 45
Heatmap ............................................................................................................................................. 46
Density squares............................................................................................................................... 47
8. Managing and exporting data ............................................................................................................. 48
8.1. Manage your data .......................................................................................................................... 48
Data management view ............................................................................................................. 48
8.2. Export your data .............................................................................................................................. 49
Export to XLSX (Microsoft Excel) ......................................................................................... 49
Export to shapefile (QGIS and ESRI products) .............................................................. 49
Export to TAB (MapInfo) ............................................................................................................ 50
Export answers disconnected from the main data .................................................... 50
9. Organizational management ................................................................................................................ 51
Organizational structure ............................................................................................................ 51
Add new members to your organization ........................................................................ 51
Set a default location for your questionnaires ............................................................. 51
Change the ownership of a questionnaire ..................................................................... 52
Sharing translation and data analysis rights.................................................................. 52
Change the language of your user interface................................................................. 53
Upload maps and images for the use of your organization ................................ 53
Quickstart for creating your questionnaire
Step 1: Log into Maptionnaire at
https://maptionnaire.com/.
Step 2: In the Editor Main View, create a
new questionnaire by choosing ‘create
new’ and your preferred default language.
Step 3: Create the front page of your
questionnaire by naming it and offering a
short introduction.
Step 4: Add new pages to your
questionnaire by choosing create new
page ( ) or by copying existing pages
from your other questionnaires.
Step 5: Customize the pages to best serve
your purpose. You can add several survey
elements such as drawbuttons, multiple
choice, range or open questions and place
informative captions, pictures and
headings to help structure the pages.
Discover how you can further customize
these elements by choosing the settings
tab ( ). Keep in mind that you’ll be able
to set popup questions to all drawbutton
elements and to direct the course of the
questionnaire based on the respondent’s
answers by setting branching rules.
Step 6: When you are pleased with your
content, set the scale and location of your
map in the embedded map preview. Drag
the map to the location of your choosing,
and find the best scale by choosing a zoom
level. You can change the base map by
choosing one or many of the several open
source alternatives.
Step 7: Define the general settings of your
questionnaire, such as the start and end
date and an optional password.
Step 8: Give finishing touches to your
questionnaire by styling it and providing
translations.
Step 9: Congratulations, your
questionnaire is ready for use! Distribute it
by sharing the link by e-mail or in social
media platforms of your choosing.
How to get the most out of this User Guide

This User Guide provides you with the basic skill set needed for successfully designing your
questionnaire and getting the most out of your participation processes.

Follow the links within this Guide and remember to check out the User Guide video clips
demonstrating some of Maptionnaire’s functions. You’ll find links to specific clips in their
respective chapters.

Customize your questionnaire to your specific needs – bring in your own materials or enable
interaction between your respondents for a start. The possibilities of Maptionnaire are
endless, come discover them with us!

Tip: Search for key words and phrases within this User Guide with the following
shortcut: (Ctrl + F).

2
1. Introduction to Maptionnaire
1.1. Structure of Maptionnaire
Find below a brief introduction to the main user interfaces of Maptionnaire. You’ll discover
more detailed information on their specific functions in the upcoming chapters of this User
Guide.

Editor Main View

Log in to Maptionnaire and you’ll find
yourself in the Editor Main View. This is the
main page of your organization and the
main interface for accessing and
managing your materials. In the Editor
Main View you’ll be able to create new
questionnaires, as well as to delete them
and to enter the editing views of individual
questionnaires. You can access options for
analyzing, managing and exporting your
data from the Response data menus of
individual questionnaires. Here you can
also manage organizational settings –
change the name and default location of
your organization, upload supporting
materials for your organization’s use or
administer the members of your
organization.

3
Questionnaire Editor
As you open an existing questionnaire or
create a new one, you’ll enter the
Questionnaire Editor. This is the main user
interface for designing and customizing
your questionnaires. Every questionnaire
has its own Questionnaire Editor page -
change between individual questionnaires
by returning to the Editor Main View.
The diverse functions of the Questionnaire
Editor are introduced in detail in chapters
2. – 6.

Tip: All the changes you apply to your questionnaire in the Questionnaire Editor will
be immediately saved in Maptionnaire and you don’t need to save them separately.
Only adding new translation texts and changing map location and zoom level require
manual saving.

4
Data Analysis Tool
You’ll always be able to export your spatial Access the Data Analysis tool from the
data, but why not start analyzing it in Editor Main View – choose Analyze from
Maptionnaire? The Data Analysis Tool is a the Response data menu of the
great way to quickly visualize and filter questionnaire you wish to work with.
map responses collected by your
questionnaires and to get to know the Learn more about the use of the Data
data on spatial basis. Discover also the Analysis Tool in here, or check out our
analysis functions for your data and User Guide clip on its use.
produce informational visualizations such
as heatmaps and density grids.

5
1.2. Structure of a questionnaire

Familiarize yourself with the general them upload their own pictures to visualize
structure of a Maptionnaire questionnaire. these locations. Customize the answering
Within this structure you’ll be able to find session by setting branching rules
numerous possibilities to customize your defining which question pages or
questionnaire for its specific needs. You elements will be shown or re-locate the
can for instance pose elaborate follow-up whole base map in a map jump based on
questions on all the places, routes and the respondent’s previous answers.
areas marked by your respondents or let

Front page
The ‘face’ of your questionnaire shows its
name and any additional information you
wish to relay to your respondents, and
lets them choose the language of the
questionnaire. If needed, you can hide
the front page and start the
questionnaire from the first question
page.

Question pages
These pages are designed to gather and
relay information from and to your
respondents. Individual pages can
include several diverse elements, such as
varied question types, drawing
possibilities, pictures and texts.

6
Popup pages

Pose follow-up questions to the

respondents with popup question pages.
You can join popup pages to all
drawbutton elements and hand-drawn
layers. Popup pages can include all the
same elements as the actual question
pages. They are a great way to dig deeper
in your respondents’ views and gather
refined spatial data.

Check out a short clip showing how to

set up a popup page.

End page
All the filled in answers will be saved even
if the whole questionnaire has not been
completed. Before leaving the
questionnaire on its final page, the
respondents will have the possibility to
move between all the questionnaire pages
in order to modify their answers. You can
also enable the respondents to return to
the questionnaire even if the answering
session has been interrupted.

Remember to add social media buttons

on the end page and enable the
respondents to share your questionnaire.
You can also define where the
respondent will be directed after
clicking leaving the questionnaire.

7
2. Designing your question pages

2.1. Managing the question pages

The number of question pages in a questionnaire is unlimited, and you can structure the
length to best suit your project’s needs. You may change the order of individual pages in
your questionnaire by dragging them.

Each question page consists of three tabs, with the initial view opening to the editing
tab, ( ) and possibilities to choose the settings ( ) or the delete ( ) tabs.

Creating new pages

Create a new question page by choosing the
add new button under the Pages heading. Name
your page with the title you wish it to have or
leave it unnamed.

Copying pages
Copy pages from your existing questionnaires
by choosing the copy an existing page button. If
you copy the same page several times into your
questionnaire, remember that all question
elements need to be named uniquely.

Removing pages
You can delete unnecessary pages by choosing
the delete tab and confirming the action.
Deleting a page will remove all the elements you
have created for that page.

8
Changing page settings
Open the settings tab and change the
settings of individual pages. You can for
example define an individual map view for
separate pages by setting the location
and zoom level - this might be useful if
you wish to ask question on different
locations in your questionnaire. Here you
can also set the elements of the page to
appear in a random order to the
respondents by choosing randomize the
order of drawbuttons.

Tip: When designing your questionnaire, you’ll be able to check in on its preview at
any point by clicking the ‘open questionnaire’ button at the upper left corner of the
questionnaire editing view. The preview of the questionnaire will open in a new tab
of your browser. Refresh this page to see the changes made in the editing view.

9
2.2. Questionnaire elements on question pages
Elements are the building blocks of your question pages. You may use them to gather or
relay information and to structure the questionnaire with supporting text or pictures. Like
separate question pages, also individual elements have their own properties bar with tabs
for the general settings ( ) and for editing ( ), deleting ( ) and copying ( ) their
content.

Adding and removing elements

Add new elements with the add content button
( ) in the page’s editing view. The amount of
elements on one page is not limited, but
consider dividing long pages in order to better
structure your questionnaire. You can modify
the order of elements in one page or between
pages by dragging them.

You may remove any elements by clicking them

and choosing the Delete tab.

Copying elements
Duplicate any element by choosing the Copy tab
in the elements properties. The duplicated
element will appear on the same page
underneath the copied element.

Remember to name your new element

individually, as all the question elements need
to be identified by distinct names (paragraphs
of text can be identical).

10
2.3. Element options on question pages

Drawbutton
When you want your respondents to point,
locate or describe places, areas or routes
on a map, add a drawbutton element on
the page. Choose between point, line or
area (polygon) format depending on what
you wish your respondents to locate.

Provide your drawbutton element with a

title and optionally with an assisting text.
You can set the help text to be visible also
while the respondent is marking map
responses in the element’s settings tab.
Get started by watching a User Guide clip
on the use of drawbuttons.

Popup questions Uploading pictures

If you wish to pose follow-up questions on
map responses, you may create an
additional popup page to appear after any
response created by the drawbutton
function. Set the content of the popup
page by choosing the Popup tab. You may
structure the page from the same
elements as the question pages. Check out
a User Guide clip on setting popup pages
to drawbuttons.
You can further customize drawbutton
elements by allowing your respondents to
upload pictures related to their map
responses. Enable this function by ticking
the Enable photo upload box in the
element’s settings.
Learn how to define the visibility of the
respondent’s own or others previous
map responses.

Tip: Do you want to change the icon of a drawbutton in point form? Choose one from
the many options provided in here, and write its name in the Icon name field.

11
Multiple choice question
If you wish your respondent to choose
from a pre-defined set of answers, a
multiple choice question is a good option.
The available types of multiple choice
questions are a list showing all the options,
a drop down menu or a priority
assessment.
Choose many or choose one
If you wish the respondent to choose only
one of the given options, define the
element type as choose one or dropdown
list. Dropdown lists work best when the
respondent is choosing from a familiar set
of options, such as years, zip codes or list
of cities. Showing all the options on the
question page gives a better view on a
multiple choice question with a lot of new
12
information. If you want to enable the
respondents to choose several options,
define the element type as choose many.
Enter the settings tab to define how many
options the respondents are allowed to
choose.
Priority assessment
You can also use a multiple choice
question element in order to let the
respondents to prioritize the options.
Choose priority assessment as the element
type, and the respondents will be asked to
divide 100 points (or percent) between the
different options. You can also let the
respondents prioritize things by using
multiple choice grids and allowing
selecting options once.
Pictures as answer options
Sometimes adding pictures is the best way
to elaborate on differences between
multiple answer options. You can set
pictures to accompany the answer options
from the settings tab. Here each of the
answer options you have previously
entered will be provided with an Image for
option dropdown list where you can
choose any of your previously uploaded
pictures. Pay attention to get the size right
– large pictures might be difficult to
perceive in the context of multiple choice
questions.
Set map jumps based on the answer
option
If you wish to focus the rest of the
questionnaire on a certain area based on a
multiple choice answer, you can create a
map jump to accompany the question. Set
the map jump for each multiple choice
answer option from the settings tab. Here
you’ll see a map window accompanying
every previously entered answer option.
13
Just drag the map to the right location, set
the zoom level and save the map jump.
In order to see how a map jump works in
action, have a look at this User Guide clip.
Customize
If you have many answer options in a
multiple choice question, you might want
to randomize the order they are presented
to different questionnaire respondents.
You can do this by ticking the Randomize
the order of options box in the element’s
settings tab.
You can also add an open option field to
any of the multiple choice question types
by filling in the Follow-up question field. If
left empty, no open field will be shown.
Do you want to learn how to direct the
course of the questionnaire based on
multiple choice answers? Learn more on
the branching rules.
Multiple choice grid
Multiple choice grid is an extended version
of the multiple choice question and consist
of similar element options. The grid is
generally a great way to make your
questionnaire more compact when you
have a set of questions all featuring the
same answer options.
Choose one or choose many
As with multiple choice questions, choose
the element type according to how many
of the options you want your respondents
to choose. Choose one allows for one
option per question, whereas choose
many allows several options to be
selected. Define the maximum number of
options the respondent may select in the
14
element’s settings tab. Dropdown list
shows the answer options in a dropdown
menu.
Customize
If you need to create a multiple choice grid
where each answer option may be chosen
only one time, tick the Each answer can be
selected only once box from the element’s
settings tab.
As with the multiple choice question, you
may make the questions to appear in an
undefined order for each respondent by
choosing Randomize the question order in
the settings tab.
Hand-drawn map layers
You may pinpoint locations and draw
routes and areas onto individual question
pages. These hand-drawn layers will be
visible for the respondents on top of the
base map and work well when you need to
provide local information or ask questions
concerning predefined locations.
Add a new hand-drawn map element and
draw the wanted layers in the adjoined
map window. Choose between point, line
and polygon form depending on what you
wish to show. You’ll find tools for editing
and deleting your drawings on the map
window.
Popup pages
You can set popup elements (questions or
information) to appear after the hand-
drawn layer has been selected. Set the
content of the popup pages from the
Popup tab. You may structure the page
from the same elements as the question
pages.
Layer styles
Expand the Edit style section above the
map window in order to access the style
settings. You can change the color of
points and lines, the fill color and
transparency of polygons, line width and
the point radius.
Customize
You may customize the visibility of your
hand-drawn layers in the element’s
settings tab. As a default setting, the
respondents will be able to hide the layer
in their base map view. If you wish the
hand-drawn layer to be visible on all times,
tick the Do not show in layer menu box. If
you wish the layer to be visible only after
being chosen by the respondent, tick Do
not show on the map by default. Choose
Hide label if you don’t wish the name of
the layer to appear as a hover.
The hand-drawn layers are by default
restricted to the pages they are created in
and do not appear on the other pages of
the questionnaire. If you want your layer to
be visible on all the pages, tick the Show
on all pages box.
Check out a User Guide clip on hand-
drawn layer elements.

Tip: Click open the Edit raw data button and you’ll be able to see and edit the raw data
in GeoJSON form. Edit existing data or paste your own data here.

Tip: Notify your respondents that if they are using a mobile device, they need to close
the informative box in order to see hand-drawn layers and the base map.

15
Range
The range element allows the respondents
to position themselves on a scale between
two opposing statements, viewpoints or
opinions.
Name the question and the minimum and
maximum ends of the range scale. You
may also change the numeric scale of the
range from the default 100 points – for
example limit the range to five and you’ll
have the usual range from one to five.
16
Customize
If you have a set of many consecutive
range elements, you don’t necessarily
need to show the question adjoined to
each one of them. Hide the title by
choosing Hide the question in the
element’s settings tab. Here you can also
define whether the question is positioned
in the middle of the range or to its side and
change the color of the range buttons.
Image
You can add pictures between question
elements to support them and enliven your
questionnaire. If you are using a base map of
your own design, you can for example add the
legend to accompany your question texts.

Choose any of your previously uploaded

pictures or add a new image. Consider the size
of your picture, as large pictures might cause the
questionnaire to load slower for your
respondents.

Learn more on the ways you can use your own

images in this User Guide clip.

Open question
Open question consist of a question and an
open text box for the respondents to write in.
Choose between small and big answer field
depending on your question. The small field
(one line) is suitable for names, addresses and
short sentences, the larger one for more
extensive answers. The number of characters in
both box types is nevertheless unlimited.

Headings and text paragraphs

Use the heading and text paragraph elements to
give structure to your questionnaire – provide
additional information between other elements
when it’s needed.

17
Shapefile and raster overlays
Besides adding hand-drawn layers, you
can include imported vector data
(shapefile, .shp) and raster overlays on the
question pages. You can choose from files
previously uploaded for the use of your
organization.
Shapefiles overlays
For shapefile overlays, choose shapefile as
the element type, pick your file from the
dropdown menu and name it accordingly.
You can style the vector data by defining
the line color and width, fill color and
transparency (for polygons) and the radius
for point data.
18
Raster overlays
You can choose any of the maps uploaded
in Maptionnaire as a raster overlay.
Choose the right file from the dropdown
menu and name it.
Customize
Customize the visibility of these layers as
with the hand-drawn layers. For the layer
to be always visible, tick the Do not show
in layer menu box in the element’s
settings. If you wish the layer to be visible
only after being chosen by the respondent,
tick Do not show on the map by default. In
order to make your layer visible on all the
pages, tick the Show on all pages box.
2.4. Additional settings for questionnaire elements

Detach answers from other data

If you wish to detach the answers of one
question element from the other data of the
questionnaire, tick the Disconnect answer from
other data box in the question element’s
settings tab. This feature enables you to collect
data on the respondents’ identity (for example
for a raffle or a mailing list) while preserving
their anonymity regarding other responses.

Obligatory questions

You can define all the interactive question

elements as obligatory to answer by choosing
the Prevent changing page until answered box
in the element’s settings tab. As suggested by
the name, this option does not allow moving
forward in the questionnaire before questions in
the element have been answered to.

Consider carefully when it is necessary to use

this feature – respondents might find it
distracting on questions they are not able or
prepared to answer. Do not set questions within
drawbuttons to be obligatory, as the obligatory
elements are only shown within drawbuttons.
Note that also the multiple choice grids cannot
be set to be obligatory.

19
3. Language settings
Learn here how to manage the language settings and translations of individual
questionnaires. If you wish to change the language of your user interface, click here.

Take a first look at how questionnaire translations are managed in a short User Guide clip.

Default language
Every questionnaire has a default language for
the management of the questionnaire. The
default language will be the language you chose
while creating the questionnaire. It is
recommended not to change the default
language, as this will affect the questionnaire’s
structure and how the responses are saved in
Maptionnaire.

Manage translations
You can translate your questionnaire into any of
the languages listed under Language settings.
These are the language options supported by
the questionnaire’s user interface. Make sure to
translate all the questions and texts you have
produced in order to complete the translation.

You are able to manage and modify your

translations in the Translate menu. All the
languages selected from the list will be shown
with their individual translation templates.

20
Create a new translation

Add a new translation template into the
Translate menu by ticking a new language
box from the list under Language settings.
Once chosen, a new active language
template will appear next to your other
translation. Fill in the translations and
remember to save your modifications.
Check from the preview how the
translation works in your questionnaire.
In the same way, you can remove
translation templates from the Translate
menu by un-ticking the selection in the
language list. The removed translations
will be saved in Maptionnaire, and are
again in your use when you choose to add
them into the Translate menu.
Once translating has begun, it is advisable
not to edit the questionnaire to a large
extent, as the translations provided are
moved to earlier translations after the
main element is changed.

Outsourcing translations
If you are ordering translation services the Translate page and the adjoining
from outside of your organization, you can password given in the same page. Once
allow access to the translation page open separately, the link will open to a
separately from the rest of the password protected view of your Translate
questionnaire. Simply provide a link for page.

21
Enforcing the language setting
You can also change your questionnaire’s would change the language of the
language by changing the language code questionnaire from English to German.
in its public URL address. The language
If no language code is included,
code is formed by the two letters before
Maptionnaire will use the language of
the identification code of the
respondent’s browser or assume the
questionnaire (for example https://
default language.
maptionnaire.com/en/1234/). Here
changing “en” into “de” in the address

Respondent’s language options

All the languages that have been selected Maptionnaire strives to define the
in the language list under Language respondent’s language automatically
settings will be available for the based on their browser’s language
respondents as language options. The settings. If the used language is not
chosen languages will be shown to the available in the questionnaire’s
respondents as language buttons on the translations, Maptionnaire assumes the
questionnaire’s front page. default language.

22
4. Spatial settings
The base map options in Maptionnaire are highly customizable, and support for example
maps published in WMS-servers. Maptionnaire collaborates with all the major web based
map providers, such as MapBox, Bing and Google Maps.

Choose a base map from our collection of default maps or upload your own map or picture
to be the template of your questionnaire. Note that the map options work currently only in
online mode. Get started by checking out a User Guide clip on base map options in
Maptionnaire.

4.1. Setting up a default base map

Define the location and scale of your base map in the Questionnaire Editor under the
heading Location at the beginning. This base map serves as the template for all of your
questionnaire pages. If you wish to customize the base maps of individual questionnaire
pages, move to their settings tabs or learn how to create a map jump with a multiple choice
question.

23
Locate your base map and
choose its scale
Drag the base map in the window of the
Questionnaire Editor to the location of your
choosing. Set in a zoom level in the zoom level
box of the map window - the right level depends
on the scale of your questionnaire. Good values
are often found in integers from 8 to 14, but
you’ll find the right one by experimenting a bit.

Check the scale and location by entering the

questionnaire preview from the upper left
corner of the editing page and adjust if needed.

Choose your base map

Explore the collection of default base maps and
choose one or several that best serve your
project’s needs. Consider especially the scale
and generalization varying between these maps
- what features do you need your respondents
to be able to locate?

You can change the default base map under the

heading Maps in the Questionnaire Editor. If you
don’t change it, the default base map will stay
as the pre-set MapBox base map.

As you see, you may choose several map

simultaneously as long as they are set in the
same coordinate system. Choose several base
maps, and your respondents will have the
possibility to pick the base map they wish to use.

24
MapBox
Simple base map with clear distinctions
between built areas, buildings and green
space. Street and place names, public
buildings.
Coordinate system EPSG:3857
MapBox High Contrast
Simple and stylized base map in grayscale.
Street and place names.
Coordinate system EPSG:3857
25
MapBox Satellite
Updated regularly, MapBox Satellite uses
satellite and aerial imagery from
commercial providers, NASA, and USGS.
Good option when only aerial images are
needed.
Coordinate system EPSG:3857
Roads and Terrain
Visualized from Open Street Maps. Street
and place names, public buildings and
landmarks.
Coordinate system EPSG:3857
Google Hybrid Bing Satellite
Satellite imagery with street and place Satellite imagery with street and place
names, landmarks, public buildings, names, landmarks, public buildings,
commercial services and traffic commercial services and traffic
information. information.

Coordinate system EPSG:3857 Coordinate system EPSG:3857

Wheatpaste
Highly stylized and edgy base map from
the MapBox family.

Coordinate system EPSG:3857

26
4.2. Setting up your own base map
Sometimes setting up your own base map or template is what your project needs. You can
bring your own base map data to Maptionnaire straight in the Questionnaire Editor in
raster (image files such as .jpg, .png or georeferenced Geo TIFF -files) or vector form
(shapefiles). You may also import map templates from other online servers.

If you wish to customize the base maps of individual questionnaire pages, move to the
settings tab of individual question pages.

Managing personal maps

After being uploaded on Maptionnaire, all
your own map data will be shown in the list of
default maps in the Questionnaire Editor and
in the listing of map data in the Management
of maps menu under the Maps header.

Once uploaded, your data will be available for

use in all of your questionnaires. You can
delete your maps in the Management of maps
menu by choosing the delete button. Once
deleted, the map will be deleted from all of
your questionnaires.

Uploading a map through

WMS (Web Map Service)

If you are using maps published in WMS, you

may connect them to Maptionnaire by
choosing the Web Map Service protocol from
the Management of map menu’s create new
drop down menu. In order to upload the map
you need to provide its URL and the target

27
layers (comma as a separator). Name your
map, and provide the necessary info on your
map’s maximum and minimum zoom levels
and copyright.

Coordinate System
You can upload maps published in WMS any
coordinate reference system, but remember to
use Maptionnaire’s default coordinate
systems if you wish to use your WMS map
together with the default base maps.

Overlays and transparency

If you wish to set your map to appear over
another base map, select overlay or mutually
exclusive overlay. Choosing the latter means
that the layer is visible only by itself, not in
combination with other overlays. Select
Transparent if your layer has opacity.

Uploading a map template

created in MapBox or Leaflet
MapBox and Leaflet users may upload their map
templates in the Management of maps menu by
choosing Map Box or Leaflet tileLayer from the
create new map popup menu.

Name your map and provide its identifier – ID

for MapBox and URL for Leaflet tileLayers. Set
the maximum and minimum zoom levels,
provide the copyright info and save your map.

Overlays and transparency

Select the overlay and transparency settings as
for maps uploaded through WMS.
28
Uploading images as maps
You may upload images in basic image formats
(.jpg, .png etc.) by choosing create new in the
Management of maps menu. From the popup
menu choose normal image file. Give your map
a name and find it with the browse option. If you
are using a satellite or aerial picture, mark the
adjoined box.

Remember that basic image file formats are not

georeferenced, and cannot be bound to any
geographical coordinate system.

Learn more on the ways you can use your own

images in this User Guide clip.

Uploading a georeferenced
raster image (Geo TIFF)
You may upload georeferenced raster images in
Geo TIFF format from the Management of maps
menu by choosing georeferenced raster image
from the create a new map popup menu.

Upload your map and name it. If you wish to

support your Geo TIFF file with an optional
World file (.tfw) you may add it here – make sure
to use one if your image is in any other
coordinate system than those supported by
Maptionnaire. You can see these default
systems in the dropdown list under Coordinate
Reference System. If you are using also a base
map, remember to set the image to the same
coordinate reference system.

29
You can also choose to set your Geo TIFF image
as a mutually exclusive overlay, but do this only
to images with no transparency. If your Geo TIFF
is transparent, don’t click on Is a photograph as
this will change the picture to a non-transparent
format.

Tip: You may create a Geo TIFF file from a

raster image with the Georeferencer plugin
available for QGIS.

Uploading vector data

(Shapefile)
You may upload vector data by opening the
Management of maps menu under Maps, and
choosing create a new shapefile. Maptionnaire
supports currently only vector data in the
shapefile form (.shp). Be sure to set your data to
the currently supported EPSG:4326 coordinate
system.

Shapefiles cannot have popups. If you have a

shapefile you want to have as a clickable overlay
with added information and questions, use
hand-drawn layers.

Learn also how to add hand-drawn layers on

question pages.

30
4.3. Coordinate systems

Coordinate systems for default base maps

The default maps provided
Maptionnaire are set in the EPSG:3587
coordinate system, which is the standard
projection among majority of online map
providers and web mapping applications.
Only the topographical Maastokartta base
map has a different national projection
by (EPSG: 3067) as it is limited to the land area
of Finland. If you wish to provide several
base map options for a questionnaire, pay
attention that they need to be set to the
same coordinate system. Maastokartta
base map, for instance, can’t be combined
with other default base maps.

Coordinate systems for in- and output data

For importing your own shapefiles, the able to use any coordinate system if you
only supported coordinate system is accompany the image with a World file.
EPSG:4326. Georeferenced raster images
(GeoTIFFs) are recommended to be While exporting your data, note that the
imported in the coordinate systems output coordinate system of spatial data
supported by Maptionnaire, but you’ll be gathered in Maptionnaire is EPSG:4326.

31
5. General settings of your questionnaire

5.1. Structuring the answering session

Define and structure how the respondents can see and interact with your questionnaire. You
can for instance set branching rules and define the visibility of other respondents’ map
responses. Explore these options under the General settings of the Questionnaire Editor.

32
Set branching rules
If you wish to customize the questionnaire new branching rule in the Set a new
based on the respondent’s answers, you branching rule menu under General
may set branching rules within the settings. Choose from the drop down
questionnaire. Branching means that there menus the triggering question, the
are questions or pages that are hidden triggering answer (you may choose
unless an answer to a multiple choice several) and the targeted page or question
question triggers them to show up. For element. Notice that multiple choice grids
example, a page ‘Questions for blue cannot be set as the target elements.
people’ could be set to show if and only if
the answer to question ‘What is your Remember that changes in the multiple
favorite color?’ is ‘blue’. choice question might break the
branching settings.
Setting branching requires multiple
choice questions that you can design on Do you want to see how it is done? Check
their individual question pages. Once you out a User Guide clip on setting up
have the triggering question and targeted branching rules.
pages or elements ready, you can set up a

33
Set a minimum zoom level for
map responses
If it is important to you to get precise and
carefully set responses on the base map, you
may force the respondents to zoom closer by
setting a minimum zoom level for map
responses. Set the minimum zoom level under
the General settings in the Questionnaire Editor.
Respondents are supposed to place their
answers on a smaller scale as the number of the
chosen zoom level grows. Leave the default ‘0’
in for no limit in the minimum zoom level.

Information on the chosen zoom level and base

map are saved along every drawbutton in the
data.

Allow interrupted answering sessions

Tick the Maintain respondent session box
under the General settings of the
Questionnaire Editor and Maptionnaire
will remember the respondent's browser.
Re-opening the questionnaire on the same
device and the same browser will fill in the
previous answers, which will let the
respondents continue interrupted sessions
and prevent answering multiple times.

Hide respondent’s previous drawings

You may choose to hide the respondent’s
previous drawings and markings from the
base map while the respondent is adding
new responses onto the map. Choose this
option if you wish every answer to be
marked on an empty canvas.
Learn also how to enable respondents to
upload pictures.

34
Allow sharing in social media
If you wish to spread the word about your
questionnaire in social media, you may
allow your respondents to share an
invitation to the questionnaire on their
Facebook and Twitter pages. Enable
sharing by ticking the show social media
Show other’s responses on the base map
You may decide whether your respondents
are allowed to see answers from other
respondents on their base map.
Choose show map responses by others
under the Questionnaire Editor’s general
35
share buttons box under the general
settings header of the Questionnaire
Editor. The buttons are shown on the
questionnaire’s final page and redirect the
respondents to their social media pages.
settings header if you wish the responses
to be visible throughout the questionnaire,
and show map responses by others only
on last page if you want the responses to
be visible only when the questionnaire has
been finished.
Allow commenting on other’s map responses
Do you wish your respondents to ‘Enable commenting of map responses’
exchange views within your questionnaire? box under General settings.
Allow commenting on other respondents’
previous map responses by ticking the Watch how commenting works in this User
Guide clip.

Redirect after leaving the questionnaire

Define where the respondent will be change the address under the General
directed after clicking the “Done” button settings in Redirect URL at the end. Make
on the questionnaires final page. You can sure to start the address with http://.

Responsiveness of Maptionnaire questionnaires

The user interface of Maptionnaire You’ll find the width of the respondent’s
questionnaires is compatible to all mobile screen saved as part of your
devices, such as smart phones and tablets. questionnaire data.

36
5.2. Styling your questionnaire

You will find several possibilities to personalize the style of your questionnaire under the
General settings and Style settings headings in the Questionnaire Editor.

Change the layout

You can choose between two layout options for
the questionnaire view. The default layout align
center, normal width presents the questionnaire
in the middle of the screen with the base map in
the background. Layout align left, narrow width
places the questionnaire box to the side and
allows for more simultaneous use of the box and
the base map.

Change in the layout is only visible on larger

screens and does not affect mobile devices.
Change the layout in the Questionnaire layout
drop down menu under General settings.

Add your own picture on the

front page
Do you wish to further customize your
questionnaire’s front page? You may add any
picture that has been uploaded to Maptionnaire
by choosing it in the drop down menu Image at
the top of the front page. Choose Image at the
bottom of the front page if you wish to position
your picture lower or add another picture.

37
Show page numbering
Choose show page numbering under the
general settings and allow the respondents to
better follow the progress within the
questionnaire. Page numbering will be shown
prior to the question page titles and informs the
respondents on the number of the current page
and the total amount of question pages.

Change the color scheme and

font size
You can change the coloring of the front page
title, page names, questions, headings and the
‘next page’ and ‘previous page’ buttons under
Style settings in the Questionnaire Editor.
Remember that you can also change the color
and style of individual question elements.

Define also the questionnaire’s font size – the

options vary from 80 to 100 percent of the
default size.

Hide the front page

You can hide the front page by ticking the hide
front page box under the general settings. If you
wish to simplify the front page by removing the
questionnaires title, tick the hide title on the
front page box.

38
6. Publishing your questionnaire

Distribute your questionnaire

The best way to share your questionnaire
is to distribute its public URL address. You
may do this for example by e-mail, in social
media or on your organization’s web page.
You’ll find the public address underneath
the General settings in the Questionnaire
Editor. The address is by definition in the
form https://maptionnaire.com/1234/,
where the last numbers are the unique
identifier of your questionnaire and the
letters the code of the default language.

Tip: In order to modify the URL address of your questionnaire, try external services such
as tinyurl.com.

Define the answering period

Questionnaires are often open for a certain
period of time. If you wish, you can inform
your respondents on the opening and
closing dates of the questionnaire by
defining them in the start date and end
date drop down menus in the General
settings of the Questionnaire Editor.
Defining these dates is optional, and they
do not prevent filling the questionnaire on
earlier or later dates. Outside of the given
answering period the respondents are
informed on the front page that the
questionnaire is currently not active.

Tip: Take into account that in some countries collecting a register of personal data
requires a notification to the local authorities. Check with your local administration if
such measures need to be taken.

39
Set up a password
You may restrict the accessibility of your password. You may distribute the
questionnaire by setting up a password. password for instance with private e-mail
Choose the Questionnaire passwords invitations for your respondents. Contact
menu under the general settings, and Maptionnaire personally if you wish to set
define a password of your choosing in the up a questionnaire with designated
field dedicated to the questionnaire passwords for individual respondents.

Saving your questionnaire and the questionnaire answers

All the changes you apply to your
questionnaire in the Questionnaire Editor Similarly, the questionnaire responses will
will be immediately saved in Maptionnaire be saved as they are filled in – even if the
and you don’t need to save them respondent has not finished the entire
separately. Only adding new translation questionnaire.
texts and changing map location and
zoom level require manual saving.

40
7. Data Analysis Tool

When you wish to examine and analyze as individual analysis sessions will not be
spatial data collected through your saved. Remember that you can also share
questionnaires, use Maptionnaire’s Data the Analysis Tool outside of your
Analysis Tool. Open the tool from the organization.
Editor Main View – choose Analyze from
the Response data menu of the Do you want to see how it is done? Check
questionnaire you wish to work with. out a User Guide clip showing how to use
the Data Analysis Tool.
Do not close the Data Analysis Tool
window while you are analyzing your data

41
7.1. Browse and filter data

Show map responses

When you open the Data Analyst Tool, you’ll
notice that all the questions joined to
drawbutton elements in your questionnaire are
listed in the sidebar. You can choose which map
responses are shown in the Data Analysis Tool
by selecting one or more of these features. The
responses will be shown on the Tool’s map
according to the type of drawbutton they
represent, i.e. in points, lines or polygons.

Click individual responses on the map, and you’ll

see all of the respondent’s answers.

Filter map responses based on

their popup questions
If you have attached popup questions to the
drawbuttons, you’ll be able to filter the answers
based on the respondents’ answers on these
questions. Set a new filter from the filter button
( ) next to each question. You’ll see the filter
appear underneath the question accompanied
with the number of included map responses.

You can filter the map responses by several

filters simultaneously – choose the operator OR
if you want to show the responses matching any
of the filters, or AND if you want to show the
ones matching all of them.

42
Browse popup responses

You can also see all the answers to the popup

questions by selecting the Browse popup
responses box on the bottom of the side bar.

Tick also the accompanying Only open

questions box if you wish to see only open
ended questions Move the mouse cursor over
an answer in the list and you will see the
respective marker enlarged on the map.

Filter map responses based on

answers to other questions
You can set filters based on other questions in
the questionnaire in the same way as with the
popup questions. The main difference is that
these filters apply to all the map responses
currently shown on the map.

Create a new filter by choosing a question and

the filtering answer from the Other filters
button. Once set, you’ll see a list of your filters
appear underneath it.

As with the filters for individual questions, you

can filter the map responses by several filters
simultaneously with the OR and AND operators.

43
Show only map responses commented by others
You can also choose to show only map have been commented by other
responses that have gathered comments respondents filter from the Other filters
by other respondents. Do this by drop down list.
selecting the Show only answers that

Analyze pictures uploaded by the respondents

The Data Analysis Tool is the best place to map responses on the map and you’ll see
view and manage the pictures uploaded the pictures accompanied with the rest of
by your respondents. Click the individual the respondent’s questionnaire answers.

44
7.2. Visualize your data

Decide how your data will be shown from the dropdown list with Separate elements as the
default option. Experiment with different visualizing options and learn to know your data.

Style separate elements

Choose the Separate elements setting and
you’ll be able to see all the map responses
individually. You’ll be always able to return
to this default view.
Besides changing the color of the map
elements, you can change the point radius
for place markers and the line width for
routes and areas. Style your map elements
based on your scale and on what you wish
to communicate with your map. Which
elements do you wish to pop out?
Discover also how adjusting the opacity of
the map elements helps to highlight the
most marked areas, routes and places on
your map.

45
Heatmap
Choose the Heatmap option if you want to Settings
observe the hot spots of your map Experiment with the settings of the
response data. This option is only available Heatmap visualization. Increase the
for data in point form – experiment with intensity of the map when you want to
the opacity setting for similar show also smaller hot spots and decrease
visualizations with line and polygon it when you wish to draw focus on the
responses. larger ones. Blurring reduces the visibility
of the forms of individual points and
The Heatmap visualization follows the increases the merging points. The radius
mechanism of spatial interpolation, where switch determines the reach of individual
the values of unknown points are data points.
estimated on the basis of values of known
points.

46
Density squares
The Density squares option forms a grid best options usually vary depending on
over your base map in the grid size of your your scale and the total amount of your
choosing. The grid squares work as areas data points. The smallest available grid size
units in a choropleth map and get their depends on your zoom level.
value from the number of data points
within them. Grid squares containing no If you want to remove grid squares with
point data won’t be shown in the only few data points in them, change the
visualization. Like the Heatmap required minimum number of answers per
visualization, the Density squares square.
visualization also requires data in point
form. Hover your cursor on top of the grid
squares and you can see how many
Settings answers they contain exactly. You’ll find
You can produce diverse visualizations by the legend underneath the color settings.
changing the grid size you operate in. The

47
8. Managing and exporting data

8.1. Manage your data

Manage the data of an individual questionnaire by choosing Manage from the Response
data dropdown lists in the Editor Main View.

Data management view

In the data management view you’ll be of the answering period. Here you can
able to see all the answers submitted delete all the entries - you might need to
through your questionnaire. You can go do this if you wish to remove test answers
check on your data anytime, in or outside from your questionnaire data.

48
8.2. Export your data
You’ll discover all the options for exporting your data by choosing Download from the
Response data dropdown lists in the Editor Main View.
Export to XLSX (Microsoft Excel)
We strongly recommend you to export
your data in XLSX form. It does not have
any restriction for long answers or longer
column names, which makes analyzing
your data a lot easier than in shapefile or
TAB form. You can choose between two
export templates depending on how you
Export to shapefile (QGIS and ESRI products)
You can choose to export your data also in
shapefile form, but for usability reasons we
recommend this only as the last option if
you need to import your data to a software
unable to read CSV. Shapefiles do not
generally support long text answers or
naming attribute columns with questions.
If you need to use this export form, the
map responses will be exported as
shapefiles (.shp) in point, polygon and line
form. You’ll find the answers joined to the
49
are planning to analyze your data (default
/ one sheet per drawbutton).
Exported in XLSX, the geographical data of
the map responses is provided in
coordinate form (EPSG:4326) and is saved
in the column titled wkt (well known text).
map responses (comments, follow-up
questions) in the attribute data.
As the length of the columns’ names are
restricted to 10 characters in shapefile
format, Maptionnaire positions all the
questions and answers in separate
columns. If you have long comments
joined to your map responses, pay
attention that the attribute data has the
maximum length of 255 characters. The
spatial data is exported in EPSG:4326
coordinate reference system.
Export to TAB (MapInfo)
Exporting your data to TAB format is only recommended as a the last option
(supported for example by MapInfo) to solve compatibility issues. The spatial
follows the same principles and data is exported in EPSG:4326 coordinate
restrictions as exporting to shapefile, and reference system.

Export answers disconnected from the main data

Choose Answers disconnected from the such as e-mail addresses or other personal
main response data when you wish to data. Save the exported data and open in
export answers collected separately XLSX (Excel) form.
from the bulk of your questionnaire data,

Tip: The quickest way to export your data visualizations made in the Data Analysis Tool
is to use screen capture – try the Windows Snipping Tool press Print Screen (for Macs
press Command + Shift + 4).

50
9. Organizational management
If not otherwise defined, manage the settings of your organization from the Organization
menu in the Editor Main View. Make sure to name your organization in the Organization
settings page.

Organizational structure
At the simplest level, an organization is
formed by a single user managing all
materials and data in Maptionnaire. As it
is often useful to share and co-operate on
questionnaire design, adding members to
your organization is made easy in
Maptionnaire. Every organization has one
super user, who is by default the user who
has named the organization and has the
right to add new members to the
organization.

Add new members to your organization

You can add new members to your firstname.lastname). The user will receive a
Maptionnaire organization on the confirmation e-mail for activating the
Organization page by choosing Members account. Remember that only the super
of the organization. New members will user of the organization is able to add new
have the right to see and analyze the members.
questionnaires created by your
organization, and if authorized, also the You can deactivate user rights to your
possibility to edit and manage them. Fill in organization similarly from the Members
the new member’s name, e-mail and of the organization page.
account password (username as

Set a default location for your questionnaires

You’ll be able to set a default location for will be the default starting point for any
your questionnaires on the Organization questionnaires created by your
settings page. Once located, this map view organization.

51
Change the ownership of a questionnaire
Although the questionnaires of an
organization are visible to all the members
of the organization, only the owners of the
questionnaires are able to edit or delete
them. The owner of a questionnaire can be
changed in the Questionnaire Editor’s
Sharing translation and data analysis rights
You can outsource the translation of your
question pages and the data analysis by
sharing links to these pages. Share the
translations page by providing a link to the
page and the password as shown here. In
order to share the user rights of the Data
52
General settings by choosing any other
member of the organization from a
dropdown list. Remember that only the
current owner of the questionnaire is able
to change its ownership.
Analysis Tool open Questionnaire
passwords in the Questionnaire Editor
and set a password for the Analysis Tool.
After the password has been defined, a link
for the password-protected view of your
data will appear.
Change the language of your
user interface
Change the language you use Maptionnaire in
with the Change language button on the Editor
Main View.

Note that changing the language does not

affect the individual language settings of your
questionnaires.

Upload maps and images for

the use of your organization
Upload materials to Maptionnaire to be
available for all questionnaires created by your
organization. You may do this on the Editor
Main View under the heading Support Material.
Choose whether you wish to upload images or
maps (raster or vector form).

Choosing maps will take you to the

Management of maps menu.

If you want to upload images, pick create new

and choose the image you wish to upload.
Remember that large images may affect the
speed the questionnaire opens in the
respondents’ devices.

Learn more on the ways you can use your own

images in this User Guide clip.

53
54