In the Main Map View tap the Settings button on the top toolbar to access the configuration settings.  The various settings are explained below.

About Bit Map

Tap this item to view general information about Bit Map, including links to related web pages.


Display

Disable Sleep in Map View

Turn this switch on to prevent the device from sleeping while the map view is visible.

Bearing/Distance in Feature/Search Details

Turn this switch on the include the bearing from the current location and the distance from the current location in feature details.  This will appear in Search Result details as well as in feature details when displaying all features in a feature set (eg, for an offline vector layer in the Data Store Directory).

Display Coordinates as MGRS

Instead of displaying (X, Y) coordinates, the MGRS grid reference will be displayed.

Enter Coordinates as MGRS

Instead of entering locations as X and Y (or longitude and latitude) coordinates locations canl be entered as MGRS grid references (eg, when creating a Waypoint, a Point Feature or a Line/Polygon Feature vertex) by known coordinates or grid reference).

Info Panel Title Text Size

The text size for all headings in all info panels (eg, current location info, tracking info).

Info Panel Data Text Size

The text size for all data in all info panels (eg, current location info, tracking info).

Disable Pinch-to-Rotate

Turn this switch on to prevent the map from being rotated while pinching to resize the map with two fingers.

Line Label Simplification Factor

For text labels of lines (ignored for labels of points and polygons).

A higher value results in line labels following a simpler geometry resulting in easier to read labels.

A lower value results in line labels following the line more accurately.

(The simplification factor or ‘tolerance’ used by the Douglas Peucker Algorithm to generate the simplified geometry.  It is also multiplied by the map resolution and Symbology Scale factor so that it adjusts dynamically as the map zoom and symbology are changed.)


Tracking

These settings affect tracking (automatic recording of locations to layers).

Spatial Reference System

The spatial reference system (SRS) is the coordinate system used for all coordinates that Bit Map records to Tracks and Waypoints.  This SRS is also used when adding other layer points.  Hundreds of different SRSs are supported.  The default is EPSG:4326 (WGS84 geographic) – the default used by most GNSS devices (eg GPS).

To change the tracking SRS:

  • Tap the SRS button (the SRS code text, eg, “EPSG:4326”)
    • The SRS selector will appear, including a list of supported SRSs with a search field at the top
  • Pan or use the search field to locate the desired SRS
  • Tap the desired SRS

NB:  Some SRSs are suitable only for particular areas, eg, UTM and national grid SRSs.  If using an SRS that is not suitable for the area in which locations are to be recorded, those locations may not be able to be displayed on the map, and in some cases may not be able to be recorded at all.  So be sure to use an SRS which is suitable for your area of interest.  If unsure, EPSG:4326 (WGS84 geographic) should work anywhere on Earth.

Required Accuracy

When recording tracks automatically, locations will only be recorded if the accuracy of the coordinates is within this threshold.  Set to zero to record all locations of any accuracy while tracking.

Detected Locations to Keep

Locations can be detected as often as once every second (approximately).  This can result in an enormous amount of data being collected, which can take up storage space as well as look crowded when displayed on a map.  It is often desirable to discard many of the detected locations and keep only a significant portion of them.  This option can be set to either:

  • All
    • Not recommended unless available second of travel is required to be recorded
  • Min Distance
    • Only record a location if the distance from the last recorded location is greater than or equal to a specified threshold distance
    • Specify the threshold distance in the ‘Minimum Metres’ field
  • Min Time
    • Only record a location if the time since the last recorded location is greater than or equal to a specified threshold time
    • Specify the threshold time in the ‘Minimum Minutes’ field

Outliers

When using either ‘Min Distance’ or ‘Min Time’ settings to discard locations that don’t meet the threshold distance/time requirements, it is possible that significant locations may be discarded.  In particular, if turning a sharp corner (or turning back entirely), the track may not capture any locations along that turn, it may appear to be cut-off on the map, and the overall distance of the feature will be reduced.

Use the ‘Outliers’ setting to capture the most significant ‘outlier’ location between each distance/time locations.  Outliers are classified by their distance from the direct line between the two distance/time locations.  If any of the outliers are more distant from this line than the ‘Outliers’ percentage setting relative to the distance between the two points themselves, then the location with the greatest outlier distance will be recorded.

