Map Areas

Map areas allow field workers to complete tasks while disconnected from the internet. Geocortex Mobile supports two distinct types of map areas:

Once a map area is downloaded to a device, both types of map areas work the same. Users can add and edit data and, when they return online, they can sync their changes back into the web map. Users also have the option of retrieving any changes that have been made to the web map since their map area was downloaded. When packaged, map areas contain all the related records, data and (optionally) attachments within the map area.

For detailed information on how to download, activate, update, send changes, and remove Pre-generated map areas, see Map Areas in the GXM User Help.

For detailed information on how to create a Custom map area using a TPK, see Create a Custom Map Area with a TPK in the GXM User Help.

Use Pre-Generated Map Areas

The following table lists the high-level actions you need to do in each application in order to add a Pre-generated map area in ArcGIS Online or Portal for ArcGIS. Once the Pre-generated map area is displayed in the Map Areas panel in a GXM app, users interact with them in just the same way as Custom map areas.

Pre-generated map areas cannot be copied from one Deployment stage to the next in Geocortex Mobile Designer. When you move a GXM app from Development to Testing, Staging or Production, the map area is dropped.
If you plan to use a Pre-generated map area in a GXM app and you want your users to interact with map areas, you need to add them to the Testing or Staging or Production versions of the GXM app in ArcGIS Online or Portal for ArcGIS.

In this application....

Do these tasks....

ArcGIS Online/Portal for ArcGIS

  1. Create a web map.

  2. Add a feature service.

  3. Enable offline mode.

  4. (Optional: Reference a TPK file.)

Mobile Designer

  1. Add the web map to your GXM app.

  2. Configure all the other settings your app requires.

  3. Push your GXM app through Testing and Staging (optional) to Production.

ArcGIS Online/Portal for ArcGIS

  1. Open the Testing or Staging or Production version of the web map saved in the Geocortex Viewer Files folder. The web map will be displayed as one of the following:
    name of your map (test)

    name of your map (staging)

    name of your map (prod)

  2. Add the map areas to whichever web maps you want your users to access.

Side Load Tile Packages

GXM apps support the use of large high-resolution tile packages (TPK) or vector tile packages (VTPK) while disconnected from the Internet. Users can side load TPKs and VTPK files onto iOS, Android and Windows devices. Tile packages are side-loaded onto mobile devices via iTunes in the case of iOS, or by using the file system in the case of Android or Windows.

Pre-Generated Map Areas and TPKs

If you want your field workers to use Pre-generated map areas with side-loaded tile packages, you must add the name of the TPK as a reference to the web map in ArcGIS Online or Portal for ArcGIS. The TPK is then side loaded onto the device. When the device is offline, and the Pre-generated map area is activated, the GXM app automatically uses the TPK file as its basemap. When the device is again connected to the Internet, the default base map is used.

In GXM apps, you can use the following:

In summary, field workers can use a TPK with map areas created in ArcGIS Online or Portal for ArcGIS 10.7 when:

High-Level Steps to Use a Pre-Defined TPK

  1. In ArcGIS Online or Portal for ArcGIS, ensure that the web map used in your GXM app is set to Enable the layers and map for offline use.

  2. In either ArcGIS Online or Portal for ArcGIS, in the web map, navigate to Settings | Offline | Advanced Options | Use a tile package for the offline basemap.
    Click Device will use a tile package it already has.

    In Package filename, type in the name of the TPK file.

  3. In ArcGIS Online or Portal for ArcGIS, if they do not exist, add the map areas you want to use to the web map at the appropriate stage in the Deployment stages.

    Ensure that the map areas are covered by the TPK you plan to use.
  4. Side load the TPK onto the devices users plan to use, ensuring that the TPK is in the correct folder on the device so that your GXM app can find it.

    When Pre-generated map areas are used, field workers will only see the TPK when they are offline and have activated a map area. While connected to the Internet, they will see the normal basemap.

Custom Map Areas and TPKs

When Pre-generated map areas are not enough, users can also create Custom map areas using a side-loaded TPK in a GXM app while the device is connected to the Internet. When a user defines a Custom map area, they can select any TPKs that has been loaded onto their device, or use the default basemap of the web map. When they download the map area, go offline and activate the map area, the selected TPK or basemap is used for that map area.

The spatial reference (projection) of the TPK must match the spatial reference of the basemap used in the web map.

In summary, users can create a Custom map area in a GXM app that uses a TPK when:

Side Load a Tile Package (TPK) onto Devices

Users side load TPKs onto their devices using the file system in the case of Android and Windows, or iTunes in the case of iOS devices. It is essential that users add the TPK file to the correct folder on each type of device because GXM apps look for TPKs in those specific folders.

Android Devices

Use the file manager on the computer to transfer the TPK to the following equivalent folder on the device:

[Root Path]/Android/data/geocortex.mobile.viewer.custom/files

On Android devices, the first part of this path varies according to the device.

Windows Devices

Use the file system on a computer to transfer the TPK to the following folder on the device:

C:\Users\[username]\AppData\Local\Packages\[GeocortexMobileViewerAppName]\LocalState

Apple iPhone/iPad

To side load a file onto an Apple device:

  1. Open iTunes.

  2. Plug the device into a computer, and then in iTunes click the device icon in the top left corner.

    The panel on the left displays the Settings for the device.

  3. Click File Sharing, and then click one of the following:

  4. From your file system, drag the .TPK file and drop it into the Documents box.

    The status bar at the top of the window indicates that iTunes is copying the TPK file to the device.

    Once the file is copied, it appears in the list of Documents.

    The TPK is now side-loaded to the device.

    In the User help, see also...

    Map Areas

    Create a Custom Map Area with a TPK

     

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.2