Skip To Content

Configure utility services

As an administrator of your organization, you can configure the website to use different utility services to perform the following tasks: printing, geocoding, and routing. This is a privilege reserved for the administrator role.

Printing

A print service is used to print and preview maps from the Print button in Map Viewer and from print widgets in configurable apps and apps created with Web AppBuilder. 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 Map Viewer Print button to anyone inside or outside your organization who can access your organization's Map Viewer. 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 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. Verify that you are signed in as an administrator of your organization.
  2. Browse to Organization and click Edit Settings > Utility Services.
  3. 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.

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

    Note:

    The print service must be accessible in the same way as the organization. For example, if the organization is accessible through HTTPS only, the print service also must be accessed through HTTPS.

    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 Map Viewer Print button will include a drop-down list of the different print layouts. You can create, edit, or delete templates to have a more customized experience for printing maps in Map Viewer. These changes are saved as a setting in your organization; they are not saved to the print service.

    You can manage the layout templates in the following ways:

    • To create a new layout, click Create Print Template, 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 print experience, delete all your layout templates and click Save. You see Map Only in your template list.
  4. Click Save.
Tip:

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

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. Verify that you are signed in as an administrator of your organization.
  2. Browse to Organization and click Edit Settings > Utility Services.
  3. 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.

  4. 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.

  5. 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.

  6. Check the appropriate boxes if you want to allow geosearch and batch geocoding, and click OK.
  7. Repeat the process to add additional locators.
  8. You can manage the locators in the following ways:
    • To edit an existing locator, click the edit button Edit next to the locator and make your updates. Click OK to save your changes.
    • To delete an existing locator, click the delete button Delete next to the locator.
    • To reorder how the locators appear in the geosearch drop-down menu on the site, click the up or down arrow next to the locator.
  9. Click Save.
Tip:

To reset locators back to the default locator, delete the URL and click Save. When you refresh the page, you see the default URL. 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. 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. Verify that you are signed in as an administrator of your organization.
  2. Browse to Organization and click Edit Settings > Utility Services.
  3. In the Directions and Routing section, enter the URL of your route service, for example, https://gisserver.domain.com/arcgis/rest/services/World/Route/NAServer/Route_World.
  4. To configure travel modes to use with the route service, click Configure travel modes, click Create travel modes, and configure the various travel options. See Travel Modes for complete details on how to configure travel modes.
  5. Click Save.
Tip:

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