A maximum of one outlier can be recorded between any pair of distance/time locations.

Set to zero to avoid recording any outliers.

Tracking Styles

This is the rendering style that track lines, track points and waypoints will displayed with when they are added to the map.

The tracking styles must be set to one of the styles in the Styles Library (see below), however styles can be added to the library, or existing styles can be modified.

There are five track feature style types for which the style can be configured:

  • Track Line Style
    • To display lines in the ‘Track Lines’ layer in the ‘Tracks’ data store (ie, the track lines automatically recorded during track recording)
  • Track Point Style
    • To display points in the ‘Track Points’ layer in the ‘Tracks’ data store (ie, the track points automatically recorded during track recording)
  • Alternative Track Line Style
    • To display lines in other layers that have the same schema as the track lines layer (eg, tracks that have been copied from the ‘Tracks’ data store to another data store)
  • Alternative Track Point Style
    • To display pointsin other layers that have the same schema as the track points layer (eg, tracks that have been copied from the ‘Tracks’ data store to another data store)
  • Waypoint Style
    • To display points in the ‘Waypoints’ layer in the ‘Tracks’ data store

To change one of the tracking styles:

  • Tap on the style name button below the track feature style type
  • Select the style from the Style Library selector that appears
  • Tap ‘Done’

Info Panels

Use the switches in this view to control which items of information appear in the two information panels:

General Information Panel

The General Information Panel appears at the top of the map view and can be toggled on/off using the ‘i’ button in the top toolbar.  The items that can be included and controlled in the ‘Info Panels’ settings are:

  • Current Coordinates
  • Current MGRS Grid Reference
  • Current Altitude
  • Current Speed
  • Waypoints Count
  • Distance/Bearing to Last Waypoint
  • Distance/Bearing from Last Waypoint to Previous Waypoint

Tracking Information Panel

The Tracking Information Panel appears at the bottom of the map view automatically when tracking starts, and can be dismissed with the ‘x’ ‘button at its top-right corner.  The items that can be included and controlled in the ‘Info Panels’ settings are:

  • Track Distance
  • Track Time Interval
  • Track Speed – Last
  • Track Speed – Average
  • Track Speed – Top
  • Track Pace
  • Track Points

Units

Use these options to configure how values are displayed:

  • Geodetic Coordinates
    • ie, longitude and latitude values
    • note that this does not affect display of coordinates for projected coordinate systems (such as UTM) or for MGRS grid references
  • Speed
  • Distance
  • Altitude

Disable Sleep In Map View

Turn this switch on to disable the sleep idle timer while the Map View is displayed.  This will prevent the device from entering sleep mode while the map is being viewed.

Note that the device will use considerably more power and drain the battery substantially quicker if it does not go into sleep mode.  Therefore it is recommended to use this setting only while attached to a power source, if possible.


Styles Library

The Styles Library view displays all of the currently configured rendering styles that are available for drawing vector layers on the map.  The styles can be modified, and new styles can be added.

Edit a Style

  • Tap on a Style’s style view (example rendering) to display the Style Editor for that style

For further information about editing a style, refer to the Style Editor page.

Create a New Style

  • Tap ‘+’ (bottom toolbar)
    • The Style Editor will appear
  • Enter a name for the new style

For further information about editing a style, refer to the Style Editor page.

Add Style Symbol Image

In the Style Editor view, a point symbol can be selected for a style.  This symbol will be displayed on the map for each point in the layer.  Some simple points are included with Bit Map, such as circle, square, triangle and start (both filled and outlined).  However, it is possible to use any image as a symbol in a style.

It is highly recommended to use emoji symbols for custom symbol images if a suitable emoji symbol can be found.  However, if there is no suitable emoji, then any image can be used.  However, other images must first be imported into the Style Library’s images pool.

