JMap Survey is a mobile application that belongs to the family of JMap applications (JMap Pro, JMap NG and JMap Survey). It is deployed on smartphones as well as iOS and Android tablets.

JMap Survey can be used to display the vector and raster data of a JMap project, to perform queries, and to edit vector data, either in offline or online mode. These features make it an ideal application for entering data on the field when performing work such as tree inventories, building and infrastructure inspections, or tracking the progress of subcontracted projects.

Your JMap administrator will provide you with a username and password to log into JMap Survey.

In the login page:

1. Enter your Username.

2. Enter your Password. Passwords are case sensitive. On an Android device, your username and password can be saved.

3. Select the project to which you want to connect. If you have configured connections to several projects, touch the list to open the Select Server screen and display the list of projects.

4. Select the project you wish to open.

5. Touch Login to open the project. The map displays.

The graphical interface is streamlined and straightforward, all the space is dedicated to map-based data.

Account

This section includes global functions to work with your project in JMap Survey:

• Work in Offline Mode

• Synchronize Data with JMap Server

• Photo Size

• Location

• Log Files (available only on iOS devices)

This section also displays the JMap Survey and JMap Server versions.

Photo Size

You can determine the size of photos that will be embedded in forms or subforms that contain object attributes:

1. In the Account / Photo Size section, touch the arrow to display the possible values:

   Original: keeps the original size of the photo

   Small: 1024 * 1024 pixels

   Medium: 2048 * 2048 pixels

   High: 3000 * 3000 pixels

   Dimensions are approximate as photos may be rectangular. When you select the size, the number of pixels is assigned to one of the dimensions of the photo and the other dimension is adjusted to maintain the ratio between both dimensions.

2. Check the size of your choice. The screen automatically returns to the Account section screen.

Location

This section allows you to choose the accessory that will provide geolocation data. JMap Survey allows you to use geolocation devices other than your phone or tablet.

To select the geolocation data source:

1. In the Account / Source section, touch Select to select the accessory.

2. Slide the switch to activate the display of metadata (these depend on the selected source).

3. Slide the switch to enter a minimal precision (in mm) of the measurements.

Log Files

This section allows you to enable saving of log files. These files detail the transactions that occur during a JMap Survey session and thus help identify errors and problems that may arise.

The files are stored in your device and you can view and share them.

1. In the Log Files section, slide the switch to enable saving the log file of your JMap Survey session.

2. Touch Share Logs to access your iOS device's sharing options: share files, save them, or copy them.

The data contained in the project is organized into layers. You can select the layers you wish to use as a base map and the layers you wish to display or hide. All of the selected layers will form the map displayed in the application.

JMap Survey displays the layers with their style. If the layer contains thematics, JMap Survey will display the thematic that is selected to be displayed by default when the project opens. The legend of the thematic is not displayed and you cannot change the thematic displayed.

In order to select the layers to be displayed:

1. Touch to open the Layers menu.
2. Select the base map. You can only display one base map at a time.

3. Use the switches to select the layers you wish to display or hide.

4. The arrow indicates a group that contains several layers. Touch the arrow to display the layers and/or subgroups that make up the group. You must enable the buttons of each group in which the layer is found in order to display the layer. If you hide the group, none of the layers it contains will be displayed.

   Certain layers can be configured to be displayed within a specific scale range. They may not appear at the current map scale. You can enlarge the map (zoom in) to display them.

5. Touch or touch the map to close the Layers menu.

Searches allow you to select elements in a layer based on their attribute values. You can then examine the attributes of the elements thus selected.

To perform a search:

1. Touch to access the Search screen. Note that the icon will only be visible if the JMap administrator has configured at least one query.

2. Select the search you want to perform. The search form appears.

3. Select and/or enter your search terms in the form.

4. Touch Search to run the query. Objects whose attribute values match the values you entered in the form appear in the map.

5. Touch the item you are interested in to display its tooltip.

6. Using the arrows, navigate the tooltips of the objects selected by the search.

7. Touch to deselect the objects and return to the map.

Installing JMap Survey

To install JMap Survey on your Android device:

Download JMap Survey from the Google Play Store by touching Install: .

1. Touch the icon to open JMap Survey. The application displays in English or in French, depending on the language selected in your mobile device.

2. Authorize geolocation and access to the photos, camera, and files on your device. Your answer will be remembered.

Connecting to a JMap Project

To configure the initial connection to a project:

1. In the login page, touch Add Server. The Add New window automatically opens, allowing you to create a connection to a project.

