Configure utility services

Members of the default administrator role and those in custom roles with the appropriate privileges can configure the organization to use services to perform various tasks, including printing, geocoding, geometric calculations, spatial analysis, routing, and more. These are referred to as utility services. To learn more about these services, see Utility services.

The way you configure utility services in your organization depends on the service and where it originates.

Types of utility services

Use the following links for a description of the utility services you can use in your organization. After you decide which utility services you need to use, proceed to the instructions to configure utility services.

• Printing

• Geometry

• Directions and Routing

• GeoEnrichment

• Elevation

• Hydrology

• Geocoding

Printing

A print service is configured with the organization by default. Administrators can stop and start the service or adjust service settings using ArcGIS Enterprise Manager.

Geometry

A geometry service is configured with the organization by default. Administrators can stop and start the service or adjust service settings using ArcGIS Enterprise Manager.

Configure a GeoEnrichment service

You can add ArcGIS GeoEnrichment Service from ArcGIS Online. To use this service, you must provide credentials for an ArcGIS Online account that has credits associated with it.

The ArcGIS Business Analyst web app uses a GeoEnrichment service as a utility service to create sites, reports, infographics, and more. GeoEnrichment service capabilities are provided with ArcGIS Business Analyst Enterprise and can be configured by following the steps below:

1. Verify that you are signed in as a member of the default administrator role or with a custom role with administrative privileges to manage utility services.

2. At the top of the site, click Organization and click the Settings tab.

3. Click Utility services.

4. Scroll to the GeoEnrichment section, click the edit button, and provide the URL for the GeoEnrichment service, for example, https://webadaptor.example.com/arcgis/rest/services/World/GeoEnrichmentServer.

5. Click Save.

Note:

The offline data included with ArcGIS Business Analyst Enterprise supports GeoEnrichment services with data associated with analysis locations in the United States only. An Esri Services engagement is needed for support with international data.

Hydrology

You can add the ArcGIS Online Hydrology service. To use this service, you must provide credentials for an ArcGIS Online organizational account.

Elevation

The organization uses two elevation services: an elevation utility service for analysis and an elevation service used in Scene Viewer.

For analysis, you can add the ArcGIS Online World Elevation services. To use these services, you must provide credentials for an ArcGIS Online account. Alternatively, you can configure a custom elevation utility service.

For Scene Viewer, if the organization is not connected to the internet or you have higher-resolution data you want to use for the Scene Viewer elevation service, you can set a custom elevation service in the organization settings.

Directions and routing

See Routing services to learn more about the types of routing services that can be configured with your organization. For instructions, see Configure routing services.

Geocoding

The ArcGIS World Geocoding Service is configured as a geocoding utility service by default but is not configured for batch geocoding. If needed, you can configure additional geocode services with your organization. The following types are supported:

• A geocode service from a federated or hosting server.

• A geocode service that requires credentials and is from a stand-alone ArcGIS GIS Server site.

• A geocode service that does not require credentials and is from a stand-alone ArcGIS GIS Server site.

• The ArcGIS World Geocoding Service. You must provide credentials for an ArcGIS Online account that has credits associated with it to use this service.

To geocode tables of addresses, configure one of the following as an additional geocode utility service:

• An ArcGIS Server geocode service with the Batch Geocoding operation enabled.

  The URL for a geocode service from an ArcGIS Server is in the format https://webadaptorhost.example.com/webadaptorname/rest/services/folder/servicename/GeocodeServer.

• The ArcGIS World Geocoding Service from ArcGIS Online.

  To configure the ArcGIS World Geocoding Service as a geocode utility service, go to the ArcGIS Online tab and check the Geocode check box under Configure Utility Services. Be aware that the ArcGIS Online credentials you provide must have privileges in ArcGIS Online to geocode and that using this service consumes ArcGIS Online credits.

A locator is used to search for and locate addresses and places on a map. You can specify locators that members of your organization can access. You can add a locator by referencing the URL of your own locator or using an existing locator item in your organization.

Note:

If you specify one or more locator views along with the ArcGIS World Geocoding Service, users may encounter multiple matching suggestions when searching for locations. To ensure an optimal publishing and geosearch experience, configure batch geocoding and geosearch as appropriate when configuring locators for your organization.

Add a locator

To add a locator, complete the following steps:

1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.

2. At the top of the site, click Organization and click the Settings tab.

3. Click Utility services.

4. In the Geocoding section, click Add locator and do one of the following:

   • Select From URL and provide the URL to the locator—for example, https://webadaptorhost.example.com/webadaptorname/rest/services/World/GeocodeServer.

   • Select From Existing Locator and select the locator item. This option does not appear if there is no locator item in your organization's content, and only locators shared with your organization or with the public are available for selection.

5. For Locator Name, provide the name you want to appear on the drop-down menu of locators on the site (for example, in Map Viewer).

   Tip:

   Provide a descriptive name for the locator—for example, Restaurant Locator.

6. For Placeholder Text, provide a hint that will appear in the input box on the site.

   Tip:

   Make the hint as clear as possible—for example, Enter a restaurant name.

