Layer does not appear

If the layer you want is not displayed, first check to see if it is selected in the layer picker. If the layer is not selected, select it.

If the layer picker indicates that the layer is selected, but it still is not displayed, check the zoom levels and the extent in the GIS configuration. The map in the mobile app must be zoomed to a supported zoom level and within the supported extent.

If the layer that you want is not present in the layer picker, it may be for one of these reasons:

  • The user doesn't have access to the layer. Check the access IDs for the layer in the GIS configuration.
  • The layer is disabled. Ensure that the Disabled attribute is not set to True.

If the layer shows "Failed" in the layer picker, it may be for one of these reasons:

  • The layer's URI in the GIS configuration is invalid.
  • For offline layers, the layer may not have been synced.
  • The layer was not authenticated. The user may have canceled map login, and then chosen the option not to attempt future logins. If necessary, clear authentication data and reload the map. Also ensure that the map server grants access to the layer for the authentication that is used.
  • The layer type is not correct for the type of map at the URL. Check the type attribute and the layerType option in the GIS configuration.
  • A non-public layer is being accessed by a URI that does not use the HTTPS protocol.
  • The layer uses an incorrect spatial reference. Check the log for the correct spatial reference.
  • The layer ID is not specified in the showLayers option.
  • The map server is not functioning.

Finally, check the logs for the precise reason for layer failure. Look for the text “Error Loading map layer.”