2. Enter the main URL of the JMap server and the name of the JMap project to which you want to connect. The project name and URL are not case sensitive. This information will be provided by your JMap administrator.

   An example of a project name: Montreal

   An example of a URL: (with port number if not 80, e.g. 8080)

3. Touch Create. Access to the project is configured, and the name of the project is now displayed in the login page.

4. Enter your login information, Username and Password.

5. Touch Login. The screen displays the map centered in your device's location. The section offers details for customizing the displayed map.

In the JMap Survey home screen, you can connect to other projects from the Select Server screen. To do so:

1. In the login page, touch the name of the project to access the Select Server screen.

Modifying Connections to JMap Projects

You can modify or delete a project's connection information from the Select Server screen:

1. Touch the name of the project on the JMap Survey login page to access the Select Server screen.

3. Select the project of your choice.
6. Select several projects. Only the Delete function is available.

Working in offline mode is particularly useful when you want to create and edit objects in the field and no network connection is available. To work in offline mode, you must follow these steps:

1. Download the map for a given area.

2. Enable offline mode in JMap Survey (or Airplane mode on your device).

3. Enter data in the field.

4. When a network connection becomes available, disable offline mode (or Airplane mode on your device) to synchronize the data with JMap Server.

Downloading the map

When you want to use JMap Survey in offline mode, the first step is to download the map on your mobile device so it is available as a spatial reference. To do so:

1. Touch to open the Layers menu.

2. Select the base map to display using the steps detailed in section.

3. Touch Download the map. A frame displays, allowing you to define the perimeter of the map.

4. Define the area and scale of the map you wish to download by dragging the map and using the zoom function.

5. Touch Save to save all of the map's elements in the device's memory. The data of all the raster and vector layers will be saved for the selected area.

6. Touch Cancel to cancel this action. You are returned to the map.

Enabling offline mode

In order to enable offline mode, you must start by downloading the map. To enable offline mode:

2. Enable Offline Mode.
3. Touch OK to return to the map. The Offline Mode icon is displayed.

Creating or modifying objects in offline mode

Disabling offline mode

Once your data has been collected in the field, you must synchronize the data of your device with the data of the JMap server. To do so, follow these steps:

1. When a network connection becomes available, disable Offline Mode in the Account screen.

2. Touch OK to return to the map.

When you have the required permissions, you can modify the objects of a project's editable layers.

To modify an object, follow these steps:

1. Touch to display the project's layers.

2. Select the layer to modify in order to make sure it is visible on the map.

3. Touch the object to modify in order to display its mouseover bubble.

4. Touch to open the editing interface.

5. Select the type of modification you want to make: - Edit Geometry - Edit Info - Create or modify a subform - Delete the object.

The following sections describe each type of modification.

Editing geometry

1. Select Edit Geometry to modify the geometry and/or position of the object.

Editing a point geometry

You can modify the location of point objects:

1. Touch the map to indicate its new location; a marker will indicate the chosen location. You can also touch to bring the object to your current location.

2. Touch Save to save the change or Cancel to disregard it.

Editing lines and polygons geometries

You can modify the shape of linear or polygonal objects by adding, moving or deleting vertices.

The object's vertices are displayed with a number.

You can save each change after you make it or make multiple add and move vertex changes and save them together.

To add a vertex:

1. Touch the map where you want to create the vertex. The new vertex is displayed with its number and the shape that will adopt the object with the movement is displayed transparently on the map.

2. Touch Save to save the change, Cancel to leave it without effect, or continue making changes. When the changes are saved, the object is displayed with its new shape.

To move a vertex:

1. Touch the vertex and drag it to the new place. The shape that the object will adopt with the movement is displayed transparently on the map.

2. Touch Save to save the change, Cancel to leave it without effect, or continue making changes. When the changes are saved, the object is displayed with its new shape.

To delete a vertex:

1. Touch the vertex to select it. The Delete and Cancel buttons appear.

2. Touch Delete to delete the vertex. The shape that the object will adopt with the movement is displayed transparently on the map.

3. Touch Save. The change is saved and the object is displayed with its new shape.

Editing attribute information

You can modify the object attribute information:

1. Select Edit Info to modify the attribute information. The form opens, allowing you to modify the editable fields and subforms. You can use the voice function of your phone to orally indicate the value of the field. The text is transcribed automatically.

   Two examples of validation rules:

   a) If I select certain values in field A, field B becomes mandatory.

   b) I select a value in field A and the field B value is calculated automatically.

   You cannot save the form if the values you enter do not meet the validation rules.

