Map Areas

Map areas allow field workers to complete tasks while offline. 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...

Do...

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. Deploy 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.

Sideload Tile Packages

GXM apps support the use of large high-resolution tile packages (TPK and TPKX) or vector tile packages (VTPK) while offline. Users can sideload TPK, TPKX and VTPK files onto iOS, Android and Windows devices. Tile packages are sideloaded 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 sideloaded 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 sideloaded 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 reconnected online, 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. Sideload 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 online, 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 sideloaded TPK in a GXM app while the device is offline. 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:

Sideload a Tile Package (TPK) onto Devices

Users sideload TPKs onto their devices using the file system in the case of Windows and Android, 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.

Windows Devices

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

%userprofile%\AppData\Local\Packages\[GeocortexMobileViewerAppName]\LocalState

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.

iOS Devices

To sideload a file onto an iOS 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:

    • For Geocortex Go, click Geocortex Go in the Apps box.

      A list of the Geocortex Go Documents displays in the right-hand box.

    • For Custom apps, click the [app name] in the Apps box.

      A list documents for your custom app displays.

  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 sideloaded onto the device.

    In the User help, see also...

    Map Areas

    Create a Custom Map Area with a TPK