7. If you are adding a locator from a URL, configure the number of threads for batch geocoding.

   This number must be less than the number of instances available for the service. To adjust the number of instances for a geocode service, sign in to ArcGIS Server Manager.

   The option to configure the number of threads for batch geocoding is not available for the ArcGIS World Geocoding Service or for locator views.

   For more information about batch geocoding threads, see Configure batch geocoding tools.

8. Optionally, turn on the appropriate toggle buttons to allow geosearch, batch geocoding, and reverse geocoding.

9. Click Save.

10. Repeat the process to add more locators.

11. Manage the locators in the following ways:

    • To edit an existing locator, click the edit button next to the locator, make your updates, and click OK to save your changes.

    • To delete an existing locator, click the delete button next to the locator.

    • To reorder how the locators appear on the geosearch drop-down menu on the site, click the up or down arrow next to the locator.

Tip:

To reset locators to the default locator, delete the URL and click Save. When you refresh the page, the locator reverts to the default URL. Before you can delete a locator item from the organization in the future, you must remove it from the geocoding utility service list.

Configure utility services

How you configure utility services depends on where the service originates. Follow the instructions specific to the origin of the service that you will configure as a utility service for the organization.

• If the service is provided by ArcGIS Online and requires credentials from an ArcGIS Online account, use the ArcGIS Online tab on the Settings page to select the service to be configured, and store the account credentials. See Configure ArcGIS Online utility services for instructions.

• If the service is from a federated server, start the service, share the service, and configure it as a utility service.

• If the service is from a stand-alone server and requires credentials, add the service as an item to the organization, specify credentials to the service, share the service, and configure it as a utility service. Services from secured ArcGIS Server sites are added in this way.

• If the service is from a stand-alone server and does not require credentials, add the URL directly to the Utility services tab of the Settings page.

Note:

If the organization accesses any of the utility services over HTTPS, but the ArcGIS Server site on which the utility service runs uses a certificate that is either self-signed or issued by an internal certifying authority, you must configure the portal to trust that certificate. For instructions, see Import a trust certificate.

Configure a service from a federated server

To configure a service from a federated server, complete the following steps:

1. On the federated ArcGIS Server site, start the services that you want to configure as utility services.

   To do this, sign in to ArcGIS Server Manager for the ArcGIS Server site. Use a member account with administrator privileges. Server Manager is typically available through a URL such as https://gisserver.example.com:6443/arcgis/manager.

   The ArcGIS Server preconfigured print and geometry services are stopped by default.

2. Sign in to the organization as a member of the default administrator role or a custom role with administrative privileges to manage utility services.

3. Locate the service that you need to configure as a utility service and share it.

   How you share a service depends on who needs to use the functionality the service provides. For example, if you want anyone who connects to the organization to access thumbnails and print maps, share the print service with Everyone. If you want to allow organization members to geocode locations, but you don't want anonymous users to do this, share the geocode service with the organization. If you want to restrict the use of analysis tools that require GeoEnrichment to the members of specific groups, share the ArcGIS GeoEnrichment Service with those groups only.

4. Open the item page of the service item and copy the URL at the bottom of the Overview tab.

5. Open the Organization page and click the Settings tab.

6. Click Utility services.

7. Go to the appropriate utility service section and click the edit button.

8. Add the URL and, if necessary, append the task name to the service if it is a print service or route service.

   See the sections on specific utility services above for details.

9. Click Save.

Configure a service that is not from a federated server and requires credentials

1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.

2. Follow the steps to add an item from a URL.

   You must enable the Store credentials with service item option.

   Because this is a secure service, you must provide credentials to access it. Provide a valid username and password to access the service.

3. Once the item is created for the service, share it with those who need to access it.

   How you share a service depends on who needs to use the functionality the service provides. For example, if you want anyone who connects to the organization to access thumbnails and print maps, share the print service with Everyone. If you want organization members to geocode locations, but you don't want anonymous users to do this, share the geocode service with the organization. If you want to restrict the use of analysis tools that require data enrichment to the members of specific groups, share the ArcGIS GeoEnrichment Service with those groups only.

4. Copy the URL at the bottom of the Overview tab on the item page.

5. Open the Organization page and click the Settings tab.

6. Click Utility services.

7. Go to the appropriate utility service section and click the edit button.

8. Add the URL and, if necessary, append the task name to the service if it is a print service or route service.

   See the sections on specific utility services above for details.

9. Click Save.

Configure a service that is not from a federated server and does not require credentials

1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.

2. At the top of the site, click Organization and click the Settings tab.

3. Click Utility services.

4. Go to the appropriate utility service section and click the edit button.

5. Add the URL and, if necessary, append the task name to the service if it is a print service or route service.

   See the sections on specific utility services above for details.

6. Click Save.

7. Repeat these steps as necessary to configure other services as the organization's utility services.

Tip:

To reset the utility services back to their default URLs, delete the URL for each utility service you configured and click Save. When you return to the Utility Services page, the URLs are reset to their defaults.