2. To edit comments on a photo, tap it to view the photo with its comment.

3. Touch Edit to access the comment editing screen. You can write a comment of a maximum of 255 characters. You can use the voice function of your phone to indicate the comment orally. The text is transcribed automatically.

Editing subforms

If the object has subforms configured to, for example, log inspections over time, you can modify the information in the subforms directly, without going through the form (as in the previous case).

1. Shortcuts to the subforms will then be displayed in the editing interface. These shortcuts will allow you to directly access the subforms and fill them out. In the example below, an Inspection subform exists, and its shortcut is called Create Inspection. Touch Create Inspection to create a subform associated with the object's attributes form.
2. Touch Save to save the changes made in the form and subforms.

Deleting the object

1. Touch Delete to eliminate the object. If you have the required permission, the object will be eliminated.

Some layers have descriptive information associated with layer elements or objects. The information is displayed in tooltips. In addition, if the Documents extension is found on the JMap server and you have the required permissions, a button in the tooltip will allow you to access the documents associated with the object. You can open and view the documents directly on your mobile device.

To display the tooltips:

1. Touch a layer element whose tooltip you wish to display. The tooltip can contain descriptive data as well as hyperlinks to websites, photos or various documents.

2. Depending on the scale, when you display the tooltip of an object you touch, you can view the tooltips of other objects found nearby using the and arrows. In the figure above, the tooltip indicates that you can display the tooltip of a second camera located nearby. A marker on the map identifies the map object whose tooltip is displayed.

3. Touch the hyperlink to open the photo, document or website.

4. The figure shows the website opened from the Image link hyperlink found in the tooltip of cameras. The mobile device's share extensions and some other functions are available to share or refresh the information.

5. Touch to close the tooltip.

To access documents associated with an object:

1. Open the tooltip of the object whose associated documents you wish to access.

2. Touch the icon to access the Documents. If the icon is not displayed, but you know that the Documents extension is installed on the server and you have permission to access it, it means there are no documents associated with the object. If there are any documents, they will be displayed as thumbnails.

3. Touch a thumbnail to access a document. The corresponding application or web page (Google Drive, Word, Excel, etc.) will open to display the document. You can use the iOS or Android share extensions.
4. Touch OK to return to the tooltip.

5. Touch to close the tooltip.

Once your data has been collected in the field, you must synchronize the data of your device with that of the JMap Server:

1. If you are working offline, when a network connection becomes available, disable Offline Mode in the Account screen. The changes you have made will be automatically synchronized. Note: The project's layer data may have been updated or modified on the JMap server. By touching Refresh layers, JMap Survey will download all of the data once again to make sure it is up-to-date on your device. This option is not required to save the changes you made with JMap Survey, but you should use it from time to time.
2. Touch OK to return to the map.

Inspecting data awaiting synchronization

The data entered when creating or modifying objects with JMap Survey may contain errors that prevent their correct synchronization with JMap Server data.

Problems related to the configuration of the database that stores the data or to the input forms or even problems connecting to JMap Server can cause errors when sending data to JMap Server. Data that could not be successfully synchronized becomes items awaiting synchronization.

To use this function:

1. Pending Changes displays the number of items waiting to sync and two buttons: Inspect and Delete.
5. Touch Show. JMap Survey centers the map on the element, the element tooltip is displayed.

9. Touch OK to return to the map.

It is not necessary to log out of JMap Survey, unless you have fully completed your work or you must give your mobile device to a colleague.

When the application is in sleep mode or is deliberately closed, your session is not terminated, your data is maintained, and you can resume your work without any problem. JMap Survey may ask you to reenter your login info when you return to the application.

To log out of JMap Survey:

1. Touch to access the Account screen.

2. Touch Logout. Your session is closed and you are brought back to the JMap Survey login page.

JMap Survey allows you to create objects, whether you are working online or offline.

To create an object:

1. Touch to view the types of objects that are available. Icons with legends are displayed. The types of objects that are available depend on the editable layers in the project and on your editing permissions. JMap Survey displays the available object types for which you have editing permissions.

2. Select the type of object by touching its corresponding icon. The map displays to define the object's location.

3. If you are creating a point object, it will automatically be located at your current position. You can change the location of the object by touching the map; it will be placed on the point you touch. Touch to bring the point object back to your current position. If the object is polygonal or linear, touch the map to place each vertex of the polygon or line. Each vertex has a number. JMap Survey does not support self-intersecting polygons. In case you create a self-intersecting polygon, the Save button is not enabled.

