Configure utility services

Default administrators and those with the correct privileges can configure the website to use different utility services to perform the following tasks: printing, geocoding, and routing.

  1. Verify that you are signed in as a default administrator 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 on the left side of the page.
  4. Configure any of the following utility services:
Tip:

To reset the configured service back to the default service, delete the URL and click Save. When you refresh the page, you see the default URL.

Printing

A print service is used to print and preview maps from the Print button in Map Viewer (formerly known as Map Viewer Beta) and Map Viewer Classic (formerly known as Map Viewer), and from print widgets in apps created using ArcGIS apps, such as Web AppBuilder and Instant Apps. Apps use the print service in their print widgets to create printable documents with the layouts available in that print service. Print layout templates from the service are accessible through the Print button in Map Viewer and Map Viewer Classic to anyone inside or outside your organization who can access your organization's map viewers. The layouts are based on what's provided in the organization's print service and include any dynamic text placed on the layout. Administrators can create, update, and delete the layout templates for a more customized experience.

Print services from ArcGIS Server 10.1 and later are supported. Asynchronous print services are not supported. If your external print service is secure, you need to first create a secure service item in ArcGIS Online that stores the credentials required to access your print service. You can then configure the service URL provided by the secure service item as a custom print service. The print services can be internal or external. Internal print services only work for printing when Map Viewer, Map Viewer Classic, or apps have access to the internal print service. To print layers secured with web-tier authentication, you must use a custom print service configured to handle web-tier authentication.

  1. In the Printing section, enter the URL of your synchronous print service, for example, https://webadaptorhost.domain.com/webadaptorname/rest/services/Utilities/PrintTools/GPServer/Export%20Web%20Map%20Task and click Save.

    You must specify the Export Web Map Task REST URL of the print service. Asynchronous print services are not supported.

    After validating the REST URL you provided, you will see the initial layout templates provided by your print service (with the option to print the legend if it is available). If your organization has more than one print layout, the Print button in Map Viewer Classic and Map Viewer provide a list of the print layouts. You can create, edit, or delete templates to have a more customized experience for printing maps in Map Viewer and Map Viewer Classic. These changes are saved as a setting in your organization; they are not saved to the print service.

  2. Manage the layout templates in the following ways:
    • To create a new layout, click Create Print Template and enter a name up to 50 characters in length and a description up to 120 characters in length. The characters < and > are filtered out. Choose the format—Image (PNG32) or PDF—and a layout (provided by your print service), and check the box to print the legend if your service includes a legend. Click Create and click Save to save the new layout.
    • To view information about a template, click the information button Information next to the template.
    • To edit an existing template, click the edit button Edit next to the template and make your updates. Click Update to see your changes and click Save.
    • To delete an existing template, click the delete button Delete next to the template.
    • To update the template list to what's currently provided in your print service, click Refresh.
    • If you want the default Map Viewer or Map Viewer Classic print experience, delete all your layout templates and click Save. You see Map Only in your template list.

GeoEnrichment

GeoEnrichment services provide the ability to get facts about a location or area. The content being served by the custom GeoEnrichment service can include ArcGIS Business Analyst Enterprise data or a custom dataset published to a federated server in your ArcGIS Enterprise deployment.

To use a custom GeoEnrichment service that is secured, you must add the service as an item in your organization to store the ArcGIS Enterprise credentials necessary to access the service. GeoEnrichment services from federated ArcGIS Server 10.7 sites and later are supported.

  1. Sign in to your organization as a member of the default administrator role or a custom administrative role that has privileges to create content and administer utility services.
  2. From the My Content tab of the content page, click Add Item and click From a URL.
  3. When the Add an item from the web window appears, select ArcGIS Server web service for Type and specify the URL to your custom GeoEnrichment service. For example, type https://gisserver.domain.com/arcgis/rest/services/World/GeoEnrichmentServer.
  4. A credentials challenge appears. Choose one of the following options:
    • Do not store credentials with service item. Prompt for credentials everytime.—If you choose this option, GeoEnrichment functionality may be limited.
    • Provide your credentials and choose Store credentials with service item. Do not prompt for authentication.—Everyone who uses the GeoEnrichment service will use the account accessed using the credentials you provide.
  5. Type a title.
  6. If your organization has set up content categories, click Assign Category and select up to 20 categories to help people find your item. You can also use the Filter categories box to narrow the list of categories.
  7. Type tags that describe your item. Separate terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags). As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.
  8. Click Add Item.
  9. When the GeoEnrichment service's item page opens, share the item with your organization.
  10. Also on the GeoEnrichment service's item page, select the URL and click Copy.
  11. Click Organization > Settings > Utility services.
  12. Click the edit button under GeoEnrichment and paste the URL.
  13. Click Save.

Geocoding

A locator is used to search for and locate addresses and places on a map. ArcGIS Online is configured to use ArcGIS World Geocoding Service, which allows you to find and map a specified address or place-name (geosearch). For members with the correct privileges, ArcGIS World Geocoding Service can also be used to geocode a large number of addresses at once (batch geocoding), such as when you publish a hosted feature layer with a CSV file that contains addresses.

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 by pointing to an existing locator view in your organization.

Note:
  • If you specify one or more locator views along with ArcGIS World Geocoding Service, users may see 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.
  • Using ArcGIS World Geocoding Service or views of this locator for batch geocoding (including publishing CSV or Excel files as hosted feature layers) consumes credits. Using locators for geosearch does not consume credits.

Learn more about the requirements for configuring your own locators

To add a locator, complete the following steps:

  1. In the Geocoding section, click Add locator and do one of the following:
    • Select From URL and enter the URL to the locator—for example, https://webadaptorhost.domain.com/webadaptorname/rest/services/World/GeocodeServer.
    • Select From Existing Locator and select the locator item you want. Only locators shared with your organization or with the public are available for selection.
      Note:

      Anonymous users will only have access to locator views that are shared with the public. Locator views that are shared with the organization are only accessible to organization members. Anonymous users will not be able to perform geosearch in any apps using locators that are only shared with the organization.

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

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

  3. For Placeholder Text, enter 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.

  4. Check the appropriate boxes if you want to allow geosearch and batch geocoding, and click OK.
  5. Repeat the process to add additional locators.
  6. Manage the locators in the following ways:
    • To edit an existing locator, click the More options button More options next to the locator and click Edit. Make your updates and click Save.
    • To delete an existing locator, click the More options button More options next to the locator and click Delete.
    • To reorder how the locators appear in the geosearch drop-down menu on the site, drag the locator up or down to the correct position.
Tip:

If your organization needs to delete a locator item in the future, you must remove it from the list before deleting the item.

Directions and Routing

A route service is used to get directions in Map Viewer (formerly known as Map Viewer Beta) and Map Viewer Classic (formerly known as Map Viewer). Route services from ArcGIS Server 10.0 and later are supported. Secure internal route services are not supported. Organizations can also configure travel modes to model the mode of transportation used by apps consuming the route service. Travel modes define how a pedestrian, car, truck, or other medium of transportation moves through the streets. A travel mode can be general—for example, to model typical trucks—or more specific, such as to model ladder trucks or rescue trucks.

  1. In the Directions and Routing section, under Route service, enter the URL of your route service, for example, https://gisserver.domain.com/arcgis/rest/services/World/Route/NAServer/Route_World.
  2. To configure travel modes to use with the route service, under Travel modes, click Create travel mode, and configure the various travel options. See Travel modes for complete details on how to configure travel modes.