Settings – Web Map

Bit Map can sync Map Layers to a map on a compatible Web Map which anybody can view in a web browser.  These settings control how web map sync works, and provides a button to generate the files for a compatible web map (to be installed on a web server).

Once the settings below have been configured, a layer can be enabled for sync by following the instructions at:  Map Layers

Web Map Base URL

Enter the base URL to an installed and operationsl Bit Map Web Map.  Such a URL would normally (but not necessarily) end with ‘/map/’.  Do not include any query component in this URL (ie, do not include a ‘?’ or anything that may come after the ‘?’ in some web map URLs).  Eg:

http://server.domain.com/map/

(See below for instructions for installing a Bit Map Web Map.)

Web Map Sync Password

The password which is required to sync layers to the Web Map.

See below for instructions to change the password.

Sync Enabled

Enable/Disable sync globally for the app.  Layers that are configured for sync will not sync if this is turned off.

Sync Frequency

The number of minutes between each sync.  A layer that is configured to sync will sync if the following conditions are met:

  • The layer has changed
  • The number of minutes since the last attempted sync is greater than the Sync Frequency minutes

Suppress Sync Failure Warnings

Disable/Enable warnings when sync fails.  Failures can occur for various reasons, including:

  • Wrong Web Map password configured in settings
  • No network available
  • Poor network quality

If warnings are enabled (default) and sync fails, a warning button will appear at the top-right of the Map.  Tap the button to view the sync error message including information about why the sync failed.

Export Web Map Zip Archive

Tap this button to share (export/send) a .zip file that contains all the files necessary to install a Bit Map Web Map onto a web server.

Share Web Map

To share the Web Map for all the layers published from this device:

  • Tap the ‘Share’ button in the Web Map settings (bottom toolbar)

  • Follow the standard sharing prompts to share the Web Map using one of the available sharing methods

Web Map Actions (View, Delete Layer, Delete Device, Change Password)

To interact with the Web Map, including viewing the map, deleting layer(s), deleting all data sync’d from a particular device or changing the password:

  • Tap the Web Map Action button (bottom toolbar)

  • Tap the desired action from the pop up that appears

Each of these actions will redirect to the relevant web page in a web browser.

NB:  To view or share a web map that will only display one specific layer (excluding any other layers that would otherwise be included on the map), see the Layer Actions available in the Map Layers view.

Install a Bit Map Web Map

In order to install a Bit Map Web Map on a web server, you must have administrator access to the web server’s documents directory.

  • Tap the ‘Export Web Map Zip Archive’ button in the Web Map settings to generate and send a .zip archive containing all the files required to create a Bit map Web Map
    • Select the method to send the .zip file
  • Unzip the .zip file
  • Install the unzipped ‘map’ folder and its content onto the web server
    • Make sure that the ‘data’ subdirectory is writeable
  • Change the Web Map password (see below)

The base URL of this ‘map’ folder is the URL to enter into the ‘Web Map Base URL’ in the Bit Map’s ‘Web Map’ settings.

Change Web Map Sync Password

A password is required to sync layers to the Web Map (but not to view the web map – unless configured by the web server administrator).

To change the password:

  • Either:
    • Navigate in a web browser to the password change page at:  <base-URL>/changepass.php
      • where <base-URL> is the base URL to the Bit Map Web Map 
      • eg:  https://server.domain.com/map/changepass.php
    • Use the instructions for ‘Web Map Actions’ (above) to open the Change Password page in a browser without having to type in the URL
      • requires that the BaseURL for the installed Web Map is already entered into the Web Map settings
  • Enter the current password (the initial password for new installations is, ‘BitMap’)
  • Enter the new password in both of the new password fields
  • Tap ‘Submit’