4. Touch Save location to confirm the entry of your object, or touch Cancel to erase it. If you confirm the entry of the object, a form appears, inviting you to enter the object's attributes.

5. Enter the appropriate information in the form's fields. Some fields are required (you cannot save the form unless the field has a value) and others are optional; the latter are identified with the text Optional.

   Fields where you must select one or more values from a list will contain an arrow . Touch the arrow to display the available values and make your selection.

   Text fields indicate the maximum number of characters allowed for your text. The number changes as you enter your text, indicating the remaining characters available. You can use the voice function of your phone to orally indicate the value of the field. The text is transcribed automatically.

   Numeric fields indicate the minimum and maximum values authorized. If you try and enter text, it will not be inserted.

   Date fields display a calendar when you touch them. Some fields are affected by data validation rules. These rules are configured by the JMap administrator to ensure the quality of the data collected with the form.

   Two examples of validation rules:

   a) If I select certain values in field A, field B becomes mandatory.

   b) I select a value in field A and the field B value is calculated automatically.

   You cannot save the form if the values you enter do not meet the validation rules.
6. Touch to add a photo to the form. Three options are available: Take picture, use a photo from the Photo library or Cancel.

   Note: You can select the size of the photos in the Account / Photo Size section .

7. Select Take picture. JMap Survey will ask permission to use your device's camera. This authorization will only be asked once, and your answer will be remembered.

8. Take a picture and validate it, or take another picture. As soon as you take a picture, a screen opens, allowing you to enter a comment for the picture.

9. Enter your comment and touch Save to save your picture or X to cancel photo creation. You can use the voice function of your phone to orally indicate the comment. The text is transcribed automatically.

10. Select Photo library to access your photo library and select one or more photos. As soon as you select the photo, the screen to enter comments is displayed.

11. Enter your comment and touch Save to save the picture or X to cancel the photo creation. You can use the voice function of your phone to orally indicate the comment. The text is transcribed automatically.

12. Your form can contain subforms for entering data at different points in time or in different contexts. If relevant, touch the subforms field to access the subforms screen.

13. Touch to add a subform. The subform will contain fields whose types are similar to those in the form.

14. Enter the relevant information and photos.

15. Touch OK to save the subform. The subform will close. The Subforms field indicates the number of subforms associated with the form. The number represents the subforms created by all of the project's users.

16. Touch Save to save the form's data or Cancel to delete the data.

17. Touch to display the available forms for your type of object. Several forms can be available for each type of object.

Installing JMap Survey

To install JMap Survey on your iOS device:

1. Download JMap Survey from the App Store by touching Install: https://itunes.apple.com/ca/app/jmap-survey/id1440073003?l=fr&mt=8.

2. Touch the icon to open JMap Survey. The application displays in English or in French, depending on the language selected in your mobile device.

3. Enable geolocation on your device. Your answer will be remembered.

Connecting to a JMap Project

JMap Survey directly connects to JMap projects. To set up the initial connection to a project:

1. In the login page, touch Add Server. The Add New window automatically opens, allowing you to create a connection to a project.

   

2. Enter the name of the project and the main URL of the JMap server. The project name and URL are not case sensitive. This information will be provided by your JMap administrator.

   An example of a URL: https://jmap7.jmaponline.net (with port number if not 80, e.g. 8080)

   Examples of a project name: Montreal, Survey Demo

3. Touch Create. Access to the project is configured, and the name of the project is now displayed in the login page.

   

4. Enter your login information, Username and Password.

5. Touch Login. The screen displays the map centered in your device's location. The User Interface section offers details for customizing the displayed map.

In the JMap Survey home screen, you can connect to other projects from the Select Server screen. To do so:

1. In the login page, touch the name of the project to access the Select Server screen.

2. Touch Add Server to open the Add New window and configure access to a new project.

   

Modifying Connections to JMap Projects

You can modify or delete a project's connection information from the Select Server screen:

1. Touch the name of the project on the JMap Survey login page to access the Select Server screen.

2. Swipe left on a project to edit or delete it.

   

3. Touch Edit to open the Edit window, where you can edit the name of the project and/or server URL.

   

To delete the connection information of several projects at once:

1. In the Select Server screen, touch Edit.

2. Check the boxes of the projects you wish to delete.

   

3. Touch to delete the projects or touch Cancel to return to the Select Server screen.

4. Touch to return to the JMap Survey login page.