Administrator configuration

As an administrator, you can configure settings in ArcGIS Online and ArcGIS Enterprise, or through the configuration file, to make ArcGIS Earth meet your organization's requirements. You can go to the ArcGIS Earth Sample Configuration File page and download the sample file. After installation, you can find the configuration file in the application installation directory, which is typically in the C:\Program Files\ArcGIS\ArcGIS Earth\bin folder.

To configure the application settings with a configuration file, keep the following in mind:

  • You can preset configuration parameters and import the modified config.xml file during installation.
  • The configuration file is an .xml file that can be modified as needed. For example, when you edit the file, use & instead of & to specify an escape character. Ensure the configuration file remains encoded as UTF-8 after editing.
  • Configurations preset by the administrator are automatically loaded when a user starts the application for the first time.
  • Users can adopt parameters configured by the administrator in the bin folder by clicking Reset from the application Settings.
  • For a per-user installation of ArcGIS Earth, you can also find and edit the configuration file in the application installation directory, for example, C:\Users\username\AppData\Roaming\ESRI\ArcGISEarth.

Organizational configurations

Some settings in ArcGIS Earth use the organizational configurations of your ArcGIS Online or ArcGIS Enterprise portal account. These settings include the basemap, elevation service, and geocoding service used by ArcGIS Earth. See Set the basemap gallery and default basemap, Configure default elevation service, and Geocoding for details if you connect to ArcGIS Enterprise. See Administer organization for details if you connect to ArcGIS Online.

Configurable application parameters

Administrators can use the configuration file to change settings without recompiling the application. Users can also set policies that affect how ArcGIS Earth runs on their machine. Administrators can access the config.xml file in the installation directory and specify values for corresponding attributes to customize a preferred startup setting by changing configurable parameters.

General application parameters

ParameterDescription

enableCheckForUpdates

Enables checking for ArcGIS Earth updates. The default is False.

workspace

Specifies the directory of the workspace and whether to automatically save the current workspace on exit.

startupView

Allows you to customize (Custom) the startup view or start where you left off (History).

spatialReference

Sets the spatial reference used by ArcGIS Earth as Web Mercator or WGS84. The default is Web Mercator.

Note:
  • ArcGIS Earth has been using the default GDAL projection engine, which is typically in the application installation directory C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\pedata folder.
  • The projection engine data extension downloadable pack can be found through ArcGIS Developer Projection Engine Data.
  • Extract the downloaded content to the ArcGIS Earth projection engine directory and restart ArcGIS Earth, thus the proper projection engine will be used. If you encounter a duplicate file warning, skip or replace are both good to proceed.
  • The projection engine data won't be available if ArcGIS Earth is installed directly from the Microsoft Store.

isShowInExternalBrowser

Displays HTML links in the pop-up window with an external browser. The default is False.

isShowStartupTips

Displays startup tips when starting the application. The default is True.

Tip:

Administrators can customize the contents of startup tips by updating the HTML files in the tips folder from the application installation directory.

language

Sets the display language for ArcGIS Earth user interface text. The default value is System.

If the value is System, ArcGIS Earth will match the Windows display language setting.

flyto

Sets the fly-to speed between 0 and 100; the default speed is 50.

Enables automatically zooms to a new layer. The default is True.

Sets zoom to layer angle between Default and None. The default is Default.

mouseWheel

Sets the mouse wheel speed between 0 and 100 and wheel zoom direction to forward or backward. The default is Forward.

navigatorMode

Sets the operating mode of the on-screen navigator between Default, Expanded, and Collapsed. The default is Default.

continuousPanning

Turns continuous panning on (True) or off (False). The default is True.

nonMouseController

Enables navigating ArcGIS Earth with a nonmouse controller.

atmosphere

Switch the atmosphere between None, Horizon Only, and Realistic. The default is Horizon Only.

elevationExaggeration

Sets the elevation exaggeration value for terrain. The default value is 1.

elevationExaggerationMax

Set the maximum allowable value of elevation exaggeration. The default is 100. A value over 1000 will be limited to 1000.

Note:

The maximum value of elevation exaggeration will be updated in the user interface once a new elevationExaggerationMax value is applied.

undergroundNavigation

Set to enable underground data navigation and transparency configuration of the ground. The default is Off.

location

Specifies the default location unit. The default is DMS.

distance

Specifies the default distance unit. The default is Meters.

area

Specifies the default area unit. The default is SquareMeters.

isLongitudeFront

Flips latitude-longitude order of coordinates on search and display. The default is True.

proxy

Sets to use proxy (Boolean; optional). The default is False.

address

Specifies the address for the proxy server.

username

Specifies the username for the proxy server.

password

Specifies the password for the proxy server.

Administrator application parameters

ParameterDescription

isDefaultKmlViewer

Sets ArcGIS Earth as the default KML viewer. The default is False.

isDefaultMspkViewer

Sets ArcGIS Earth as the default mobile scene layer package viewer. The default is True.

enableHtmlWindow

