Versions Compared

Version Old Version 4 New Version 5
Changes made by

Kerry Halligan

Kerry Halligan

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Copy TPK to a PC

  2. Rename file from *.tpk to *.zip then unzip the file

  3. Open the file \servicedescriptions\mapserver\mapserver.json in a text editor

  4. Search for all instances of “mapScale”, and change any non-zero mapScale values to 0

  5. Save mapserver.json

  6. Select all of the folders that were in the TPK

  7. Rezip all of the folders that were produced when unzipping the original file. The re-zip must be done without compression. This is the trickiest step, as the default windows zip tool cannot do this. You will need a zip utility like 7-zip that has the option to simply archive with no compression.

  8. Rename file back to *.tpk

  9. Copy TPK back to the appropriate folder in your MobileMap directory on your mobile device

Why Can’t I See Any Base Maps?

I used the Download Basemap tool and it seemed to work as expected - displayed a message that base map had been downloaded, but I don’t see my base map - just a blank screen. How can I get my base map working?

There are a number potential causes for this issue. Use the check list below to help resolve the issue:

  1. Verify that MobileMap licensed - MobileMap must be licensed to display base maps. If it is not licensed, or if the license has expired or is not valid, you should see a brief popup message when MobileMap starts up that indicates that the license was not found or is not valid. The best way to check, however, is to use the license tool (Actions > License Device). At the top of this tool you should see a message indicating the license status. If the license has expired simply re-submit to refresh your licenses. If you have never licensed your device, follow instructions here MobileMap: Installation and Licensing and hereMobileMap Licensing

  2. Verify that the data directory is correct - Base maps are stored in a data directory, typically on a MicroSD card, and MobileMap must have access to that directory. Use the Select Data Directory tool (Actions > Select Data Directory) to select the data directory. See instructions here MobileMap: Installation and Licensing. Note that the directory selected during this process should be the MobileMap root directory, and should not contain TPK or Shapefiles directly within it. The MobileMap root directory is typically named ‘MobileMap’ and should have a subfolder named ‘default’ and will likely have other folders like ‘Export’ and ‘Photos’.

  3. Verify that your MobileMap folder structure is correct. MobileMap uses project or map cache folders which can be named however you want, but we recommend avoiding spaces or special characters in folder names. Project folders are found in the MobileMap root directory. Each project folder will have subfolders including ‘TPK’ and optionally ‘SHP’.

  4. Verify that the base map you downloaded was successfully copied into the correct subfolder. The Download Basemap tool saves all downloaded TPK files into the devices Download folder. This is due to some limitations on file saving on some devices. This requires users to manually copy downloaded files to the correct TPK folder in their desired project folder. Use your devices file manage (e.g., ‘My Files’ on Samsung, ‘Files’ on Google Pixel, etc.) to copy files between folders. For example, if you are working on a project called ‘MyProject’, you will copy the TPK that you download from internal storage/Download → SD Card/MobileMap/MyProject/TPK.

  5. Verify that the correct project has been selected. Use the Select Map Cache tool select the project or map cache where you saved your TPK. See instructions here MobileMap: Basic Operation

  6. Verify that the TPK is enabled for display in display properties. Use the Select Layer Display Properties and verify that the TPK is visible in the list (should be near the bottom or the layers list) and that the checkbox is checked. See instructions here MobileMap: Basic Operation

  7. Verify the extent of the base map you downloaded. MobileMap uses the first loaded map cache to set the maximum map extent. If the first loaded base map (e.g., TPK) is small and not in your area of interest, you will be unable to pan the map to your current extent, thus your new base map will not be visible. MB&G recommends creating a single large area, low resolution base map and storing it in the default folder (e.g., SD Card/MobileMap/default/TPK) which can be used by MobileMap to set a large map extent when it is loading base maps.

  8. Verify the zoom level of the base map you loaded. Base maps downloaded within MobileMap have a maximum scale or zoom level applied to them. See the question Why does my Base Map disappear when I zoom in? for more details on this problem. If you have made it to this step, then it is possible that you are simply too far zoomed in for your base map to display. Try zooming out - way out - and see if your base map shows up. If so, use the approaches described above or in this document MobileMap: Base Map Creation and Reference Data to address this issue.

If you have gone through each of these verification steps and still do not see your map, please reach out to our support team. It will help us resolve the the issue if you can provide screenshots of your folder structure, the Select Map Cache tool, the Select Layer Display Properties tool, etc. It may even be helpful to upload a copy of your TPK file when submitting your support request.