To add an image to the Style Library’s images pool:

  • Copy an image from elsewhere
    • Find an image, eg, from the internet or in the ‘Files’ app, and copy it to the pasteboard using the browser or the ‘Files’ app
  • Switch back to Bit Map, and navigate to the Styles Library in Settings
  • Tap the images button (bottom toolbar)

  • In the Style Images view, tap the paste button (bottom toolbar)

The image will now be available to be assigned to a style using the Style Editor. For further information about editing a style, refer to the Style Editor page.

Share or Copy Style(s)

The entire Style Library or a single style can be shared with another Bit Map user:

  • Tap the share/action button (bottom toolbar) in the Style Library to share the entire library or in a Style Editor to share a single style

  • Select the method to send the style to another user
    • or, select ‘Copy’ if you wish to duplicate a single style

To paste a copied style (eg, to duplicate the style):

  • Tap the paste button (bottom toolbar):

Reset Styles

To delete all styles in the styles library and replace them with the default set of styles bundled with the app:

  • Tap ‘Reset’ (bottom toolbar)

Spoken Feedback

Use these settings to control when Bit Map will use artificial speech to notify you about events.  This view also includes some information about how to change the voice used for spoken feedback.

Toggle speech for each of the event types listed by turning its switch on/off.


Data Formats

The default format for all layers is GeoPackage (a geospatial format based on SQLite).  However, several other formats can be used for recording geospatial data and many more formats can be used for read-only data sources.

In this view, there are two categories of writable data sources for which the format can be changed:

New Data Store Data Format

Any time a new (local/offline) data source is created in Bit Map’s Layers Library, it will be created in this format.  This includes the automatically created ‘Tracks’ data source for recording tracks and waypoints, as well as manually created data sources.

NB:  Changing this setting will not affect current data stores, and will not change the current Tracking data store (nor the current tracking or waypoint layers).  The data store will need to be re-created after this setting has changed if a different format is required.

Export Data Format

When data sources are shared and sent to other users, this setting determines the format in which the data will be shared.

If the above two settings are the same, then sharing whole data sources will be quicker, because the data source can be shared directly without having to copy all the data first.  However, it is sometimes desirable to have different settings, eg, if the recipient is unable to use the data format that is preferred for outputting data in Bit Map.

To change either of the above two data format settings:

  • Tap on the format name
  • Select from the list of formats that are supported for the setting
  • Tap ‘Done’

To view all data formats that Bit Map is able to use vector layers:

  • Tap ‘Show All Available Vector Data Formats’

Cache

For online tiled raster layers such as WMTS, TMS, XYZ or OSM, the images are assembled from many small image tiles retrieved across the network.  In order to speed up displaying parts of images that have already been viewed, and to save network bandwidth, these image tiles are cached and re-used if the required tiles are already in the cache.

Once the cache exceeds its configured maximum capacity, the tiles which have not been used for the longest period of time are deleted from the cache.

Note that Tile Grid layers in local data stores are not included in the cache, even if they were originally downloaded from online raster layers.

To change the maximum cache size:

  • Enter the new size (in megabytes) in the ‘Cache Maximum Size (MB)’ field

Some online layers may change from time to time.  If it become necessary to be sure that the latest version of the online data is being viewed and not the data from the cache, the cache can be emptied by tapping the ‘Purge Cache Now’ button.


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 ‘/BitMapWebMap/’.  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/BitMapWebApp/

