Basemap does not appear

If no basemap is displayed, first check to see if a basemap is selected in the layer picker. If no basemap is selected, select one.

If the layer picker indicates that a basemap 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. For offline maps, check the offline levels of detail and the offline extent.

If the basemap appears uniformly light blue, dark blue, or black, zoom out and see if map is centered in the ocean, or beyond 84 degrees latitude. Next, verify that the spatial reference used in the GIS configration is correct. The target spatial reference should be set to 4326. Confirm that Rest Services return valid coordinates for the records.

If the basemap 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 basemap shows "Failed" in the layer picker, it may be for one of these reasons:

• The basemap'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 basemap is being accessed by a URI that does not use the HTTPS protocol.
• 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.”