MobileMap: Basic Configuration and Base Map Download
Basic Configuration Overview
Basic configuration for data collection includes the following steps. Most of these steps require an internet connection. Before proceeding, make sure you are connected to WiFi and have a strong signal.
Get familiar with the ‘Actions Menu’
Sign into ArcGIS
Download base map
Select Feature Service
Initialize Feature Service
Import settings
Enter User-Specific Settings
Confirm download parameters
Download data (optional)
Once you complete these steps you should be ready to collect field data. If you run into any issues when completing these steps, please contact WSG software support at:
Support Portal: https://woodlandsg.atlassian.net/servicedesk/customer/portals
Support Phone:Â (720) 712-4334
1. Get familiar with the Actions Menu
The Actions Menu is used for many workflows in MobileMap. It is accessed using the Actions Menu icon, second from right in the top right corner of MobileMap.
When the Actions Menu opens, you will see a long list of Actions. The most common actions are at the top of the list and include larger buttons to make selecting them easier. These include ‘Sign in to ArcGIS’, ‘Upload Features’ and ‘Download’. In this initial setup we will use ‘Sign in to ArcGIS’, ‘Download Basemap’, ‘Select Feature Services’, 'Initialize Database' and optionally ‘Download’.
2. Sign In to ArcGIS
Signing into ArcGIS is a critical step for accessing secure data within MobileMap. It is needed when configuring MobileMap and whenever you are uploading or downloading data. It is also used when downloading base maps or getting driving directions.
Many users will sign into ArcGIS using their ArcGIS Online username and password. If your organization uses Portal, you will need to sign in using your ArcGIS Portal username and password. Initial setup for Portal users requires a few additional steps. If your organization uses Portal, please read the following page before proceeding MobileMap: Using Portal for ArcGIS
To begin, select ‘Sign in to ArcGIS’ from the Actions Menu
Enter your ArcGIS Username
Enter your ArcGIS Online Password
Tap 'Sign In'
You should receive a notice stating that you have successfully signed in to ArcGIS
If you receive an error here, please contact your organizations MobileMap point of contact
3. Download Base Map
MobileMap requires one or more base maps stored in Esri’s Tile Package (TPK) format. These may include aerial imagery, road information, topography, etc. If your device was pre-loaded with base map data you should already be seeing a map at this stage of the configuration. If you believe that your device does already have base map(s), but you are not seeing them, you may need to select the ‘map cache’ or project. To do this, open the ‘Select Map Cache’ dialog (4th button from the right in the upper right of MobileMap) and select your preferred map cache from the list. If your device did not come pre-configured with base map data, this section will cover the steps to download a suitable base map to get started using MobileMap.
In some organizations, base maps are created using a PC and ArcGIS Desktop then transferred to mobile devices for field use. This approach may be optimal for organizations that own or manage land and thus have consistent and large areas where they work. For mone information on creating base map TPKs using ArcGIS Desktop please see MobileMap: Base Map Creation for MobileMap.
In other organization, base maps are created directly within MobileMap. This approach is ideal in several scenarios:
Evaluating MobileMap - When assessing if MobileMap is right for your workflows, direct creation of base maps in MobileMap allows you to quickly download a base map and start testing navigation and data collection. This skips the step of ArcGIS Desktop to create a base map, even if you may chose to do so in production use of MobileMap.
No access to ArcGIS Desktop - For organizations that do not have access to ArcGIS Desktop, or where the users who do have access to ArcGIS Desktop are not available to support base map creation, the option to create base maps directly in MobileMap may be a good fit. It is very easy to do, but there are some limitations to be aware of. Base maps created in MobileMap use ArcGIS map services and have limitations on the size of the base maps that can be created. Size limitations are determine by both the extent and the resolution of the basemap, see details below for more information.
Unpredictable work areas - For organizations that don’t own or manage land, there may be limited advance notice of work areas. In these organizations, there is no real benefit of pre-creating large area base maps - simply use MobileMap to create the base maps for the areas you will work for the next day, week, month, etc. The key thing to remember in this scenario is that you will need a good WiFi connection to create a base map in MobileMap, and it may take a while (typically 5 minutes maximum).
Â
Follow the steps below to download a suitable base map for testing:
Make sure you signed in to ArcGIS as described in the steps above
Open the Actions Menu and select ‘Download Basemap’
Select the desired base map from the list of available Esri base maps
Pan and zoom to an area where you plan to begin using or testing MobileMap
Select the maximum zoom level for the map data
We recommend using the smallest area, lowest resolution map that is practical at this stage. This will reduce the download time.
Once the map extend and zoom level are selected, tap the Download icon to begin the download.
Android version
Android 10 and higher
For Android 10+ devices MobileMap will prompt you for the location to save the file. Select the ‘TPK’ subfolder within desired project folder (or the ‘default’ folder). It is also possible to override the default naming convention but be sure to retain the .tpk suffix
Note that some users of Tab Active 3 devices have reported that a recent update (November 2022) has resulted in files being downloaded with a .tpk.part extension. We are working to implement a workaround for this in MobileMap. If you find that TPKs do not load properly and contain the .tpk.part extension, simply rename the files by removing the .part at the end of the filename.
Android 9 and lower
For Android 9 and lower devices, MobileMap will save base maps to the Downloads folder of your internal storage using a default name based on the image source, resolution and date.
During the download process, you will see a notification with an estimated file size for the TPK file. We have found that files less than 10 MB can be reliably downloaded over most network connections. Files up to 50 MB will work on better network connections. We have seldom seen files greater than 100 MB download successfully. A good starting point is to download an area that is a few hundred acres at zoom level 16. If the initial download is well within the file sizes noted above, try zooming out to increase the map area or select the next higher zoom level (e.g. from L16 to L17) and download again.
Use the ‘X' button to close the Download Basemap’ dialog and return to MobileMap
If using an Android version lower than Android 10, launch your file manager app and copy the TPK file(s) from the Downloads folder on your internal storage to the TPK subfolder of your desired project folder in the MobileMap folder, which will typically be on your MicroSD Card
Once you have a downloaded base map TPK in the TPK subfolder of your desired project folder in the MobileMap folder you should be seeing this base map data in MobileMap. If not, use the 'Select map cache' (4th from right in the upper right corner of MobileMap), to select the map project where you copied/downloaded your base map TPK.
If you still are unable to see map data, contact your organization’s MobileMap point of contact or WSG’s support team at support@woodlandsg.atlassian.net.
4. Select the Feature Service
Actions > SELECT FEATURE SERVICE
Â
Tap the download arrow button to get a list of available Feature Services
If this is not your first time signing into ArcGIS you will see the refresh arrows
Select the feature service that was identified by your organization’s MobileMap point of contact or by WSG staff by tapping the checkbox to the right of the Feature Service name.
Note that it is possible to select more the feature services, but this is an uncommon scenario that will require additional support from your organization’s MobileMap point of contact
Tap save button to close
In version 4.4.0 or higher of MobileMap closing this dialog will automatically open the next step - initializing the Feature Service
5. Initialize Feature Service
Initializing the feature service is a critical step in which MobileMap downloads a snapshot of the data model so that all tables and attribute fields are available offline for data collection. It will delete ALL data on your tablet, so make sure that any data that were previously collected (if relevant) have been uploaded before continuing. Note that this step does NOT download data (e.g., points, that will happen in the final step listed on this page.
Actions > INITIALIZE DATABASE
If you receive a message stating that you need to Confirm Database Delete and you are installing a new version of MobileMap, then something is wrong. If you already initialized a feature service MobileMap will prompt you to type 'confirm' to continue
After initialization completes, you should see a message stating that the feature service description contains MobileMap settings
In version 4.4.0 or higher of MobileMap closing this dialog will automatically open the next step - Importing Settings
6. Import Settings
MobileMap is a highly configurable application, and many of the configurations are stored in the application settings. Application settings can be exported as a text file, or imported from a text file. The preferred approach, however, is to import the settings from the feature service. The steps below assume that the data manager has saved the most critical settings for your feature service directly to that feature service, so they can be imported during this configuration process.
Actions > IMPORT SETTINGS
Tap the ‘Feature service' radio button or ‘Settings File’ radio button depending on your organization’s preference
Verify that the Feature Service you are using is selected in the dropdown list and that several settings rows are displayed with their setting, value and a checkbox to 'overwrite' existing settings
Tap 'IMPORT' to import these settings
You should see a message stating that settings imported successfully
Tap 'X' to finish
If you import settings the MobileMap Settings will automatically open at this point
This is good time to fill in your Authentication Information and Observer Name or Initials (see details below)
Back arrow out of Settings
Actions > DONE (closes the Actions menu if it is still open)Â
Note that there may be times when it is helpful to restore the default MobileMap settings prior to importing settings. This can be useful when a user has edited settings or has imported settings from other Feature Services in the past. To restore default settings, simply tap the refresh (recycle) icon and confirm you want to restore the default settings. Once the defaults have been restored, you can go back and import the settings using the steps above to ensure all settings on your devices are either the default values or those that are stored on the Feature Service you will be using.
7. Enter User-Specific Settings
Open SettingsÂ
Tap on 'Authentication Settings' -Â Portal Users please see:Â MobileMap with Portal
Â
ArcGIS Username
Enter your ArcGIS Online username
ArcGIS Password
Enter your ArcGIS Online password
Tap back arrow to return to main settings page
Tap on 'Data Collection and Editing'
Observer Initials or Name
Enter your full name or initials (e.g., John Doe or jbd)
Â
8. Confirm Download Parameters (Optional)
MobileMap supports filters known as download parameters when downloading data. Download parameters are optional, but can be helpful when a user does not want to download all of the data stored in a feature service. Examples include scenarios where a user only works in a particular region, or where they should only download data that has been assigned to their company.
Only complete this step if you have been instructed to do so, or you are confident with the data model, completeness of the data, and have read the documentation found in he documentation https://woodlandsg.atlassian.net/wiki/spaces/MD/pages/952598533
Actions > EDIT DOWNLOAD PARAMETERS
For each relevant layer, enter in the query ‘where’ statement. Note that download parameters for timber cruise are typically applied to the Stands, Plots, Trees and Logs (where relevant). Examples include:
Company_ID='XYZ'
Work_Area='Nortwest'
Cruiser_ID='JJD'
Status='Cruised'
Typically metadata tables like Rules and Related_Domains are typically NOT filtered
Sometimes whole tables are removed from the download list. For example, while a user may collect data with Generic Points, Lines and Polygons, they may choose to uncheck these layers to prevent them being downloaded to their MobileMap device.
9. Download (Optional)
The download task downloads all new or modified data. On the first download, it will download all data in a feature service, or all features that meet the download parameters defined in the previous step. On future downloads, it will download only those data that meet the download parameters AND have been created or modified since the last download.
This step is listed as optional on this page because it is not necessary to download any data in order to collect new features. A typical workflow, however, includes downloading features such as stand boundaries and plot locations that will be used in the field for collected or editing attributes.
If downloading data for use in MobileMap, do the following
Ensure you are connected to WiFi and have a strong signal
Actions > DOWNLOAD
Wait for the download process to complete
If you get an error message stating that a token is required, please re-sign in to ArcGIS (Actions > 'Sign in to ArcGIS')
Verify the expected number of features that have been downloadedÂ
Next Step MobileMap: Field Navigation
Previous Step MobileMap: Installation and Licensing
Â