Enables the HTML window. The default is False.

enableTableDataExport

Enable feature layer data to be exported as kmz data in the Attribute table. The default is True.

blockArcGISOnline

Blocks request and portal connections to ArcGIS Online when starting ArcGIS Earth. The default is False.

findInTOC

Enables the switch to control whether selected KML on the scene will be highlighted in the Table of Contents automatically.

portals

Sets the portal URLs to where ArcGIS Earth will connect.

Tip:

If the administrator lists multiple portal URLs in the configuration file, ArcGIS Earth will use the first portal as the active portal after installation.

disableAddPortal

Blocks users from adding new portal or online connections in Portal Manager. The default is False.

Tip:
  • If it's set as True, the Add Portal button in the Portal Manager panel will be unavailable​, and the user cannot add new portal/online connection through Portal Manager​. The user can switch portal connections among preconfiguration portals showing in Portal Manager.

popup

Sets the pop-up resize mode and pop-up size. The default of size fixed is True, and the default values of width and height are 300 and 420. Switch the value of size fixed to False to enable pop-up resize mode.

Note:

The minimum values of pop-up width and height are 300 px and 420 px. The maximum value of the pop-up size cannot be larger than the window's size of ArcGIS Earth.

fonts

Specifies the font for labels of the drawing element.

Note:

Use the font name inside the font file as the element value, and be sure the specified font file is installed on your operating system.

log

Records log information in the ESRI\ArcGISEarth\logs folder from a user's AppData directory, for example, C:\Users\username\AppData\Roaming.

The maximum value of each log size is 10,000, and the maximum number of log files to be stored is 1,000.

startupLayers

Sets up startup layers in the table of contents and configures the name, URL, type, and visibility, and organizes startup layers into hierarchical groups.

Tip:
  • Startup layers support data types including ArcGIS services, KML/KMZ, WMS and its sublayers, WFS and its sublayers, GeoJSON, shapefile, raster, tile package, scene layer package, mobile scene package, web scene, and web map.
  • The warning icon indicates the path is missing, or data is broken or not accessible.
  • Startup layers with invisible states will not start loading until they are turned on in the table of contents.

organizationalBasemaps

Sets the basemaps for your organization.

Tip:

Organizational basemap layers support data types including KML/KMZ, WMS, raster, tile package, scene layer package, and ArcGIS services.

organizationalTerrains

Sets up terrains for your organization.

Tip:

Organizational terrain layers support data types including local raster and elevation image service. See Basemap and terrain for more information.

positionServiceUrl

Allows an administrator to enter a URL with some encoded values, which will be recognized by ArcGIS Earth and filled with location information. When using Ctrl+right-click on the globe, the URL will be invoked and the latitude, longitude, and elevation of the point clicked will be passed to that URL. As long as the URL returns a valid .kml file, the .kml file will be displayed in the viewport.

Read an example from the ArcGIS Blog: Point Based Service access with ArcGIS Earth.

  • urlwithpos—Sets up the key attribute on the add element under the ServiceURL element to enable this feature.
  • urlwithoutpos—Sets up information that ArcGIS Earth will read. The information is a .kml file returned from the service call without storing it on disk.

localKmlIcons

Enables access to the native KML Icons folder, or points to a customized icon folder.

Tip:
  • If it's set as False, ArcGIS Earth will use KML icons from google.com.
  • If it's True, ArcGIS Earth will use local KML icons.
    • If the value for directory is left empty, ArcGIS Earth will use local KML icons from the \resources\symbols\kml folder in the installation directory, typically C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\.
    • If you need to point to a customized KML icon folder—for example, the customized KML icons are located in the C:\myIcons\kml folder—the value for directory should be set as C:\myIcons to include the kml folder.

directoryStyleLink

Enables the URL address to Esri's dictionary style files, or customizes the URL and displays text on the user interface. By default, the hyperlink URL is disabled.

Tip:

For users behind the firewall, an administrator can download the dictionary files from Esri Styles and save to a shared directory, enable the hyperlink, and update the URL address to the local directory for users to access inside your organization.

acknowledgement

Specifies the display text and URL address for acknowledgments.

help

Specifies the display text and URL address for help.

submitFeedback

Specifies the display text and URL address for submitting feedback.

bannerSettings

Specifies the display text, text style, font style, and alignment of the banner.

automationAPI

Specifies the Automation API setting in ArcGIS Earth.

  • autoStart—Enable ArcGIS Earth Automation API when ArcGIS Earth starts. The default is False.

Note:
  • The format of the configuration file is updated starting from 1.10. The previous version of config.xml is forward compatible; however, it is no longer maintained or updated with product releases.
  • Once user parameters are modified through the ArcGIS Earth Settings user interface, the app will be reading these parameters from the configuration file in C:\Users\<username>\AppData\Roaming\Esri\ArcGISEarth. While the admin parameters are still stored in the installation directory or a specific one set through the configuration manager under Advanced settings, the app will be reading admin parameters from these locations.