(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 ‘BitMapWebMap’ 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 ‘BitMapWebMap’ 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/BitMapWebApp/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’

Diagnostics

This view is intended only for use when requested by support in order to diagnose an issue raised in a support request.

In response to a support request, it may be necessary to quote the version and build number that are displayed on this page.

Support may also ask to be sent run logs, using the ‘Send Diagnostics Data’ button.  This will create a log file and attach it to an email ready to be sent.


Pro

The ‘Pro’ settings provide for the purchase of the ‘Pro’ variant of Bit Map.  The pro variant unlocks extra features and functionality.  For more information on Bit Map variants, see the Variants page.

Purchase Bit Map ‘Pro’

  • Tap the ‘Buy Pro Now’ button
  • Follow the App Store prompts

Restore Previous Purchase

If you have previous purchased ‘Pro’ on another device, or have subsequently uninstalled and re-installed the app, you can restore the purchase to the app.

  • Tap the ‘Restore’ button (bottom toolbar)

Lock/Unlock Settings

Settings can be locked so that users are prevented from altering settings and/or prevented from altering configuration of online map services in the Layers Library.  With these options enabled, a password is required to change settings.

This feature can be combined with ‘Share Settings’ feature (below) to assist an organisation to distribute required settings to all users and then use the Lock Settings to prevent the users from overriding those settings.

Set or Change Passcode

  • Tap the passcode button (bottom toolbar)

  • If a passcode is already set, enter it in the Old Passcode field
  • Enter the new passcode in the New Passcode field
  • Enter the new passcode again in the Confirm Passcode field
  • Tap ‘OK’

Enable/Disable Access to Lock/Unlock Settings

Enabling access to the lock settings on this view will only last until the view is dismissed.  Access will need to be re-enabled again next time the view is displayed.  The padlock symbol in the bottom toolbar indicates if the Lock/Unlock settings are currently accessible (unlocked padlock) or not (locked padlock).

Enable access to the Lock/Unlock Settings:

  • Tap the locked button (bottom toolbar)

  • Enter the passcode
  • Tap ‘OK’

Alternatively, changing the passcode (see above) or using any of the Lock/Unlock switches will automatically request the current passcode and then enable access to all the Lock/Unlock switches if successful.

Disable access to the Lock/Unlock Settings:

  • Tap the unlocked button (bottom toolbar)

Lock/Unlock General Settings

Turning on this option means that the passcode will be required to access settings views (except for the Lock/Unlock Settings and Diagnostics Settings).

  • Tap the ‘Lock Settings’ switch
    • If access to the Lock/Unlock settings is not currently enabled, enter the passcode to enable access when prompted

Lock/Unlock Online Map Services

Turning on this options means that the passcode will be required to add, modify or delete online map services in the Layers Library.

  • Tap the ‘Lock Online Map Services’ switch
    • If access to the Lock/Unlock settings is not currently enabled, enter the passcode to enable access when prompted

Lock/Unlock Offline Datastores

Turning on this options means that the passcode will be required to add, modify or delete offline datastores in the Layers Library.

NB:  It does not prevent management of offline datastores by other means.

  • Tap the ‘Lock Offline Datastores’ switch
    • If access to the Lock/Unlock settings is not currently enabled, enter the passcode to enable access when prompted

Share Settings with Other Users or Devices

For organisations where the same settings should be used for all users (including online map services in the Layers Library), it is possible to configure the settings on one device and then share them from that device, and then import them to other devices.

This feature can also be combined with ‘Lock/Unlock Settings’ feature (above) to prevent users from changing settings and/or prevent users from changing configuration of online map services in the Layers Library.

WARNING:  If shared settings include a passcode, it will not be possible to change the Lock/Unlock Settings passcode after the settings have been imported unless the imported passcode is known.  If the settings also include Lock settings, then it may not be possible to change any settings at all after the import is complete, unless the passcode is known.  (If this occurs, the remedy is to back up all offline data stores – eg, to iCloud – delete the app, and then re-install the app.)

Share Master Settings

On the master device from which settings should be shared

  • Tap the share/action button (bottom toolbar) in the Settings view

  • In the share-sheet that appears, select the method to distribute a file of settings to other users/devices

Settings can be shared by saving the file to somewhere that other devices can access it (eg, save as a file to iCloud) or to nearby devices by AirDrop, etc.

Import Shared Settings

On the device(s) that is/are to be configured the same as the master device, make sure that the master settings file is available (eg, in the ‘iCloud’ section in the ‘Files’ app, or share by AirDrop on the master device).

  • Choose to share the settings with Bit Map
    • How this is done will depend on where the settings are being shared from, eg:
      • AirDrop:  Share the settings from the master device (see above) and choose the AirDrop option
      • File:  Select the file and choose the share/action button and choose ‘Bit Map’ as the option to share with
  • In Bit Map, tap ‘Import’ when prompted to confirm import of the settings
    • If the settings include a passcode option, note the warning above then tap ‘Import’ again to confirm import of the passcode protected settings